2569718930@qq.com
e79bc2d291
- 删除 polymarket_wallet_activity_watcher.py（914行）及 runtime_coordinator 调度 - 移除 LGBM / Polymarket 价格层 / Groq / prewarm 等 v1.7.0 已废弃功能的文档引用 - 清理 6 个死文档链接，更新文档索引和版本日期 - 移除 POLYMARKET_WALLET_ACTIVITY_* / PREWARM_* 等废弃环境变量 Directive: 文档与代码同步清理，无功能变更 Tested: pytest tests/test_bot_runtime_coordinator.py pass Confidence: high
2.8 KiB
2.8 KiB
技术债与工程待办（v1.7.0）
最后更新：2026-05-10
目标：在收费上线后，优先保证状态一致性、支付可靠性、可观测性和概率引擎发布可控。
1. 债务快照
当前估计：97% 稳定 / 3% 技术债。前端设计系统债务已在 v1.6.0 全面消除。
flowchart TD
A["技术债"]
subgraph P["支付与订阅"]
P1["合约 V2 升级（SafeERC20 / Pausable）"]
P2["退款与工单流程"]
P3["多 RPC 与链上对账面板"]
end
subgraph E["权限与运营"]
E1["前后端/Bot 权限矩阵回归"]
E2["积分来源明细与补分审计"]
end
subgraph O["可观测性"]
O1["外部监控抓取与告警阈值"]
O2["业务监控看板"]
end
subgraph S["状态与概率"]
end
A --> P
A --> E
A --> O
A --> S
2. 近期已关闭
- 前端设计系统工程债务（2026-05-10）：消除 !important 滥用（134→49）、统一断点体系（18→10）、数百处硬编码颜色迁移至 CSS 变量、修复 accent-green 蓝色 Bug、添加 ARIA 无障碍属性、去重 @keyframes、移除死代码（1,697 行）。详见
docs/frontend-ui-design-review.md。 - 支付主链路已上线（intent -> submit -> confirm）。
- 支付自动补单已上线（Event Loop + Confirm Loop）。
- 支付事件重放脚本已补齐。
- 支付运行态 API 与 SQLite 审计事件已补齐。
- 钱包绑定支持浏览器钱包 + WalletConnect。
- 账户中心与 Pro 权限展示链路打通。
- 运行态状态/缓存与核心离线训练、评估、回填链路已完成 SQLite 主路径收口。
- 轻量可观测性已上线（
/healthz、/api/system/status、/metrics）。
3. 高优先级技术债
| 项目 | 影响 | 建议动作 |
|---|---|---|
| 外部监控与告警 | 只有轻量指标，无外部抓取 | 接 Prometheus/Grafana 或最小巡检 |
| 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 |
4. 中优先级技术债
| 项目 | 影响 | 建议动作 |
|---|---|---|
| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/首次消息奖励/欢迎奖励/周排名奖励/周参与奖/手动补分） |
| 支付合约 V2 升级 | 当前仍是最小可用合约 | 升级到 SafeERC20 + Pausable + plan 绑定 |
| 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 |
5. 低优先级技术债
| 项目 | 影响 | 建议动作 |
|---|---|---|
| 前端离线缓存能力 | 非核心 | 评估 Service Worker + IndexedDB |
| 冷启动波动 | 首屏抖动 | 热点城市预热 |
6. 下阶段里程碑
- 补外部监控抓取与告警阈值。
- 评估并推进支付合约 V2 升级。