fix(subscribe): 订阅消息未下发原因可见 + 小程序真实授权

- 后台测试推送：未就绪返回 mode=SIMULATED 明确原因 + 配置自检(模板ID/openid/appId/appSecret/总开关)，不再把模拟显示为成功

- 占位符 tmpl_xxx 视为未配置（测试推送与订阅模板接口均过滤），微信错误码中文化(43101/47003/40037/40001 等)

- 小程序「平台消息与通知」点击时真实调用 wx.requestSubscribeMessage 并回显授权状态，标签不再恒为已开启

- 管理端拦截器错误提示改用 message；文档补订阅消息排查顺序；新增回归护栏(86 套件/631 用例全绿)

docs/部署验收与1分钱支付闭环.md

@@ -125,10 +125,17 @@ MYSQL_DATABASE=peiwan
 接入说明：
 - **模板创建**：在微信公众平台「订阅消息」创建 4 个模板，把真实模板ID填入后台。各模板的字段（如 `phrase1`/`thing2`/`time3`/`character_string1`/`amount1`）**需与代码下发时的 data 键一致**（不一致会返回 47003 等错误，日志可见）。若你的模板字段名不同，把字段占位符发我，我按模板对齐 `data` 键。
 - **触发点**：① 订单进入"履约中"→ 给买家下发订单状态 + 4位核销码通知；② 组局报名成功 → 给报名者下发通知；③ 提现"打款成功"（受理/回调确认到账）→ 给提现大神下达到账通知。
-- **就绪条件**：`enablePush=1` + 对应模板ID已填 + 小程序 `appId/appSecret` 已配置 + 目标用户有 `openid`。任一缺失则静默跳过（不阻塞业务）。
-- **后台测试推送**：管理端"测试推送"在就绪时**真实下发**；未就绪时返回模拟结果并说明原因（mode=REAL/SIMULATED）。目标用户填其 UID，且该用户须有 openid。
-- **小程序授权**：设置页开启通知时用**真实模板ID** 调 `wx.requestSubscribeMessage` 收集授权。订阅为**一次性**，需在关键动作前再次请求（后续可在下单/报名/提现前补请求）。
-- **启动自检**：不额外打印；如需可在后台测试推送处验证。
+- **就绪条件**：`enablePush=1` + 对应模板ID已填（**不能是 `tmpl_xxx` 占位符**）+ 小程序 `appId/appSecret` 已配置 + 目标用户有 `openid` + 用户已授权该模板订阅。任一缺失即不下发。
+- **后台测试推送**：管理端"测试推送"在就绪时**真实下发**（`mode=REAL`）；未就绪返回 `mode=SIMULATED` 并给出**明确原因**与**配置自检**（模板ID/openid/appId/appSecret/总开关），不再显示"发送成功"。
+- **小程序授权**：「平台消息与通知」点击时会用**真实模板ID** 调 `wx.requestSubscribeMessage` 收集授权，并在页面标签显示实际状态。订阅为**一次性**（每条授权仅可下发 1 条），已在下单/报名/提现前再次请求。
+
+### 收不到推送时的排查顺序（对照后台测试推送的"配置自检"）
+1. `模板ID 缺失` → 后台把该类型模板的**真实模板ID**填入并保存（占位符 `tmpl_xxx` 视为未配置）。
+2. `总开关 未开启` → 后台打开"开启微信通知"总开关。
+3. `目标用户 openid 缺失` → 该用户必须通过**微信登录**过小程序（REST 走 `/api/auth/wechat-login` 换 openid）。
+4. `appId/appSecret 缺失` → 在微信支付/小程序凭证配置里填写真实 `appId` 与 32 位 `appSecret`。
+5. 以上都 ✅ 但仍失败 → 看后台提示的**微信返回码**：`43101` 用户未授权（让用户在小程序内重新点「平台消息与通知」授权）、`47003` 模板字段名/长度与模板不一致、`40037` 模板ID无效。
+6. 订阅消息为**一次性**：用户授权一次只能收 1 条；高频场景需每次动作前请求授权（代码已在下单/报名/提现前请求）。
 
 ## 八、内容安全（可选）