OpenFlare/docs/development-plan.md

ATSFlare 开发计划（V3 准备版）

1. 当前状态

当前结论：

• 第一版已完成并稳定闭环
• 第二版已完成并补齐 HTTPS、证书、域名、节点管理与预览能力
• 下一步进入第三版准备阶段

本文件不再展开第一版、第二版的详细实施步骤，只保留第三版启动前的计划骨架与准入条件。

---

2. 已完成能力归档

2.1 第一版归档

已完成：

• 规则管理
• 配置发布与激活
• Agent 心跳、同步、应用、回滚
• 节点状态与应用记录展示

2.2 第二版归档

已完成：

• HTTPS/TLS 路由支持
• 证书托管与导入
• 域名管理与证书自动匹配
• 节点管理、专属 agent_token、全局 discovery_token
• 路由自定义请求头
• 配置预览与变更摘要

归档原则：

• 已完成阶段的实现细节以代码和 Git 历史为准
• 后续计划文档只维护当前阶段与下一阶段

---

3. 第三版启动前置条件

第三版正式立项前，必须先明确以下内容：

1. 目标问题与业务价值
2. 范围边界与明确不做项
3. 涉及的核心对象与 API 变化
4. 对发布链路、Agent 链路、部署方式的影响
5. 验收标准与回归范围

未满足以上条件时，不进入第三版编码阶段。

---

4. 第三版建议执行骨架

在第三版范围明确后，按以下顺序推进：

Phase A：设计冻结

交付：

• 更新后的 docs/design.md
• 更新后的 docs/development-guidelines.md
• 明确的验收标准

完成标准：

• 第三版目标、范围、对象变化、兼容策略写清楚

Phase B：后端主链路

交付：

• 数据模型变更
• API 变更
• 服务层逻辑与测试

完成标准：

• Server 侧主链路可独立验证

Phase C：Agent / 前端配套

交付：

• Agent 适配改动
• 前端页面或交互改动
• 必要的回归测试

完成标准：

• 控制面、Agent、页面链路联通

Phase D：联调与收尾

交付：

• 联调记录
• 部署文档更新
• 遗留问题清单

完成标准：

• 新能力可按部署文档落地验证

---

5. 第三版期间禁止事项

在第三版需求未明确前，不提前开始以下工作：

• 引入 Redis、MQ、对象存储等新基础设施
• 实现节点分组与差异化发布
• 实现灰度百分比发布
• 引入多租户模型
• 对现有前端进行无业务价值的大重构

如果第三版确认需要以上能力，先改文档，再调整计划。

---

6. 第三版验收门槛模板

第三版正式验收时，至少检查：

• 设计文档与实现一致
• 新增 API 与数据模型有测试覆盖
• 发布链路未被破坏
• Agent 同步与回滚链路未被破坏
• 现有节点接入方式兼容或有明确迁移方案
• 部署文档已同步更新

---

7. 变更控制

第三版开发中，出现以下情况必须先改文档再继续：

• 目标问题变化
• 核心数据模型变化
• 部署方式变化
• 需要引入新的中间件或基础设施
• 需要突破当前系统边界

同步更新清单：

• docs/design.md
• docs/development-guidelines.md
• docs/development-plan.md
• docs/deployment.md