Henry_Du/BYW-VoiceHub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
137 Commits 1 Branch 0 Tags
d1b643bd93c87f4736bc3639f8566196a6c2bdeb
Commit Graph
6 Commits
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 09e7f53a1a feat(微信订阅): 新增一键体检接口 /api/admin/wechat/diagnose 
线上排查「订阅消息没发出去」以前只能靠猜，因为没有查询额度的接口，四条跳过路径
也不写日志。这个 GET 接口（仅超管，浏览器直接打开即可）一次返回所有事实：

- access_token 能不能拿到、长度多少
- WECHAT_MINI_SUBSCRIBE_TEMPLATES / APPID / SECRET 是否注入、模板开关是否启用
- 当前账号有没有绑微信 openid（没有就永远发不出去）、哪些 userId 绑了微信
- 每个模板的 ID、字段映射，以及 buildTemplateData 算出的、真发出去会用的 data
- 加 ?send=1 时顺手给当前用户真发一条（两个模板各一次），把微信的 errcode
  原样返回：0=通、43101=没额度、47003=字段名不对、40003=openid 不对、40001=token 失效

用法：登录后台后打开 /api/admin/wechat/diagnose （或 ?send=1）
 2026-10-11 15:37:39 +08:00
Henry_Du 81fd05b39a feat(微信订阅): 自测接口支持 dryRun（不消耗额度）与 sendToAll（区分没额度/字段错） 2026-10-11 12:04:03 +08:00
Henry_Du 3eff710d5d feat(微信订阅): 接入歌曲排期模板并加固部署流程 
订阅消息（小程序侧唯一能主动触达用户的通道）：
- 新增 server/utils/wechatSubscribeFields.ts：按微信字段类型裁剪值（thing≤20、
  phrase 必须 5 个汉字、time/date/character_string 各自上限），空白压成一行，
  北京时间 time 由 playTime 的开始时间生成，解析不出退化为当天 00:00。
- wechatSubscribeService 内置 SONG_SELECTED 模板（站长新给的那个模板 ID），
  并转发上述纯函数；notificationService.createSongSelectedNotification 现在会带上
  playDate/playTime/sequence，三个排期接口（schedule / publish / bulk-publish）补传 sequence。
- 新增 test/wechatSubscribeFields.test.mjs（10 例，node --test 全绿）。
- test-subscribe 管理接口支持 vars 覆盖并返回真实发送值，方便站长核对字段名。

部署流程（Gitea Actions 容器里没有 buildx 插件，旧流程在此硬失败）：
- 每个 job 各自安装/探测 docker-buildx（v0.19.3，走 gh-proxy 再退直连），
  不把 `buildx version` 当唯一依据；装不上时降级为普通 `docker build` 继续发布，
  不再因为缺插件整条流水线失败。

注意：SONG_SELECTED 的字段名（thing2/date4/time1/character_string3/phrase5）是按常见
命名推断的，需在公众平台后台核对；不一致时用环境变量覆盖，模板 ID 变更后老用户需重新授权。
 2026-10-11 00:04:14 +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