liufumingren bd2363bf00 chore: 初始化仓库(backend / frontend / extension 三块)
- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权;
  已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF),
  开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。
  单测 91 个通过(不需要本机数据库)。
- frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 /
  首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。
- extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。
- 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、
  .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
2026-10-17 08:50:32 +08:00

136 lines
4.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { Service } = require('egg');
const jwt = require('jsonwebtoken');
/** 时长单位换算(秒):用于把 '30d' 这类写法解析成秒数,做上限校验 */
const DURATION_UNITS = { s: 1, m: 60, h: 3600, d: 86400, w: 604800, y: 31536000 };
/**
* JWT 服务:签发 / 校验令牌
*
* - **扫描器长期令牌**(typ=scanner,默认 1 年,见 config.jwt.scannerExpiresIn),
* 撤销靠库里存当前 jti + 扫描器 status 比对(见 app/middleware/scanner_auth.js):
* 重新注册/登录会换新 jti,旧令牌立即失效;status=0 或删除扫描器,令牌立即失效。
* - **用户令牌**(typ=user,默认 7 天,见 config.jwt.userExpiresIn):给前端(SPA / 小程序 / 扫码登录)
* 用,接口带 `Authorization: Bearer <token>` 即可,见 app/middleware/auth.js。
*/
class JwtService extends Service {
get secret() {
return this.config.jwt.secret;
}
/**
* 时长解析:`'30d'` / `'12h'` / `'90m'` / `'30s'` / `'2w'` / `'1y'` 或纯数字(秒)
* @param {string|number} value 时长
* @return {number} 秒数;解析不了返回 0
*/
parseDuration(value) {
if (value === undefined || value === null || value === '') return 0;
const text = String(value).trim();
if (/^\d+$/.test(text)) return Number(text);
const matched = /^(\d+)\s*([smhdwy])$/.exec(text.toLowerCase());
if (!matched) return 0;
return Number(matched[1]) * (DURATION_UNITS[matched[2]] || 0);
}
/**
* 签发用户令牌
* @param {object} user 至少含 id(可带 username)
* @return {string} JWT
*/
signUser(user) {
const payload = {
sub: String(user.id),
username: user.username || null,
typ: 'user',
};
return jwt.sign(payload, this.secret, {
algorithm: 'HS256',
expiresIn: this.config.jwt.userExpiresIn,
issuer: this.config.jwt.issuer,
audience: this.config.jwt.audience,
});
}
/**
* 校验用户令牌,失败返回 null(不抛错,调用方自己决定怎么响应)
* @return {object|null} payload(含 sub / typ / exp)
*/
verifyUser(token) {
try {
const payload = jwt.verify(token, this.secret, {
algorithms: [ 'HS256' ],
issuer: this.config.jwt.issuer,
audience: this.config.jwt.audience,
});
return payload && payload.typ === 'user' ? payload : null;
} catch (err) {
this.ctx.logger.warn('[jwt] 用户令牌校验失败(%s): %s', err.name, err.message);
return null;
}
}
/**
* 签发扫描器长期令牌
* @param {object} scanner 至少含 id、sn
* @param {object} extra 额外声明(如 jti)
* @param {object} options { expiresIn 覆盖有效期(秒数或 '30d' 这种写法,不传用 config.jwt.scannerExpiresIn) }
* @return {string} JWT
*/
signScanner(scanner, extra = {}, options = {}) {
const payload = Object.assign({
sub: String(scanner.id),
sn: scanner.sn,
typ: 'scanner',
}, extra);
return jwt.sign(payload, this.secret, {
algorithm: 'HS256',
expiresIn: options.expiresIn || this.config.jwt.scannerExpiresIn,
issuer: this.config.jwt.issuer,
audience: this.config.jwt.audience,
});
}
/**
* 校验扫描器令牌,失败直接抛 401
*
* ⚠️ 必须检查 `typ`:用户令牌与设备令牌用的是同一把密钥、同一对 issuer/audience,
* 不比对 `typ` 的话**用户令牌就能当设备令牌用**(用户 id 与设备 id 撞上号就出事)。
* @return {object} payload(含 sub / sn / jti / exp)
*/
verifyScanner(token) {
let payload;
try {
payload = jwt.verify(token, this.secret, {
algorithms: [ 'HS256' ],
issuer: this.config.jwt.issuer,
audience: this.config.jwt.audience,
});
} catch (err) {
const message = err.name === 'TokenExpiredError'
? '扫描器令牌已过期,请重新注册/登录'
: '扫描器令牌无效';
this.ctx.logger.warn('[jwt] 校验失败(%s): %s', err.name, err.message);
this.ctx.throw(401, message);
return null;
}
if (!payload || payload.typ !== 'scanner') {
this.ctx.logger.warn('[jwt] 拿到的不是设备令牌: typ=%s', payload && payload.typ);
this.ctx.throw(401, '不是设备令牌(设备接口只认 typ=scanner 的长期 JWT)');
}
return payload;
}
/** 取令牌的过期时间(存库/展示用) */
expiresAtOf(token) {
const decoded = jwt.decode(token);
return decoded && decoded.exp ? new Date(decoded.exp * 1000) : null;
}
}
module.exports = JwtService;