packServer/backend/app/lib/agreement.js
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

55 lines
1.7 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';
/**
* 协议同意校验(纯函数,不依赖 Sequelize,方便单测)
*/
/** 客户端提交的 `agreements` → Map(code → versionId);非法项直接忽略 */
function normalizeAccepted(list) {
const map = new Map();
if (!Array.isArray(list)) return map;
for (const item of list) {
if (!item || typeof item !== 'object') continue;
const code = String(item.code || '').trim();
const versionId = Number(item.versionId === undefined ? item.version_id : item.versionId);
if (!code || !Number.isInteger(versionId) || versionId <= 0) continue;
map.set(code, versionId);
}
return map;
}
/**
* 校验客户端同意的是不是「当前生效版本」
*
* @param {Array} required 当前必须同意的协议(service.agreement.listCurrent 的输出)
* @param {Array} accepted 客户端提交的 `[{ code, versionId }]`
* @return {{ok:boolean, missing:Array, accepted:Array}} accepted 里是可直接落库的条目
*/
function verifyAcceptance(required, accepted) {
const list = Array.isArray(required) ? required : [];
const submitted = normalizeAccepted(accepted);
const missing = [];
const matched = [];
for (const item of list) {
if (!item || !item.version || !item.version.id) continue;
const versionId = Number(item.version.id);
if (submitted.get(item.code) !== versionId) {
missing.push({ code: item.code, name: item.name, versionId });
continue;
}
matched.push({
agreementId: Number(item.id),
code: item.code,
name: item.name,
versionId,
version: item.version.version,
});
}
return { ok: missing.length === 0, missing, accepted: matched };
}
module.exports = { normalizeAccepted, verifyAcceptance };