6 Commits

Include renames

Author	SHA1	Message	Date
Henry_Du	d1b643bd93	refactor(微信订阅): 重写订阅消息链路，每一步失败都可见 ... 把「微信订阅消息」这套代码按验收标准推翻重写：用户能自己看懂为什么收不到， 任何一步失败都必须看得见。对外函数名不变，notificationService / test-subscribe 等调用点无需改动。 新增 server/utils/wechatSubscribeTemplates.ts（纯函数，零依赖）： - 模板登记表唯一来源（内置 SONG_SELECTED / SONG_REJECTED），服务层不再自己写死 - parseSubscribeTemplates 如实报告环境变量覆盖情况：坏 JSON 只报告不抛、 只给 id 时沿用内置字段映射、缺 id 的项记进 unknownKeys 并忽略 - findEmptyFields / findEmptyDataFields 发出前自查空字段（微信空值整条 47003） - explainWechatErrcode 把 43101/47003/40003/40037/40001/45009 翻成人话 重写 server/services/wechatSubscribeService.ts： - sendWechatSubscribe 返回 SendOutcome，用 stage 明确「卡在哪一步」： no-template / disabled-by-user / no-wechat-openid / no-access-token / empty-field / no-grant / rejected-no-quota / rejected-bad-field / rejected-other - 每一次返回都写一行日志，不再有静默跳过（这是「发不出去全靠猜」的根因） - inspectWechatSubscribe 只读体检：不发消息、不消耗额度，返回逐项 verdict + actions - grantWechatSubscribe 依靠新增的 WechatSubscribeGrant 表记账：微信没有查询 剩余授权的接口，只能自己数（用户点允许 +1、发送成功 -1） - 记账表不可用时失败开放（fail-open）：额度预检关闭、照常发送，避免通知整体哑掉 - access_token 显式 responseType: json 并做字符串兜底解析 新增接口： - GET /api/user/wechat-subscribe-status 小程序显示「还能收到几条 / 为什么收不到」 - POST /api/user/wechat-subscribe-grant 小程序授权成功后上报 accept 的模板 - GET /api/admin/wechat/diagnose 重写：人话结论 + actions，?send=1 真发一次 其他：新增 WechatSubscribeGrant 表（schema + 手写迁移）、.env.example 说明 JSON 覆盖 写法、.gitattributes 补 *.sql eol=lf。 测试：新增 test/wechatSubscribeTemplates.test.mjs（13 个用例，可直接 import .ts， 不依赖 Nuxt 别名），npm test 里订阅相关 25/25 通过。	2026-10-11 16:02:33 +08:00
Henry_Du	ebf1c3a127	perf(auth): 登录去掉一次冗余查库 + 缓存 2FA 查询 + 修掉 session_key 进日志 ... 登录实测约 232ms，其中 bcrypt 约 72ms、网络往返约 80ms 是不可省的计算/物理成本， 剩下的都是我们自己的开销。这次把能省的两处省掉（实测约 40ms，占登录耗时约 19%）： 1. 去掉「数据库连接检查」的冗余预检 原来每次登录先 await db.select().from(users).limit(1) 只为"测连接"， 紧接着又会真的查用户，连不上一样会报错 —— 纯粹多一次数据库往返。 现在把那次真实查询包进 try，只有它失败才回报 503「数据库服务暂时不可用」， 错误码与文案完全不变。 2. 缓存「这个账号有没有开 2FA」 登录每次都查 userIdentities 找 TOTP，但绝大多数账号根本没开 2FA。 新增 server/utils/totp-cache.ts： · 查到**没有** TOTP → 缓存 10 分钟，后续登录直接跳过查询 · 查到**有** TOTP → **不缓存**（安全优先：绝不能因为缓存而让刚开 2FA 的人被跳过验证） 开启/关闭 2FA 的接口必须调用 invalidateTotpCache(userId)，已在 server/api/user/2fa/{enable,disable}.post.ts 接上 —— 否则会有最长 10 分钟的验证空窗。 该缓存不参与密码校验，最坏情况只是多查一次库。 3. lastLogin / lastLoginIp 的 UPDATE 不再阻塞响应 登录时间与登录 IP 是审计信息，晚写几十毫秒、甚至这次写失败， 都不影响用户能否登录。改为不 await（保留 .catch，避免 unhandledRejection）。 4. 安全修复：微信登录不再把 session_key 打进日志 server/api/auth/wechat/login.post.ts 原来打印整个 jscode2session 响应前 500 字， 而该响应含 { session_key, openid, unionid }。 session_key 是敏感凭据（可解密用户数据、配合其他接口换取手机号）， 长期落在服务端日志里等于凭据落盘。 现在只打印：顶层键名、errcode/errmsg、以及 openid/session_key/unionid 的 存在性与长度（不打印值）；仅在"响应根本不是对象"时才打印截断原文 （那种情况它不可能是合法凭据，且是排查被代理拦成 HTML 的唯一线索）。 已验证： - 缓存逻辑用假 db 真跑过 5 个场景（命中缓存省下查询、失效后立刻重查、 有 2FA 不缓存、多用户互不干扰、只失效指定用户） - 4 个改动文件的相对 import 路径均存在；totp-cache 的导出与两处 import 对得上 - login.post.ts 抽走 TOTP 查询后已清理不再使用的 userIdentities / and 导入 - 文件编码 UTF-8 无 BOM、无乱码、括号平衡	2026-10-01 21:04:02 +08:00
Henry_Du	5039ab3f79	feat(auth): 账号名必须是纯中文，唯一例外是管理员账号 admin ... 站长要求：账号名除了 admin 其它都必须是中文名。 原来「只能包含汉字」的校验散在 5 个写入路径上，而且**没有 admin 例外** —— 导致连 admin 账号自己都编辑不了（改任何字段都撞「姓名和用户名只能包含汉字」）。 - 新增 server/utils/username.ts：规则一处定义 · isValidUsername：纯中文，或恰好是 admin · isValidPersonName：姓名纯中文，但 admin 账号的姓名不做限制 · 统一提示文案（接口报错与客户端提示共用同一句） - 5 个写入路径全部改用它，并删掉各自的 chineseRegex： admin/users 新建、admin/users 编辑、admin/users 批量导入、auth/register、user/profile - 注册时明确拒绝 admin（系统保留账号） 已验证：两端规则对 9 个用例结论完全一致；5 处均无旧正则； admin 可编辑，拼音名（zhangsan / zhang.san / 张三1 / 带空格）一律被拦。	2026-09-30 20:50:09 +08:00
Henry_Du	cccaf36990	feat(brand): 站点品牌名统一为「宝一外校园点歌系统」 ... 站长要求全站一致（小程序端已单独提交）。本次只改**用户可见文案与默认值**： - 服务端默认值/兜底：system-settings-defaults、admin/system-settings(GET/POST)、 site-config.get、utils/siteUtils —— 原来是 'VoiceHub' / '校园广播站点歌系统' - 用户可见通知文案：MeoW 绑定验证码与标题、MeoW 测试通知、微信订阅测试通知 - 2FA 应用名（authenticator.keyuri）、WebAuthn rpName（出现在系统密钥弹窗里） - 网页版界面：首页副标题、后台侧栏品牌名、登录/注册/找回/改密标题与文案、 年度回顾（IntroSlide / ShareCard / 页面标题）、用户教程、通知发送预览、 API 密钥与数据库导入说明、酷狗 sidecar 说明、打印页脚与歌单卡片页脚、Logo alt **刻意不动**：localStorage/sessionStorage 的 `voicehub_*` 键、`voicehub:` 前缀的 STORAGE_KEY 与缓存/Redis 前缀、`window.voiceHubPlayer` 之类代码标识、MeoW 的 User-Agent、以及上游项目链接 `github.com/laoshuikaixue/VoiceHub`（那是对原项目的署名）。 注意：站点名**数据**（systemSettings.siteTitle）仍是你后台里设置的「宝一外校园点歌」， 代码只保证默认值与文案一致；要让全站显示完整名称，请在后台「站点配置 → 站点标题」 改成「宝一外校园点歌系统」。	2026-09-30 20:24:55 +08:00
Henry_Du	a2ba15c3ca	feat(notify): 微信订阅消息推送（驳回通知已对接） ... - 新增 server/services/wechatSubscribeService.ts：access_token 缓存 + 模板配置 + 字段裁剪 + subscribe/send · 内置默认模板 SONG_REJECTED（模板 ID erAK**…，审核内容=thing6←歌名，驳回原因=thing4←驳回原因） · 环境变量 WECHAT_MINI_SUBSCRIBE_TEMPLATES 可按键覆盖默认模板 · thing 字段按微信限制裁到 20 字（超长截 19 字 + 省略号），避免 47003 · 发送永不抛异常；43101（用户没授权/没额度）只记 info - 新增 server/api/user/wechat-subscribe-templates.get.ts：给小程序返回模板 ID（客户端要拿它去申请授权） - 新增 server/api/admin/wechat/test-subscribe.post.ts：超管自测接口（token/openid/字段/微信原文一次看清） - notificationService.ts：歌曲被选中/已播放/被驳回/系统通知 四处顺带发微信订阅消息 - .env.example + 部署流水线：WECHAT_MINI_SUBSCRIBE_TEMPLATES 可用仓库 Secret 下发	2026-09-27 13:55:55 +08:00
Henry_Du	4ce4649aaf	初次提交	2026-09-06 08:19:02 +08:00