'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;