Refresh docs for observability, payments, and SQLite rollout

docs/TECH_DEBT.md

@@ -1,62 +1,73 @@
 # 技术债与工程待办（v1.4.0）
 
-最后更新：`2026-03-14`
+最后更新：`2026-03-20`
 
-目标：在收费上线后，优先保证支付可靠性、权限一致性和运营可追溯性。
+目标：在收费上线后，优先保证状态一致性、支付可靠性、可观测性和概率引擎发布可控。
 
 ## 1. 债务快照
 
-当前估计：**93% 稳定 / 7% 技术债**。
+当前估计：**95% 稳定 / 5% 技术债**。
 
 ```mermaid
 flowchart TD
     A["技术债"]
 
     subgraph P["支付与订阅"]
-        P1["异常交易自动重放策略"]
+        P1["合约 V2 升级（SafeERC20 / Pausable）"]
         P2["退款与工单流程"]
-        P3["多链结算对账"]
+        P3["多 RPC 与链上对账面板"]
     end
 
     subgraph E["权限与运营"]
         E1["前后端/Bot 权限矩阵回归"]
-        E2["积分与订阅冲突策略"]
+        E2["积分来源明细与补分审计"]
     end
 
     subgraph O["可观测性"]
-        O1["支付失败原因分层指标"]
+        O1["外部监控抓取与告警阈值"]
         O2["业务监控看板"]
     end
 
+    subgraph S["状态与概率"]
+        S1["SQLite dual -> sqlite 切换验收"]
+        S2["EMOS shadow -> primary 门禁稳定化"]
+    end
+
     A --> P
     A --> E
     A --> O
+    A --> S
 ```
 
 ## 2. 近期已关闭
 
-- P1 支付主链路已上线（intent -> submit -> confirm）。
+- 支付主链路已上线（intent -> submit -> confirm）。
 - 支付自动补单已上线（Event Loop + Confirm Loop）。
+- 支付事件重放脚本已补齐。
+- 支付运行态 API 与 SQLite 审计事件已补齐。
 - 钱包绑定支持浏览器钱包 + WalletConnect。
 - 账户中心与 Pro 权限展示链路打通。
 - 钱包异动支持独立频道路由。
+- 运行态状态/缓存已支持 SQLite 渐进迁移。
+- 轻量可观测性已上线（`/healthz`、`/api/system/status`、`/metrics`）。
+- EMOS/CRPS 校准链路已上线 shadow 模式。
 
 ## 3. 高优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 支付异常重放策略标准化 | 偶发确认失败需人工介入 | 建立 tx hash 自动回放 + 降级路径 |
+| SQLite 主读切换验收 | 仍处于 dual 过渡期 | 线上跑满 24-48 小时后切到 `sqlite` |
+| EMOS 上线门禁 | 当前 `hold`，不能切 primary | 继续积累样本，重点压 `bucket_brier` |
+| 外部监控与告警 | 只有轻量指标，无外部抓取 | 接 Prometheus/Grafana 或最小巡检 |
 | 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 |
-| 订阅审计可视化 | 排障效率受限 | 建立订阅事件时间线视图 |
-| 多邮箱绑定同 TG 账户策略 | 积分归属易混淆 | 引入主账号绑定策略与迁移工具 |
 
 ## 4. 中优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/签到/奖励） |
+| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/奖励/手动补分） |
+| 支付合约 V2 升级 | 当前仍是最小可用合约 | 升级到 SafeERC20 + Pausable + plan 绑定 |
 | 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 |
-| 配置收敛 | 运维出错概率高 | 将支付/推送配置集中分组管理 |
 
 ## 5. 低优先级技术债
 
@@ -67,7 +78,7 @@ flowchart TD
 
 ## 6. 下阶段里程碑
 
-1. 完成支付异常自动重放与告警分层。
-2. 上线退款/售后后台最小版。
-3. 建立商业化运营看板（支付、续费、留存）。
-4. 完成权限矩阵自动化回归测试。
+1. 完成 SQLite 从 `dual` 到 `sqlite` 的主读切换。
+2. 稳定 EMOS shadow，达到 rollout `observe/promote` 条件。
+3. 补外部监控抓取与告警阈值。
+4. 评估并推进支付合约 V2 升级。