grid_skeleton/docs/MICRO_GRID_ROADMAP.md

微网格控制迭代计划

本文基于《MICRO_GRID_CONTROL.md》的框架，给出可执行的开发排期。规划按 4 个迭代（Sprint）展开，每个迭代 2 周，可根据团队节奏微调。

---

0. 角色与基本约定

• 负责人划分
  • Core Strat：策略逻辑（库存、PI、费用拨盘）负责人。
  • Infra/DevOps：指标、监控、部署及性能。
  • Risk：风控限额、kill-switch 联动。
  • QA/Sandbox：仿真、演练、回归。
• 环境划分：dev（仿真/回放）、sandbox（低资金实盘）、prod。
• 交付检查：每个迭代结束前完成 checklist + Demo。

---

Milestone 总览

里程碑 (Sprint)	时间 (示例)	主要负责人	范围	关键交付	验收要点
M1 – Telemetry 基线	Sprint 1	Infra, QA	T1 指标采集与监控	Prometheus + Grafana, 指标 API, 报警规则	指标齐全、报警生效、日志无异常
M2 – 核心闭环上线	Sprint 2	Core Strat, QA	T2 库存闭环 + T3 成交率 PI	库存偏置器、PI 控制器、仿真脚本	δ、fills/min 自动收敛，无震荡
M3 – 结构/费用调节	Sprint 3	Core Strat, Infra	T4 簿内跟随 + T5 费用拨盘	深度采样器、费用模型、参数面板	深度变化响应、费用拨盘记录完整
M4 – 稳定性收尾	Sprint 4	Infra, Risk	T6 队列退避 + T7 Kill-switch	队列管理、退避策略、安全阈值	队列拥堵可自调、kill-switch 演练通过

---

Sprint 1：Telemetry 基线（M1）

目标：建立监控与指标体系，为后续闭环提供数据支撑。
时长：2 周。

工作拆分

1. 指标聚合模块（Infra）
   • 集成 fills/min、maker_ratio、δ、S、depth₁₋₃、queue_position、cancel_latency。
   • 支持窗口配置与热更新。
2. Prometheus Exporter & Grafana（Infra）
   • 暴露指标端点，编写 Prometheus job。
   • 制作基本仪表盘（库存、成交、延迟、费用等）。
3. 报警规则配置（Infra + Risk）
   • 根据阈值建立 Alertmanager 触发条件。
4. 验证与文档（QA）
   • 10 分钟本地测试，记录验证报告。

验收 Checklist

• Prometheus 可抓取所有指标，Grafana 面板无空白。
• 指标计算无异常日志，窗口配置可动态调整。
• 至少 3 条报警（库存、成交率、API 错误）可触发并正确通知。
• 更新 README/操作手册，说明指标含义与 Grafana 入口。

---

Sprint 2：核心闭环上线（M2）

目标：实现库存闭环和成交率 PI 控制，初步实现自动化调节。
时长：2 周。

工作拆分

1. 库存闭环执行器（Core Strat）
   • 偏仓检测、价格/数量偏置、taker 对冲钩子。
   • 配置项与安全限额。
2. 成交率 PI 控制器（Core Strat）
   • 滑窗统计、PI 输出、Anti-windup、防抖逻辑。
   • 与库存闭环兼容。
3. 仿真脚本 & 回放（QA/Sandbox）
   • 构建 2 段历史行情（常规 vs 剧烈），记录 δ 与 fills/min 收敛曲线。
4. 沙盒演练（QA）
   • 低资金运行 ≥12h，验证闭环动作。

验收 Checklist

• 仿真中 δ ≦ 1.5% 且能自动回归，fills/min 偏差 <10%。
• 控制器输出日志清晰，可追踪每次调节。
• 沙盒演练完成并形成报告（含异常情况与调参建议）。
• 风险模块确认 taker 对冲限额满足要求。

---

Sprint 3：簿结构 & 费用调节（M3）

目标：引入深度驱动的调节与费用拨盘，提升做市效率。
时长：2 周。

工作拆分

1. 深度采样与数量调节（Core Strat）
   • 采样 1–3 档结构，设计深度不足/过度的调节策略。
   • 与库存闭环在权重上协调。
2. 费用拨盘模块（Core Strat + Infra）
   • 统一处理返佣、手续费、资金费率。
   • 输出建议 f* 与刷新节奏 τ。
3. 费用与深度监控面板（Infra）
   • Grafana 增加深度、费用相关面板。
4. 仿真 & 沙盒验证（QA）
   • 验证深度变化、新费用状况下的策略调整。

验收 Checklist

• 深度偏差能在 2 个周期内触发 ΔP/Q 调整，并记录日志。
• 费用拨盘对不同费用场景输出正确动作（tighten/loosen）。
• 面板中可观察深度与费用指标，报警覆盖。
• 沙盒运行至少 24h，无明显震荡或异常。

---

Sprint 4：稳定性护栏（M4）

目标：完成队列退避、Kill-switch 及整体演练，准备投产。
时长：2 周。

工作拆分

1. 队列位置采集与退避策略（Infra + Core Strat）
   • 采集/估算队列排名与替换率。
   • 设计队列拥堵时的上移/退避动作。
2. Kill-switch & 安全阈值（Risk + Core Strat）
   • 设置自成交、滑点、API 错误等阈值动作，与风险系统集成。
3. 稳定性演练（QA/Sandbox）
   • 模拟交易所限速、网络抖动、自成交异常等。
4. 性能 & 资源评估（Infra）
   • 确认控制循环 CPU、内存开销；记录优化建议。

验收 Checklist

• 队列拥堵时自动上移/拉宽并有退避日志，rate limiter 命中率可控。
• Kill-switch 演练成功（含演练记录与回滚流程）。
• 稳定性测试报告：列出发现问题与优化项。
• 完成上线前检查（代码 Review、配置、监控、回滚方案）。

---

后续持续化工作（Post-M4）

• 多标的扩展：多币对共享库存限额、跨标的风险协调。
• 策略协同：与 scalper/mm 策略的资源隔离与冲突处理。
• 参数自学习：利用回测数据优化 Kp/Ki、偏置参数。
• 自动回滚/灰度：引入自动化灰度部署与回滚脚本。
• 文档与培训：编写操作手册，举办内部分享确保策略理解一致。

---

附：执行日历（示例）

周次	主要事项
Week 1	Sprint 1 启动、指标模块开发、Prometheus 接入
Week 2	Grafana 面板、报警调试、M1 验收
Week 3	库存闭环开发、PI 控制器开发
Week 4	仿真 & 沙盒演练、M2 Demo
Week 5	深度采样与费用拨盘开发
Week 6	费用面板、沙盒回归、M3 验收
Week 7	队列退避、Kill-switch 集成
Week 8	稳定性演练、性能评估、M4 验收

若团队人力有限，可将 Sprint 周期延长或将 M3/M4 合并；关键在于确保各闭环功能上线前均经历指标验证与演练。

---

如需调整上述计划，请在 PR 或 Issue 中记录变更原因与影响范围，并同步更新本文。