packServer/backend/app/service/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

115 lines
3.3 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 { Service } = require('egg');
const { verifyAcceptance } = require('../lib/agreement');
/**
* 协议服务
*
* - `listCurrent()`:所有启用协议 + 当前已发布版本(公开接口下发)
* - `requiredVersions()`:其中「登录必须同意」的协议
* - `verifyAcceptance()`:校验客户端提交的版本是不是当前版本(纯函数,见 app/lib/agreement.js)
* - `record()`:把同意记录落库(同一用户 + 同一版本只更新时间)
*/
class AgreementService extends Service {
get Agreement() {
return this.app.model.Agreement;
}
get AgreementVersion() {
return this.app.model.AgreementVersion;
}
get UserAgreement() {
return this.app.model.UserAgreement;
}
/** 启用中、且有已发布当前版本的协议 */
async listCurrent() {
const rows = await this.Agreement.findAll({
where: { status: 1 },
include: [{
model: this.AgreementVersion,
as: 'currentVersion',
required: true,
where: { status: 1 },
}],
order: [[ 'sortNo', 'ASC' ], [ 'id', 'ASC' ]],
});
return rows.map(row => this.toPublic(row.toJSON()));
}
/** 登录必须同意的协议(没有配置时返回空数组 → 登录不受影响) */
async requiredVersions() {
const list = await this.listCurrent();
return list.filter(item => item.required && item.version);
}
verifyAcceptance(required, accepted) {
return verifyAcceptance(required, accepted);
}
/** 落库:返回本次记录(客户端可用于回显已同意的版本) */
async record(userId, accepted, meta = {}) {
const now = new Date();
const source = String(meta.source || '').slice(0, 32) || null;
const ip = String(meta.ip || '').slice(0, 64) || null;
const userAgent = String(meta.userAgent || '').slice(0, 255) || null;
const recorded = [];
for (const item of accepted) {
const [ row, created ] = await this.UserAgreement.findOrCreate({
where: {
userId,
agreementId: item.agreementId,
versionId: item.versionId,
},
defaults: {
version: item.version,
source,
ip,
userAgent,
agreedAt: now,
},
});
if (!created) {
await row.update({ version: item.version, source, ip, userAgent, agreedAt: now });
}
recorded.push({
code: item.code,
versionId: item.versionId,
version: item.version,
agreedAt: (created ? now : row.agreedAt) || now,
});
}
return recorded;
}
/** 模型 → 公开结构(不要把 status / 内部字段都丢给客户端) */
toPublic(row) {
const version = row.currentVersion;
if (!version) return null;
return {
id: Number(row.id),
code: row.code,
name: row.name,
description: row.description || '',
required: Number(row.required) === 1,
sortNo: Number(row.sortNo || 0),
version: {
id: Number(version.id),
version: version.version,
title: version.title,
summary: version.summary || '',
content: version.content,
contentType: version.contentType || 'text',
publishedAt: version.publishedAt,
effectiveAt: version.effectiveAt,
},
};
}
}
module.exports = AgreementService;