auto-deploy-demo/.trae/specs/nginx-dynamic-routing/checklist.md

1.9 KiB
Raw Blame History

Checklist

Nginx配置模板系统

  • 主配置模板 main.conf.tpl 创建完成,支持变量替换
  • Location配置模板 location.conf.tpl 创建完成支持SPA路由回退
  • 模板变量命名规范,易于理解和维护

Nginx配置管理服务

  • nginxManager.js 服务模块创建完成
  • 配置模板渲染功能正常工作
  • Nginx配置文件读写功能正常工作
  • 配置验证功能nginx -t正确执行
  • Nginx重载功能nginx -s reload正确执行
  • 配置回滚机制在失败时正确触发

环境配置扩展

  • config/index.js 包含所有新增Nginx配置项
  • .env.example 包含新配置项说明文档
  • Nginx可用性检测功能正确判断环境

进程管理服务修改

  • 项目服务正确绑定到127.0.0.1
  • 端口分配逻辑支持内部端口模式
  • Nginx配置更新集成点正确触发

项目服务修改

  • URL生成逻辑输出正确格式{BASE_URL}/project/{id}/
  • 项目创建时Nginx location配置正确生成
  • 项目删除时Nginx配置正确清理
  • 项目启动/停止时Nginx upstream状态正确更新

部署路由修改

  • /api/deploy/:id/start 正确集成Nginx配置更新
  • /api/deploy/:id/stop 正确集成Nginx配置更新
  • Nginx配置状态查询接口正常工作

本地开发模式兼容

  • Nginx环境检测逻辑正确判断安装状态
  • 无Nginx时正确回退到多端口模式
  • 有Nginx时正确使用动态路由模式
  • 模式状态在日志中正确输出

前端适配

  • 项目列表页正确显示新格式URL
  • 项目详情页正确显示新格式URL
  • 访问项目链接正确跳转

集成测试

  • 完整流程:创建项目 → 启动项目 → 访问项目 → 停止项目 → 删除项目
  • Nginx配置变更后项目仍可正常访问
  • 多项目同时运行时路由正确隔离
  • SPA项目路由刷新正常工作