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

..

admin-password-policy.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

apiError.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

auth-route-policy.ts

feat(auth): 新增微信小程序登录（绑定策略：首次用学号密码绑定）

2026-09-26 13:57:24 +08:00

auth.ts

初次提交

2026-09-06 08:19:02 +08:00

cache-helpers.ts

初次提交

2026-09-06 08:19:02 +08:00

card-code-delete-handler.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

create-auth-session.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

database-health.ts

初次提交

2026-09-06 08:19:02 +08:00

database-manager.ts

fix(server): 补上 DatabaseManager 缺失的连接池与性能方法

2026-09-26 16:21:28 +08:00

email-verification.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

geo.ts

初次提交

2026-09-06 08:19:02 +08:00

grade-class-core.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

grade-class-options.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

important-notification-policy.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

initial-password-policy.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

instance-id.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

ip-utils.ts

初次提交

2026-09-06 08:19:02 +08:00

jwt-enhanced.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

log-manager.ts

初次提交

2026-09-06 08:19:02 +08:00

native_common.ts

初次提交

2026-09-06 08:19:02 +08:00

notification-history-policy.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

oauth-identity.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

oauth-providers.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

oauth-strategies.ts

chore(auth): 临时硬关闭微信聚合登录（aggregate=false）\n\n用户反馈：先暂时不做微信登录了。\n\n双重保险：\n1) 构建期开关：nuxt.config.ts runtimeConfig.public.oauth.aggregate 由\n 原来的 !!process.env.AGGREGATE_OAUTH_APP_ID 改为硬编码 false。\n 影响范围：\n - 登录页 OAuthButtons.vue 中的 v-if 分支不再渲染绿色微信按钮\n - app/pages/account/index.vue 中 hasOAuthProviders aggregate=false → 个人页\n 第三方绑定分区即使其他 provider 都没配也会显示其它 provider，\n 但微信卡片 OAuthBindingCard.vue 因 config.public.oauth.aggregate=false\n 被 v-if 直接拿掉不渲染\n - app/utils/oauth.ts getProviderDisplayName 中 aggregate→微信 映射还保留，\n 恢复时无需再改\n2) 运行期强制关：server/utils/oauth-strategies.ts loadAggregateSettings\n 返回值 aggregateOAuthEnabled 硬编码 false（即使 process.env.AGGREGATE_OAUTH_APP_ID\n 和 system_settings 表都配齐也不启用）。并加 _hardDisabledReason 字段给后续日志\n 留解释，避免以后排查为何 ENV/DB 都有值却 500 说未配置。\n\n后续恢复步骤（两处同时改回即可）：\n A. nuxt.config.ts public.oauth.aggregate 改回\n aggregate: !!process.env.AGGREGATE_OAUTH_APP_ID\n B. server/utils/oauth-strategies.ts loadAggregateSettings 返回对象\n aggregateOAuthEnabled 改回原本逻辑：\n enabled && !!(appId && appKey && endpoint)\n 并删除 _hardDisabledReason 字段即可。\n\n注意：Gitea Repository Secrets 中的 6 条 AGGREGATE_OAUTH / OAUTH_* 没有删除，\n保留在仓库里，下次恢复不用重新输入一遍。

2026-09-13 09:29:05 +08:00

oauth-token.ts

初次提交

2026-09-06 08:19:02 +08:00

oauth.ts

初次提交

2026-09-06 08:19:02 +08:00

open-api-cache.ts

初次提交

2026-09-06 08:19:02 +08:00

permissions.js

feat(admin+server): 酷狗对接 - 扫码绑定管理员账号 / 按排期自动创建酷狗日歌单 + 同步歌曲

2026-09-19 11:57:02 +08:00

redis.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

requireSongAdmin.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

schedule-visibility.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

serverTime.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

siteUtils.ts

feat(brand): 站点品牌名统一为「宝一外校园点歌系统」

2026-09-30 20:24:55 +08:00

studentMask.ts

初次提交

2026-09-06 08:19:02 +08:00

submissionLimit.ts

初次提交

2026-09-06 08:19:02 +08:00

submissionNoteAutoModeration.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

system-settings-defaults.ts

feat(brand): 站点品牌名统一为「宝一外校园点歌系统」

2026-09-30 20:24:55 +08:00

totp-cache.ts

perf(auth): 登录去掉一次冗余查库 + 缓存 2FA 查询 + 修掉 session_key 进日志

2026-10-01 21:04:02 +08:00

twoFactorStore.ts

初次提交

2026-09-06 08:19:02 +08:00

url.ts

feat: 实现主题、黑名单、排程等14项功能迭代

2026-09-12 08:40:59 +08:00

user-agent-info.ts

feat(songs): 歌曲管理支持批量驳回、投稿留言自动审查与排期范围可见性过滤

2026-09-06 17:03:20 +08:00

user-avatar.ts

feat(admin): 优化用户权限分级·统一头像·数据分析面板修复

2026-09-12 08:36:45 +08:00

user-status.ts

fix(users): 状态大小写不敏感 + 彻底修掉「无法编辑其它用户」

2026-09-30 23:49:40 +08:00

user.ts

初次提交

2026-09-06 08:19:02 +08:00

username.ts

feat(auth): 账号名必须是纯中文，唯一例外是管理员账号 admin

2026-09-30 20:50:09 +08:00

webauthn-config.ts

初次提交

2026-09-06 08:19:02 +08:00

webauthn-token.ts

初次提交

2026-09-06 08:19:02 +08:00

wechatSubscribeFields.ts

feat(微信订阅): 接入歌曲排期模板并加固部署流程

2026-10-11 00:04:14 +08:00

wechatSubscribeTemplates.ts

refactor(微信订阅): 重写订阅消息链路，每一步失败都可见

2026-10-11 16:02:33 +08:00