- 主体状态缓存(Redis 优先、进程内兜底):设备心跳与上报判断不再查库,续期/停用后主动失效 - 上报写接口按缓存校验期限:过期 403 subject_expired、停用 subject_disabled、主体缺失 subject_missing - 心跳与 /api/scanner/me 返回 subject 状态,桌面端据此暂停推送并在续期后自动补传积压 - 新增续期订单(subject_orders)与接口,支付回调 POST /api/pay/notify 幂等、支持 HMAC 签名, 另提供内部令牌模拟支付用于联调 - 顺带提交工作区中已完成的「登录协议」后端改动(agreement):与本次改动共用 router.js / config.default.js Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
70 lines
2.2 KiB
JavaScript
70 lines
2.2 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
|
||
/**
|
||
* 设备自检 / 保活(**需设备长期 JWT**)
|
||
*
|
||
* 鉴权:`middleware.scannerAuth()` —— `Authorization: Bearer <device JWT>`(也认 `X-Scanner-Token` /
|
||
* `?access_token=`);令牌自带 `typ: 'scanner'`,用户令牌(`typ: 'user'`)用不了。
|
||
* 令牌来源:`GET /api/device/login`(扫码登录,见 `app/controller/device/auth.js`)。
|
||
*/
|
||
class DeviceSelfController extends Controller {
|
||
/**
|
||
* GET /api/scanner/me —— 当前设备信息
|
||
* 需要长期 JWT(Authorization: Bearer <token>,见 app/middleware/scanner_auth.js)
|
||
*/
|
||
async me() {
|
||
const { ctx } = this;
|
||
const data = await ctx.service.scanner.findById(ctx.state.scanner.id);
|
||
const subject = await subjectStateOf(ctx, ctx.state.scanner);
|
||
ctx.body = { ok: true, data: Object.assign({}, data, { subject }) };
|
||
}
|
||
|
||
/**
|
||
* POST /api/scanner/heartbeat —— 设备心跳(需 JWT)
|
||
* 用于设备与服务之间的连通性保活,同时刷新 IP 与心跳时间。
|
||
*
|
||
* **不因主体过期返回 403**:设备靠这个接口探测「是否已续期」,
|
||
* 返回的 `subject.expired` 才是上报循环暂停/恢复的依据(状态读缓存,不额外查库)。
|
||
*/
|
||
async heartbeat() {
|
||
const { ctx } = this;
|
||
const data = await ctx.service.scanner.heartbeat(ctx.state.scanner, ctx.ip);
|
||
const subject = await subjectStateOf(ctx, ctx.state.scanner);
|
||
ctx.body = {
|
||
ok: true,
|
||
data: {
|
||
sn: data.sn,
|
||
lastSeenAt: data.lastSeenAt,
|
||
serverTime: new Date().toISOString(),
|
||
subject,
|
||
},
|
||
};
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 设备所属主体的状态(从 `service.subjectState` 缓存读,不查数据库)
|
||
* 没挂主体的历史设备返回 null。
|
||
*/
|
||
async function subjectStateOf(ctx, scanner) {
|
||
const subjectId = scanner && Number(scanner.subjectId);
|
||
if (!subjectId) return null;
|
||
|
||
const state = await ctx.service.subjectState.get(subjectId);
|
||
if (!state) return null;
|
||
|
||
return {
|
||
id: state.id,
|
||
name: state.name,
|
||
status: state.status,
|
||
expireAt: state.expireAt,
|
||
expired: state.expired,
|
||
disabled: state.disabled,
|
||
remainingSeconds: state.remainingSeconds,
|
||
};
|
||
}
|
||
|
||
module.exports = DeviceSelfController;
|