feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.

docs/TECH_DEBT_ZH.md

@@ -1,94 +1,73 @@
-# 技术债与工程待办
+# 技术债与工程待办（v1.4）
 
-目标：在持续交付的同时，让技术债可见、可追踪、可关闭。
+最后更新：`2026-03-14`
 
----
+目标：在收费上线后，优先保证支付可靠性、权限一致性和运营可追溯性。
 
 ## 1. 债务快照
 
-当前估计：**90% 稳定 / 10% 技术债**。
+当前估计：**93% 稳定 / 7% 技术债**。
 
 ```mermaid
 flowchart TD
     A["技术债"]
 
-    subgraph PI["支付基础设施"]
-        PI1["支付事件入库与对账"]
-        PI2["订阅用户持久化"]
-        PI3["权限策略一致化"]
+    subgraph P["支付与订阅"]
+        P1["异常交易自动重放策略"]
+        P2["退款与工单流程"]
+        P3["多链结算对账"]
     end
 
-    subgraph Q["质量保障"]
-        Q1["回放仿真能力"]
-        Q2["端到端集成覆盖"]
+    subgraph E["权限与运营"]
+        E1["前后端/Bot 权限矩阵回归"]
+        E2["积分与订阅冲突策略"]
     end
 
     subgraph O["可观测性"]
-        O1["告警证据标准"]
-        O2["运维看板"]
+        O1["支付失败原因分层指标"]
+        O2["业务监控看板"]
     end
 
-    A --> PI
-    A --> Q
+    A --> P
+    A --> E
     A --> O
 ```
 
----
+## 2. 近期已关闭
 
-## 2. 近期已关闭（2026-03-12）
+- P1 支付主链路已上线（intent -> submit -> confirm）。
+- 支付自动补单已上线（Event Loop + Confirm Loop）。
+- 钱包绑定支持浏览器钱包 + WalletConnect。
+- 账户中心与 Pro 权限展示链路打通。
+- 钱包异动支持独立频道路由。
 
-- Bot 入口重构完成：
-  - `bot_listener.py` 已收敛为薄入口。
-  - 运行时拆分为编排层/处理层/服务层/分析层/守卫层/协调层。
-- 启动诊断完成：
-  - 新增 `/diag` 指令
-  - 后台循环启动状态可视化（错价雷达、Polygon 钱包、Polymarket 异动）
-- 错价锚点完成升级：从单一 Open-Meteo 改为多模型最高温锚点。
-- 不可交易市场硬拦截完成：`closed`/inactive/不接单/超结束时间全部跳过。
-- 钱包异动监听增强完成：昵称映射、链接预览开关、去抖与即时推送控制。
-- 前端 BFF `ETag/304` 缓存完成（cities/summary/history）。
-- Meteoblue 已从运行链路与文档中彻底移除。
-
----
-
-## 3. 当前高优先级技术债
+## 3. 高优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 支付事件采集与对账流水线 | 无法稳定自动开通付费权限 | 构建幂等 payment ingest + reconciliation worker |
-| 订阅用户持久化模型 | 人工开通不可扩展 | 落地 PostgreSQL/Supabase 订阅状态 |
-| 权限策略一致性矩阵 | 存在漏放行/误拦截风险 | 统一前端中间件、后端 API、Bot 守卫策略 |
-| 告警证据协议 | 假阳性排障成本高 | 统一机器可读 Evidence Schema |
+| 支付异常重放策略标准化 | 偶发确认失败需人工介入 | 建立 tx hash 自动回放 + 降级路径 |
+| 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 |
+| 订阅审计可视化 | 排障效率受限 | 建立订阅事件时间线视图 |
+| 多邮箱绑定同 TG 账户策略 | 积分归属易混淆 | 引入主账号绑定策略与迁移工具 |
 
----
-
-## 4. 当前中优先级技术债
+## 4. 中优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 回放仿真能力不足 | 边缘场景回归难复现 | 基于天气+市场快照构建确定性 Replay |
-| 端到端集成覆盖不足 | 运行时回归难提前发现 | 增加 `/api/city/{name}/detail` 与推送链路集成测试 |
-| 配置项分散 | 阈值调优易出错 | 将关键 env 聚合为结构化配置分组 |
-| 命名与字段兼容历史包袱 | 认知与维护成本高 | 统一模型/市场字段命名与兼容层 |
+| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/签到/奖励） |
+| 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 |
+| 配置收敛 | 运维出错概率高 | 将支付/推送配置集中分组管理 |
 
----
-
-## 5. 当前低优先级技术债
+## 5. 低优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 冷启动波动 | 首次请求延迟抖动 | 对热点城市路由做预热 |
-| 本地文件状态依赖 | 多实例扩展受限 | 继续迁移到托管存储 |
-
----
+| 前端离线缓存能力 | 非核心 | 评估 Service Worker + IndexedDB |
+| 冷启动波动 | 首屏抖动 | 热点城市预热 |
 
 ## 6. 下阶段里程碑
 
-1. 上线订阅用户 DB 与权限过期模型。
-2. 完成支付事件入库与自动授权同步。
-3. 落地天气+市场混合回放回归。
-4. 发布告警证据标准与运维排障工具。
-
----
-
-最后更新：`2026-03-12`
+1. 完成支付异常自动重放与告警分层。
+2. 上线退款/售后后台最小版。
+3. 建立商业化运营看板（支付、续费、留存）。
+4. 完成权限矩阵自动化回归测试。