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

112 lines
4.1 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 { Controller } = require('egg');
/**
* web 用户端:**测试页**用的模拟接口(`/api/web/test/*`)
*
* 前端「测试页」把真机链路拆开跑,方便没有实物设备时联调:
* - `POST /api/web/test/device-login`:模拟「设备发码 → 有人扫码确认」这一步。
* 请求方(已登录用户)就是**确认人**,等价于手机上点了确认 —— 会真的建/认领设备记录并**换发长期 JWT**。
* - `POST /api/web/test/scan`:模拟「中控上报」(拿 SN + 长期 JWT 调,等价于设备的 `/api/scan/*`)。
*
* 两者都不绕开校验:设备令牌仍按 `service.scanner.resolveByToken()` 完整验签 + 比对 jti。
*/
class WebTestController extends Controller {
/**
* POST /api/web/test/device-login
* body: `{ sn?, name?, vendor?, model?, firmware?, expiresIn? }`
* → `{ ...设备信息, token, tokenType, firstTime }`
*/
async deviceLogin() {
const { ctx } = this;
const body = ctx.request.body || {};
const expiresIn = this.resolveDuration(body.expiresIn);
const created = await ctx.service.scanner.loginByScan({
sn: body.sn,
name: body.name,
vendor: body.vendor,
model: body.model,
firmware: body.firmware,
ip: ctx.ip,
userId: ctx.state.user.id,
expiresIn,
});
// 再查一次,拿到带绑定用户信息的完整数据
const detail = await ctx.service.scanner.findById(created.id);
ctx.logger.info('[web-test] 模拟设备扫码登录: %s(确认人 %s)', created.sn, ctx.state.user.id);
ctx.body = {
ok: true,
data: Object.assign({}, detail, {
token: created.token,
tokenType: created.tokenType,
firstTime: created.firstTime,
}),
};
}
/**
* 令牌时长(可选):只能申请比 `config.jwt.deviceExpiresIn` 更短的,超上限 422
* @return {number|undefined} 秒数;没传返回 undefined(用默认值)
*/
resolveDuration(raw) {
const { ctx } = this;
const value = String(raw || '').trim();
if (!value) return undefined;
const { jwt } = ctx.app.config;
const maxSpec = String(jwt.deviceExpiresIn || jwt.scannerExpiresIn || '365d');
const max = ctx.service.jwt.parseDuration(maxSpec);
const seconds = ctx.service.jwt.parseDuration(value);
if (!seconds) ctx.throw(422, 'expiresIn 格式不对(支持 30d / 12h / 90m / 3600 这类写法)');
if (max && seconds > max) ctx.throw(422, `expiresIn 不能超过服务端上限 ${maxSpec}`);
return seconds;
}
/**
* POST /api/web/test/scan
* body: `{ sn, token, channelId, channelName?, barcode, scanTime? }`
* → `{ inserted, duplicated, ... }`(与设备上报同结构)
*/
async scan() {
const { ctx } = this;
const body = ctx.request.body || {};
const sn = String(body.sn || '').trim();
const token = String(body.token || '').trim();
const channelId = String(body.channelId || '').trim();
const channelName = String(body.channelName || '').trim();
const barcode = String(body.barcode || '').trim();
const scanTime = String(body.scanTime || '').trim();
if (!sn || !token) ctx.throw(422, '设备 SN 与长期 JWT 都不能为空');
if (!channelId) ctx.throw(422, '通道 id 不能为空');
if (!barcode) ctx.throw(422, '条码不能为空');
// 与设备上报走**同一套**校验(验签 + 回查 + jti 比对)
const scanner = await ctx.service.scanner.resolveByToken(token, { sn });
await ctx.service.scanner.heartbeat(scanner, ctx.ip);
const channelResult = await ctx.service.scan.reportChannels(scanner, [{ channelId, channelName }]);
const scanResult = await ctx.service.scan.ingest(scanner, [{
channelId,
barcode,
scanTime: scanTime || new Date(),
}]);
ctx.logger.info('[web-test] 模拟上报完成: %s 通道=%s 条码=%s', sn, channelId, barcode);
ctx.body = {
ok: true,
data: Object.assign({ sn, channelId, channelName, barcode }, scanResult, {
channelCreated: channelResult.created,
channelUpdated: channelResult.updated,
}),
};
}
}
module.exports = WebTestController;