[文档] 设计文档V5

docs/development-plan.md

@@ -7,9 +7,8 @@
 * 第一版已完成并稳定运行
 * 第二版已完成并补齐 HTTPS、证书、域名、节点与预览能力
 * 第三版已完成，运维体验优化相关能力已经落地
-* 前端改造已完成，新版管理端已经切换为正式基线
-
-本文件不再维护已完成版本的阶段拆解，只保留当前状态与后续执行原则。
+* 第四版已完成前端细节打磨与 UI 优化，但未单独维护专项计划文档
+* 当前正式进入第五版（0.5.x）开发，目标聚焦 OpenResty 反代与缓存性能优化，以及主配置文件接管
 
 ---
 
@@ -36,18 +35,55 @@
 
 ---
 
-## 3. 当前执行原则
+## 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` 与设置页结构，避免引入新配置中心
+* 主配置文件接管必须和发布链路、回滚链路一起设计，不能只补局部写文件能力
 * 需求不改变边界时，直接按现有模型与结构增量实现
 * 需求改变边界时，先补设计，再补计划，再编码
 
 ---
 
-## 4. 新需求进入条件
+## 7. 新需求进入条件
 
 满足以下任一情况时，才需要新增计划项：