# 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`