docs: Add new READMEs for extension and frontend, create tech debt document, and update Chinese README.

This commit is contained in:
2569718930@qq.com
2026-03-20 19:07:11 +08:00
parent 6e3bc1ce75
commit 2a19a23e4d
4 changed files with 82 additions and 82 deletions
+42 -42
View File
@@ -1,31 +1,31 @@
# Technical Debt Backlog (v1.4)
# 技术债与工程待办(v1.4
Last Updated: `2026-03-14`
最后更新:`2026-03-14`
Focus after paid launch: payment reliability, entitlement parity, and auditability.
目标:在收费上线后,优先保证支付可靠性、权限一致性和运营可追溯性。
## 1. Snapshot
## 1. 债务快照
Current estimate: **93% stable / 7% debt**.
当前估计:**93% 稳定 / 7% 技术债**。
```mermaid
flowchart TD
A["Tech Debt"]
A["技术债"]
subgraph P["Payments & Subscriptions"]
P1["Automatic replay for failed confirmations"]
P2["Refund and support workflow"]
P3["Multi-chain settlement reconciliation"]
subgraph P["支付与订阅"]
P1["异常交易自动重放策略"]
P2["退款与工单流程"]
P3["多链结算对账"]
end
subgraph E["Entitlement & Ops"]
E1["Frontend/backend/bot entitlement regression matrix"]
E2["Points vs subscription conflict policy"]
subgraph E["权限与运营"]
E1["前后端/Bot 权限矩阵回归"]
E2["积分与订阅冲突策略"]
end
subgraph O["Observability"]
O1["Layered metrics for payment failures"]
O2["Business operations dashboards"]
subgraph O["可观测性"]
O1["支付失败原因分层指标"]
O2["业务监控看板"]
end
A --> P
@@ -33,41 +33,41 @@ flowchart TD
A --> O
```
## 2. Recently Closed
## 2. 近期已关闭
- P1 checkout flow live (intent -> submit -> confirm).
- Automatic reconciliation live (event loop + confirm loop).
- Wallet binding supports extension wallets + WalletConnect.
- Account center entitlement rendering is wired end-to-end.
- Wallet activity watcher supports dedicated channel routing.
- P1 支付主链路已上线(intent -> submit -> confirm)。
- 支付自动补单已上线(Event Loop + Confirm Loop)。
- 钱包绑定支持浏览器钱包 + WalletConnect
- 账户中心与 Pro 权限展示链路打通。
- 钱包异动支持独立频道路由。
## 3. High-Priority Debt
## 3. 高优先级技术债
| Item | Impact | Suggested Work |
| 项目 | 影响 | 建议动作 |
| :-- | :-- | :-- |
| Automatic replay strategy for transient tx failures | Manual intervention still needed in some edge cases | Standardize tx replay + fallback paths |
| Refund/support workflow | Commercial loop incomplete | Add refund state machine + support tooling |
| Subscription audit visualization | Slower incident triage | Build timeline view for entitlement events |
| Multi-email same-Telegram binding policy | Points ownership confusion | Add primary-account binding and migration utilities |
| 支付异常重放策略标准化 | 偶发确认失败需人工介入 | 建立 tx hash 自动回放 + 降级路径 |
| 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 |
| 订阅审计可视化 | 排障效率受限 | 建立订阅事件时间线视图 |
| 多邮箱绑定同 TG 账户策略 | 积分归属易混淆 | 引入主账号绑定策略与迁移工具 |
## 4. Medium-Priority Debt
## 4. 中优先级技术债
| Item | Impact | Suggested Work |
| 项目 | 影响 | 建议动作 |
| :-- | :-- | :-- |
| Points transparency | User confusion | Expose points breakdown by source |
| Payment error copy consistency | Conversion impact | Build error-code to UX-copy mapping table |
| Config sprawl | Ops mistakes | Consolidate payment/push configs into grouped schemas |
| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细(发言/签到/奖励) |
| 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 |
| 配置收敛 | 运维出错概率高 | 将支付/推送配置集中分组管理 |
## 5. Low-Priority Debt
## 5. 低优先级技术债
| Item | Impact | Suggested Work |
| 项目 | 影响 | 建议动作 |
| :-- | :-- | :-- |
| Offline cache support | Non-core | Evaluate SW + IndexedDB |
| Cold-start variance | First-load jitter | Add route prewarming for hot cities |
| 前端离线缓存能力 | 非核心 | 评估 Service Worker + IndexedDB |
| 冷启动波动 | 首屏抖动 | 热点城市预热 |
## 6. Next Milestones
## 6. 下阶段里程碑
1. Ship automatic replay and alert stratification for payment anomalies.
2. Launch minimal refund/support admin flow.
3. Add business dashboards for payments, renewals, and retention.
4. Complete entitlement parity regression suite.
1. 完成支付异常自动重放与告警分层。
2. 上线退款/售后后台最小版。
3. 建立商业化运营看板(支付、续费、留存)。
4. 完成权限矩阵自动化回归测试。