OpenFlare/docs/development-plan.md

# ATSFlare 开发计划

## 1. 当前阶段

当前结论：

* 第一版已完成并稳定运行
* 第二版已完成并补齐 HTTPS、证书、域名、节点与预览能力
* 第三版已完成，运维体验优化相关能力已经落地
* 第四版已完成前端细节打磨与 UI 优化，但未单独维护专项计划文档
* 当前正式进入第五版（0.5.x）开发，目标聚焦 OpenResty 反代与缓存性能优化，以及主配置文件接管

---

## 2. 已完成范围归档

### 2.1 已完成能力

* 规则管理、配置发布、激活、回滚
* Agent 注册、心跳、同步、应用、回滚
* HTTPS/TLS 路由、证书托管、域名管理
* 节点管理、专属 `agent_token`、全局 `discovery_token`
* 配置预览、变更摘要、自定义请求头
* 运维设置热更新
* Server 下发 Agent 运行参数
* Agent 自我更新与一键部署
* Server 版本检查与自升级
* 新版前端工程、主题切换与统一页面框架

### 2.2 归档原则

* 已完成阶段的实现细节以代码与 Git 历史为准
* 不再为已完成工作维护过程性计划、迁移步骤或分阶段验收清单
* 新的大功能阶段启动前，再补充新的计划文档

---

## 3. 第五版目标

第五版主目标：

* 提升 OpenResty 在当前反代链路下的连接、缓冲、超时、压缩与缓存性能
* 由 Server 统一托管 OpenResty 主配置文件，Agent 不再依赖节点手工维护主配置
* 所有新增优化项都进入 Server 统一配置面，由管理端维护、版本发布、Agent 拉取与应用

第五版不做：

* 平台化缓存产品、Purge 系统、分层缓存、节点差异化缓存策略
* 任意文本片段注入、任意 OpenResty 指令执行、节点侧自定义模板合并
* 绕过占位符约束的主配置模板直写
* 引入 Redis、Prometheus、消息队列等新基础设施作为第五版前置条件

## 4. 第五版实施顺序

建议按以下顺序推进：

1. 补齐 Server 侧 OpenResty 性能参数模型、默认值、校验规则与性能页入口，并补充主配置模板编辑能力
2. 扩展配置渲染结果，使版本快照覆盖主配置文件与路由配置文件
3. 调整 Agent 本地应用链路，支持主配置写入、校验、reload、失败回滚
4. 补齐预览、diff、应用结果与日志，确保第五版能力可观测
5. 以本机 OpenResty 与 Docker OpenResty 两种模式完成联调和回归

## 5. 第五版验收标准

完成第五版时至少满足：

* 管理端可以查看并修改第一批 OpenResty 性能优化项
* 管理端提供独立“性能”页面，支持结构化设置与主配置模板编辑/预览
* 性能优化项保存后进入统一发布链路，而不是节点即时生效
* Agent 可以接管主配置文件，并在 `openresty -t` 失败时完整回滚
* 配置预览或 diff 能体现主配置与关键性能参数变化
* 本机模式与 Docker 模式都能完成一次成功发布和一次失败回滚验证
* 所有优化选项都由 Server 统一管理，不存在节点侧独立真相源

## 6. 当前执行原则

第五版执行时遵循：

* 先遵守 `docs/design.md` 的系统边界
* 再遵守 `docs/development-guidelines.md` 与 `docs/frontend-development-guidelines.md`
* OpenResty 优化参数优先复用现有 `Option` 与设置页结构，避免引入新配置中心
* 主配置文件接管必须和发布链路、回滚链路一起设计，不能只补局部写文件能力
* 需求不改变边界时，直接按现有模型与结构增量实现
* 需求改变边界时，先补设计，再补计划，再编码

---

## 7. 新需求进入条件

满足以下任一情况时，才需要新增计划项：

* 引入新的核心业务对象或系统边界
* 引入新的基础设施依赖
* 调整部署模式或运行方式
* 大规模重构前后端主干结构

否则默认按常规开发任务处理，不再单独维护阶段计划。