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

260 lines
8.5 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 { app, mock, assert } = require('egg-mock/bootstrap');
const jwt = require('jsonwebtoken');
const createFakeRedis = require('../../utils/fake-redis');
const { HEADER: INTERNAL } = require('../../utils/internal');
/** 管理侧接口(绑定/列表/删除)要运维令牌;设备侧接口多带这个 header 也无副作用 */
const http = {
get: url => app.httpRequest().get(url).set(INTERNAL),
post: url => app.httpRequest().post(url).set(INTERNAL),
put: url => app.httpRequest().put(url).set(INTERNAL),
delete: url => app.httpRequest().delete(url).set(INTERNAL),
};
const instance = (data) => Object.assign(
{
toJSON: () => data,
update: async (fields) => Object.assign(data, fields),
},
data,
);
/** 假实例:update 时额外回调(用于断言写入的字段) */
const inst = (data, onUpdate) => Object.assign(
{
toJSON: () => data,
update: async fields => {
if (onUpdate) onUpdate(fields);
Object.assign(data, fields);
return data;
},
},
data,
);
/** 用与服务端一致的密钥/签发者造一个扫描器 JWT */
function signScannerToken(payload = {}, options = {}) {
return jwt.sign(
Object.assign({ sub: '1', sn: 'SN-001', typ: 'scanner', jti: 'jti-1' }, payload),
app.config.jwt.secret,
Object.assign({
algorithm: 'HS256',
expiresIn: '365d',
issuer: app.config.jwt.issuer,
audience: app.config.jwt.audience,
}, options),
);
}
describe('test/app/controller/scanner.test.js', () => {
beforeEach(() => {
mock(app, 'redis', createFakeRedis().client);
});
it('老的 sn + secret 注册/登录入口已下线(设备统一走扫码登录 GET /api/device/login)', async () => {
mock(app, 'model', { User: {}, Scanner: {} });
const reg = await http.post('/api/scanner/register').send({ sn: 'SN-001' }).expect(404);
const login = await http.post('/api/scanner/login').send({ sn: 'SN-001', secret: 'x' }).expect(404);
// 接口的 404 也要是 JSON(不然客户端按 JSON 解析会报错)
assert(reg.body.ok === false && reg.body.message === '接口不存在', JSON.stringify(reg.body));
assert(login.body.ok === false, JSON.stringify(login.body));
});
it('GET /api/scanner/me 必须带 JWT:无令牌 401 / 带令牌 200', async () => {
await http.get('/api/scanner/me').expect(401);
mock(app, 'model', {
User: {},
Scanner: {
async findByPk(id) {
// 鉴权阶段用 payload.sub(字符串),控制器里又按主键(数字)取一次
assert(String(id) === '1');
return instance({ id: 1, sn: 'SN-001', status: 1, tokenJti: 'jti-1' });
},
},
});
const res = await http
.get('/api/scanner/me')
.set('Authorization', `Bearer ${signScannerToken()}`)
.expect(200);
assert(res.body.data.sn === 'SN-001');
assert(res.body.data.secretHash === undefined && res.body.data.tokenJti === undefined, '不应回传密钥/jti');
});
it('GET /api/scanner/me JWT 失效的各种情况', async () => {
const baseModel = {
User: {},
Scanner: {
async findByPk() {
return instance({ id: 1, sn: 'SN-001', status: 1, tokenJti: 'jti-1' });
},
},
};
// 签名不对
mock(app, 'model', baseModel);
const badSign = jwt.sign({ sub: '1', sn: 'SN-001', jti: 'jti-1' }, 'wrong-secret', {
issuer: app.config.jwt.issuer, audience: app.config.jwt.audience,
});
await http.get('/api/scanner/me').set('Authorization', `Bearer ${badSign}`).expect(401);
// 已过期
const expired = signScannerToken({}, { expiresIn: '-1s' });
await http.get('/api/scanner/me').set('Authorization', `Bearer ${expired}`).expect(401);
// jti 已被轮换
const stale = signScannerToken({ jti: 'old-jti' });
const staleRes = await http.get('/api/scanner/me').set('Authorization', `Bearer ${stale}`).expect(401);
assert(staleRes.body.message.includes('已失效'));
// 扫描器被禁用
mock(app, 'model', {
User: {},
Scanner: { async findByPk() { return instance({ id: 1, sn: 'SN-001', status: 0, tokenJti: 'jti-1' }); } },
});
await http.get('/api/scanner/me').set('Authorization', `Bearer ${signScannerToken()}`).expect(403);
// 扫描器已删除
mock(app, 'model', { User: {}, Scanner: { async findByPk() { return null; } } });
await http.get('/api/scanner/me').set('Authorization', `Bearer ${signScannerToken()}`).expect(401);
});
it('POST /api/scanner/heartbeat 用 JWT 保活并刷新心跳时间', async () => {
let updated = null;
mock(app, 'model', {
User: {},
Scanner: {
async findByPk() {
return inst({ id: 1, sn: 'SN-001', status: 1, tokenJti: 'jti-1' }, fields => {
updated = fields;
});
},
},
});
const res = await http
.post('/api/scanner/heartbeat')
.set('Authorization', `Bearer ${signScannerToken()}`)
.expect(200);
assert(res.body.data.sn === 'SN-001');
assert(typeof res.body.data.serverTime === 'string');
assert(updated.lastSeenAt instanceof Date, '应刷新最近心跳时间');
});
it('POST /api/scanner/bind 支持 sn + username 绑定', async () => {
let updated = null;
mock(app, 'model', {
User: {
async findOne() {
return instance({ id: 7, username: 'admin' });
},
},
Scanner: {
async findOne() {
return inst({ id: 1, sn: 'SN-001' }, fields => {
updated = fields;
});
},
},
});
await http
.post('/api/scanner/bind')
.send({ sn: 'SN-001', username: 'admin' })
.expect(200);
assert(updated.userId === 7);
});
it('POST /api/scanner/bind 扫描器不存在 → 404,用户不存在 → 404', async () => {
mock(app, 'model', {
User: { async findOne() { return null; } },
Scanner: { async findOne() { return null; } },
});
await http.post('/api/scanner/bind').send({ sn: 'X', username: 'nobody' }).expect(404);
mock(app, 'model', {
User: { async findOne() { return null; } },
Scanner: { async findOne() { return instance({ id: 1, sn: 'SN-001' }); } },
});
const res = await http.post('/api/scanner/bind').send({ sn: 'SN-001', username: 'nobody' }).expect(404);
assert(res.body.message.includes('用户不存在'));
});
it('POST /api/scanner/unbind 解绑(清掉归属,保留扫描器)', async () => {
let updated = null;
mock(app, 'model', {
User: {},
Scanner: {
async findOne() {
return inst({ id: 1, sn: 'SN-001', userId: 7 }, fields => {
updated = fields;
});
},
},
});
await http.post('/api/scanner/unbind').send({ sn: 'SN-001' }).expect(200);
assert(updated.userId === null);
});
it('GET /api/scanners 分页列表(带绑定账号、不含密钥与 jti)', async () => {
mock(app, 'model', {
User: { name: 'User' },
Scanner: {
async findAndCountAll(options) {
assert(options.limit === 5);
assert(options.offset === 5);
assert.deepStrictEqual(options.order, [[ 'id', 'DESC' ]]);
return {
rows: [ instance({ id: 1, sn: 'SN-001', name: '扫描枪', user: { id: 1, nickname: '管理员' } }) ],
count: 1,
};
},
},
});
const res = await http.get('/api/scanners?page=2&pageSize=5').expect(200);
assert(res.body.data.total === 1);
assert(res.body.data.page === 2);
assert(res.body.data.list[0].sn === 'SN-001');
assert(res.body.data.list[0].user.nickname === '管理员');
assert(!JSON.stringify(res.body.data).includes('tokenJti'));
});
it('GET /api/scanners/:id 详情 / 不存在 404 / id 非法 400', async () => {
mock(app, 'model', {
User: {},
Scanner: {
async findByPk() {
return instance({ id: 1, sn: 'SN-001' });
},
},
});
await http.get('/api/scanners/1').expect(200);
mock(app, 'model', { User: {}, Scanner: { async findByPk() { return null; } } });
await http.get('/api/scanners/1').expect(404);
await http.get('/api/scanners/abc').expect(400);
});
it('DELETE /api/scanners/:id 软删除扫描器', async () => {
mock(app, 'model', {
User: {},
Scanner: {
async destroy(options) {
assert.deepStrictEqual(options.where, { id: 1 });
return 1;
},
},
});
await http.delete('/api/scanners/1').expect(200);
});
});