mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-10-01 06:36:38 +08:00
ryan
155 lines
3.3 KiB
Markdown
155 lines
3.3 KiB
Markdown
# 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`
|