新增生产一键部署脚本设计文档

This commit is contained in:
wkc
2026-04-01 10:21:35 +08:00
parent 14e72f0e5e
commit 0f9c9b30cd
2 changed files with 321 additions and 0 deletions

View File

@@ -0,0 +1,31 @@
# 生产一键部署脚本设计文档实施记录
## 修改内容
- 新增设计文档 `docs/superpowers/specs/2026-04-01-production-one-click-deploy-design.md`
- 设计文档明确本次交付为单脚本自包含部署方案
- 设计文档明确 Java 路径写在脚本内,发布包从脚本同目录读取
- 设计文档明确旧版后端 `jar` 与旧版前端 `dist` 使用时间戳重命名备份
- 设计文档明确后端启停逻辑、PID 管理、端口校验和失败退出规则
- 设计文档明确交付文件边界与验证范围
## 约束确认
- 已按用户确认采用“方案一:单脚本自包含部署”
- 已按用户确认后端启动参数继续沿用 `--spring.profiles.active=pro --server.port=63310`
- 已按用户确认 Java 路径直接写在脚本内
- 已按用户确认部署逻辑全部写在同一个脚本里
## 评审说明
- 仓库 `AGENTS.md` 明确要求“不开启 subagent”
- 因此本次未执行 brainstorming 技能中的 subagent 评审环节,改为人工自检设计文档是否与已确认约束一致
- 已重点核对以下内容:
- 单脚本边界是否与用户要求一致
- 备份方式是否为“重命名 + 时间戳”
- 发布源是否限定为脚本同目录 zip
- 后端端口与 profile 是否与现有生产约束一致
- 设计中未引入额外兼容、补丁或兜底方案
## 验证结果
- 已检查设计文档保存路径为 `docs/superpowers/specs/2026-04-01-production-one-click-deploy-design.md`
- 已检查本次实施记录保存路径为 `doc/implementation-report-2026-04-01-production-one-click-deploy-design.md`
- 已人工核对设计文档中的方案对比、设计结论、执行流程、启停规则、失败处理、交付物和验证范围
- 本次变更仅新增文档,未修改脚本或代码,因此未执行运行类验证