docs: 微信订阅消息骨架（#11）变更记录与开发交接记录

2026-08-12 17:30:17 +08:00
parent bdf0515f2a
commit fa86542e55
2 changed files with 37 additions and 0 deletions
@@ -266,6 +266,33 @@

 ---

+## 2026-08-12 模块：微信订阅消息骨架（计划 #11）
+
+### 做了什么
+
+- 后端：`wechat_bindings` 表 + `/wechat/binding|bind|subscribe`；`WechatService`（code2session、access_token 内存缓存、订阅消息发送）；巡检风险非绿时异步触发（未配置/未授权静默跳过）。
+- 小程序：「消息订阅」设置页（绑定、授权订阅、状态展示）。
+
+### 思路与决策
+
+- 按用户选择先做**骨架 + 环境变量占位**：`WECHAT_APPID/WECHAT_SECRET/WECHAT_TEMPLATE_*` 默认空，未配置时接口返回明确中文错误，触发逻辑静默跳过，不影响主流程；
+- 微信订阅消息为一次性订阅：每次触发需用户先 `wx.requestSubscribeMessage` 授权，小程序端已实现授权流程，模板 ID 占位待替换；
+- access_token 内存缓存（提前 60 秒过期），避免每次发送都换 token；
+- 订阅消息 data 用 `thing1`（等级）/`thing2`（评分）占位字段，正式模板字段不同时改 `BuildSubscribeData`。
+
+### 验证与部署
+
+- 微信服务 6 个单测（TDD 红→绿），`go test/build/vet` 通过；`build:weapp` 通过；
+- 第九次部署（schema 变更前 pg_dump `silk-20260812-1730.dump`）；冒烟：binding 未绑定、bind 返回「微信未配置」502、巡检触发不崩溃；
+- 相关提交：`921b185`（后端）、`bdf0515`（小程序）；回滚见服务器 README（旧二进制 `server-go-linux.old-20260812-12`）。
+
+### 待办
+
+- 提供 AppID/Secret + 订阅消息模板 ID，替换占位后联调真实推送；
+- 告警产生时的推送触发点（当前只接了巡检）。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。