docs: create roadmap (6 phases)

.planning/STATE.md

@@ -0,0 +1,95 @@
+# Project State — 君鸿卡管系统
+
+**Project:** 君鸿卡管系统 v1.0  
+**Milestone:** v1.0 — MVP 上线准备  
+**Last Updated:** 2026-03-27  
+
+---
+
+## Current Position
+
+| Field | Value |
+|-------|-------|
+| **Current Phase** | 1 — P0 紧急修复 |
+| **Current Plan** | None (planning phase) |
+| **Status** | Planning |
+| **Phase Progress** | 0/8 requirements complete |
+
+```
+Progress: [ 1 ]──[ 2 ]──[ 3 ]──[ 4 ]──[ 5 ]──[ 6 ]
+           ▲
+           Planning
+```
+
+---
+
+## Project Reference
+
+**Core Value:** 业务链路完整可用——代理能采购分配卡/设备，C端客户能充值购包激活套餐，佣金能正确计算并可提现。这条主链路必须端到端跑通。
+
+**Current Focus:** Phase 1 — 修复 8 个阻塞主链路的 P0 Bug（实名常量、自动购包、佣金链、设备导入、提现并发）
+
+---
+
+## Phase Summary
+
+| Phase | Name | Requirements | Status |
+|-------|------|--------------|--------|
+| 1 | P0 紧急修复 | CRITICAL-01~08（8项） | Not started |
+| 2 | 权限/财务/实名/轮询修复 | PERM-01~02, FIN-01~03, REALNAME-01~05, POLL-01~04（14项） | Not started |
+| 3 | 设备体系完善 | DEVICE-01~04（4项） | Not started |
+| 4 | 退款 + 支付 + 运营修复 | REFUND-01~03, PAY-01~04, OPS-01~02（9项） | Not started |
+| 5 | 代码质量清理 | CLEAN-01~06（6项） | Not started |
+| 6 | 流量体系改革（低峰期）| TRAFFIC-01~05（5项） | Not started |
+
+---
+
+## Performance Metrics
+
+| Metric | Value |
+|--------|-------|
+| Phases total | 6 |
+| Requirements v1 | 46 |
+| Requirements mapped | 46/46 (100%) |
+| Plans created | 0 |
+| Plans complete | 0 |
+| Phases complete | 0/6 |
+
+---
+
+## Accumulated Context
+
+### Key Decisions
+- TRAFFIC（Phase 6）必须独立部署，低峰期（凌晨 2~5 点），涉及 DB 迁移 + Redis 架构变更
+- REALNAME-01~05 是原子重构，必须在一个 plan 内完整执行，不可拆分
+- REFUND 退款佣金回扣（REFUND-03）必须使用整数算术，禁用 float64
+- CRITICAL-02 依赖 CRITICAL-01，CRITICAL-05 依赖 CRITICAL-04
+- DEVICE-02/03/04 依赖 DEVICE-01（字段扩展先行）
+- REFUND-02/03 依赖 REFUND-01（数据模型先行）
+
+### Architecture Notes
+- 双进程（API + Worker），依赖集中在 bootstrap 装配
+- PollingHandler 缺 asynqClient（CRITICAL-03 修复），AutoPurchaseHandler 未注册（CRITICAL-04 修复）
+- StopResumeCallback / ResumeCallback 未注入（CLEAN-06 修复）
+- 流量体系当前用直接覆盖写，Phase 6 改为增量累加 + 日粒度 DB
+
+### Known Risks
+- sellerCostPrice 错误赋值可能不止场景 5（CRITICAL-06 需逐一检查 6 处）
+- 分佣树形遍历无循环检测（不在当前 scope，v2 考量）
+- 店铺软删除无级联检查（v2 考量）
+
+---
+
+## Session Continuity
+
+**Next Action:** Run `/gsd-plan-phase 1` to create detailed plan for Phase 1 (P0 紧急修复)
+
+**Context Files:**
+- `.planning/ROADMAP.md` — 完整路线图和成功标准
+- `.planning/REQUIREMENTS.md` — 46 个 v1 需求（含 Traceability 表）
+- `.planning/PROJECT.md` — 项目背景和约束
+- `.planning/research/SUMMARY.md` — 技术研究和陷阱分析
+- `.sisyphus/plans/修正业务-完整方案.md` — 每个 Bug 的完整修复规格（含代码片段）
+
+---
+*State initialized: 2026-03-27*