liufumingren 7b11f7052d feat(subject): 主体到期暂停设备上报,新增续期订单与支付回调
- 主体状态缓存(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>
2026-10-20 18:55:57 +08:00

70 lines
2.2 KiB
JavaScript
Raw Permalink 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');
/**
* 设备自检 / 保活(**需设备长期 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;