- 主体状态缓存(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>
115 lines
3.3 KiB
JavaScript
115 lines
3.3 KiB
JavaScript
'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;
|