# 生产一键部署脚本设计文档实施记录

## 修改内容
- 新增设计文档 `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`
- 已人工核对设计文档中的方案对比、设计结论、执行流程、启停规则、失败处理、交付物和验证范围
- 本次变更仅新增文档，未修改脚本或代码，因此未执行运行类验证