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

271 lines
10 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 { Controller } = require('egg');
/** 邮箱格式(与页面版保持一致,宽松校验) */
const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
/**
* web 用户端:登录 / 注册 / 找回密码 / 重置密码(**JSON 接口**,给前端 SPA 调)
*
* 鉴权走 **header 令牌**(`Authorization: Bearer <user JWT>`),不依赖 cookie/session:
* 前端与后端不同源也没问题,也天然不受 CSRF 影响(`/api/*` 不过 CSRF)。
*
* 统一响应:成功 `{ ok:true, data }`;失败 `{ ok:false, status?, message }`。
*/
class WebAuthController extends Controller {
/** 客户端标识(只认白名单,避免任意字符串进库) */
normalizeClient(value) {
const client = String(value || '').trim().toLowerCase();
return [ 'mini_program', 'web', 'h5' ].includes(client) ? client : '';
}
/** 当前配置下,这个客户端是否必须先同意协议 */
shouldEnforceAgreement(client) {
const mode = String(this.app.config.agreement.enforce || 'mini_program').toLowerCase();
if ([ 'off', 'false', '0', 'no' ].includes(mode)) return false;
if (mode === 'all') return true;
return client === 'mini_program';
}
/**
* 校验协议同意情况
* 通过 → 返回可落库的 `[{ agreementId, code, versionId, version }]`;
* 不通过 → 直接写 428 响应并返回 null(客户端拿到最新协议后重新展示)
*/
async requireAgreements(input) {
const { ctx } = this;
const required = await ctx.service.agreement.requiredVersions();
const check = ctx.service.agreement.verifyAcceptance(required, input);
if (check.ok) return check.accepted;
ctx.status = 428;
ctx.body = {
ok: false,
status: 'agreement_required',
message: '请阅读并同意用户协议后再登录',
data: { agreements: required },
};
return null;
}
/** 落库同意记录(失败不阻断登录,只记错误日志) */
async recordAgreements(user, accepted, client) {
const { ctx } = this;
try {
return await ctx.service.agreement.record(user.id, accepted, {
source: client || 'unknown',
ip: ctx.ip,
userAgent: String(ctx.get('user-agent') || ''),
});
} catch (err) {
ctx.logger.error('[web] 记录协议同意失败, userId=%s: %s', user.id, err.message);
return [];
}
}
/**
* 签发令牌 + 返回脱敏用户(登录 / 注册成功后都走它)
*
* `subjects` 带上当前账号可进入的主体列表(前端登录后直接拿它渲染切换器,不用再请求一次)
*/
async issue(user) {
const { ctx } = this;
let subjects = [];
try {
subjects = await ctx.service.subject.listForUser(user.id);
} catch (err) {
ctx.logger.warn('[web] 登录时读取主体列表失败: %s', err.message);
}
return {
token: ctx.service.jwt.signUser(user),
tokenType: 'Bearer',
expiresIn: ctx.app.config.jwt.userExpiresIn,
user,
subjects,
};
}
/**
* POST /api/web/auth/login
* body: `{ account, password, client?, agreements? }`
* - account 支持 用户名 / 手机号 / 邮箱
* - client = 'mini_program' 时必须同意当前协议版本(见 config.agreement.enforce)
* - agreements = `[{ code, versionId }]`,登录成功后按用户 + 版本落库
* → `{ token, tokenType, expiresIn, user, subjects, agreements? }`
*/
async login() {
const { ctx } = this;
const body = ctx.request.body || {};
const { account, password } = body;
const client = this.normalizeClient(body.client);
if (!account || !password) {
ctx.status = 422;
ctx.body = { ok: false, message: '请填写账号和密码' };
return;
}
let accepted = null;
if (this.shouldEnforceAgreement(client)) {
accepted = await this.requireAgreements(body.agreements);
if (!accepted) return;
}
const user = await ctx.service.auth.login(String(account).trim(), password);
if (!user) {
ctx.status = 401;
ctx.body = { ok: false, status: 'unauthorized', message: '账号或密码错误' };
return;
}
ctx.logger.info('[web] %s 登录成功(API, client=%s)', user.username || account, client || 'unknown');
const data = await this.issue(user);
if (accepted) {
data.agreements = await this.recordAgreements(user, accepted, client);
ctx.logger.info('[web] 用户 %s 同意协议:%s', user.id, accepted.map(item => `${item.code}@${item.version}`).join(', '));
}
ctx.body = { ok: true, data };
}
/**
* POST /api/web/auth/register/code
* body: `{ email }` → 发 6 位邮箱验证码(开发模式直接返回 `code`)
*/
async sendRegisterCode() {
const { ctx } = this;
const email = String((ctx.request.body || {}).email || '').trim().toLowerCase();
if (!ctx.app.config.register.enable) {
ctx.throw(403, '注册已关闭,请联系管理员开通账号');
}
if (!EMAIL_RE.test(email)) {
ctx.throw(422, '请填写正确的邮箱');
}
const exists = await ctx.service.user.findOneBy({ email });
if (exists) ctx.throw(409, '该邮箱已被使用');
const result = await ctx.service.verifyCode.send('register', email);
if (!result.ok) ctx.throw(429, result.message);
ctx.logger.info('[web] 注册验证码已发送到 %s', email);
ctx.body = {
ok: true,
data: {
email,
// 开发模式(未配 SMTP)把验证码带回来,前端可直接提示;生产不返回
devMode: Boolean(result.devMode),
code: result.devMode ? result.code : undefined,
},
};
}
/**
* POST /api/web/auth/register
* body: `{ username, email, code, password, nickname?, phone? }` → 建成即登录(返回令牌)
*/
async register() {
const { ctx } = this;
const body = ctx.request.body || {};
const username = String(body.username || '').trim();
const email = String(body.email || '').trim().toLowerCase();
const code = String(body.code || '').trim();
const password = String(body.password || '');
const nickname = String(body.nickname || '').trim();
const phone = String(body.phone || '').trim();
if (!ctx.app.config.register.enable) ctx.throw(403, '注册已关闭,请联系管理员开通账号');
if (!/^[A-Za-z0-9_]{3,32}$/.test(username)) ctx.throw(422, '用户名需 3-32 位字母、数字或下划线');
if (!EMAIL_RE.test(email)) ctx.throw(422, '邮箱格式不正确');
if (!/^\d{6}$/.test(code)) ctx.throw(422, '请填写 6 位邮箱验证码');
if (password.length < 6) ctx.throw(422, '密码至少 6 位');
if (phone && !/^[0-9+\-]{6,20}$/.test(phone)) ctx.throw(422, '手机号格式不正确');
const checked = await ctx.service.verifyCode.check('register', email, code);
if (!checked.ok) ctx.throw(422, checked.message);
try {
const user = await ctx.service.auth.register({ username, password, nickname, email, phone: phone || null });
// 注册成功才消费验证码(用户名/邮箱冲突时可改完重提,不用重新收码)
await ctx.service.verifyCode.consume('register', email);
ctx.logger.info('[web] %s 注册成功(API,id=%s)', username, user.id);
ctx.body = { ok: true, data: await this.issue(user) };
} catch (err) {
// 唯一键冲突(409):翻成页面能直接显示的文案
if (err.status === 409) {
const message = String(err.message || '');
ctx.status = 409;
ctx.body = {
ok: false,
message: message.startsWith('username') ? '该用户名已被使用'
: message.startsWith('email') ? '该邮箱已被使用'
: message.startsWith('phone') ? '该手机号已被注册'
: '注册失败,请稍后重试',
};
return;
}
throw err;
}
}
/**
* POST /api/web/auth/forgot
* body: `{ email }` → 发重置链接(**防账号枚举**:邮箱没注册也返回成功)
*/
async forgot() {
const { ctx } = this;
const email = String((ctx.request.body || {}).email || '').trim().toLowerCase();
if (!EMAIL_RE.test(email)) ctx.throw(422, '请填写正确的邮箱');
const user = await ctx.service.user.findOneBy({ email });
if (user && Number(user.status) === 1) {
const origin = ctx.app.config.email.siteUrl || ctx.origin;
const result = await ctx.service.passwordReset.send(user, origin);
if (!result.ok) {
// 直接回状态码 + 原文(不走 ctx.throw:5xx 会被 error_handler 盖成「服务器内部错误」)
// 节流 → 429(前端把 message 展示给用户);Redis/发信异常 → 503
ctx.status = result.reason === 'throttled' ? 429 : 503;
ctx.body = { ok: false, status: result.reason || 'error', message: result.message };
return;
}
ctx.logger.info('[web] 已向 %s 发送重置密码链接', email);
ctx.body = {
ok: true,
data: {
sent: true,
// 开发模式(未配 SMTP)把链接返回,前端可直接点开
devMode: Boolean(result.devMode),
url: result.devMode ? result.url : undefined,
},
};
return;
}
if (user) ctx.logger.warn('[web] 账号已禁用,不发送重置链接: %s', email);
ctx.body = { ok: true, data: { sent: true } };
}
/**
* POST /api/web/auth/reset
* body: `{ token, password }` → 用邮件里的令牌设新密码(令牌一次性)
*/
async reset() {
const { ctx } = this;
const body = ctx.request.body || {};
const token = String(body.token || '');
const password = String(body.password || '');
const userId = await ctx.service.passwordReset.verify(token);
if (!userId) ctx.throw(410, '重置链接无效或已过期,请重新获取');
if (password.length < 6) ctx.throw(422, '密码至少 6 位');
await ctx.service.auth.setPassword(userId, password);
await ctx.service.passwordReset.consume(token, userId);
ctx.logger.info('[web] 用户 %s 通过邮件链接重置了密码(API)', userId);
ctx.body = { ok: true, data: { id: userId } };
}
}
module.exports = WebAuthController;