PolyWeather/docs/TECH_DEBT_ZH.md

技术债与工程待办（v1.4）

最后更新：2026-03-14

目标：在收费上线后，优先保证支付可靠性、权限一致性和运营可追溯性。

1. 债务快照

当前估计：93% 稳定 / 7% 技术债。

flowchart TD
    A["技术债"]

    subgraph P["支付与订阅"]
        P1["异常交易自动重放策略"]
        P2["退款与工单流程"]
        P3["多链结算对账"]
    end

    subgraph E["权限与运营"]
        E1["前后端/Bot 权限矩阵回归"]
        E2["积分与订阅冲突策略"]
    end

    subgraph O["可观测性"]
        O1["支付失败原因分层指标"]
        O2["业务监控看板"]
    end

    A --> P
    A --> E
    A --> O

2. 近期已关闭

• P1 支付主链路已上线（intent -> submit -> confirm）。
• 支付自动补单已上线（Event Loop + Confirm Loop）。
• 钱包绑定支持浏览器钱包 + WalletConnect。
• 账户中心与 Pro 权限展示链路打通。
• 钱包异动支持独立频道路由。

3. 高优先级技术债

项目	影响	建议动作
支付异常重放策略标准化	偶发确认失败需人工介入	建立 tx hash 自动回放 + 降级路径
退款与售后链路	商业闭环不完整	增加退款状态机与工单系统
订阅审计可视化	排障效率受限	建立订阅事件时间线视图
多邮箱绑定同 TG 账户策略	积分归属易混淆	引入主账号绑定策略与迁移工具

4. 中优先级技术债

项目	影响	建议动作
积分发放可解释性	用户理解成本高	输出积分来源明细（发言/签到/奖励）
支付失败文案标准化	转化率受影响	建立错误码 -> 文案映射表
配置收敛	运维出错概率高	将支付/推送配置集中分组管理

5. 低优先级技术债

项目	影响	建议动作
前端离线缓存能力	非核心	评估 Service Worker + IndexedDB
冷启动波动	首屏抖动	热点城市预热

6. 下阶段里程碑

1. 完成支付异常自动重放与告警分层。
2. 上线退款/售后后台最小版。
3. 建立商业化运营看板（支付、续费、留存）。
4. 完成权限矩阵自动化回归测试。