docs: standardize deployment packaging checks

docs/DECISIONS.md

@@ -56,6 +56,15 @@
 - 外部入口目标为 80/443，80 跳转 HTTPS；实际反向代理产品尚未安装，Nginx/Caddy 在 Phase 1 选定。
 - 测试机目前仅开放/监听 SSH，不能称为已部署环境。
 
+### D-07 统一打包部署和版本核对
+
+- 后续部署禁止依赖逐个文件的 `pscp`/手工覆盖；必须使用保留目录结构的统一归档包或等效同步方案，至少完整包含 `app/`、`components/`、`lib/`、`public/` 和运行配置。
+- 部署包必须携带构建提交号和文件清单；解包后先核对目录、关键源码哈希和提交号，再执行安装与构建。
+- 构建时注入 `NEXT_PUBLIC_BUILD_COMMIT` 或等效版本变量，启动后通过页面版本标识、构建产物和 CSS 资源核对实际提供版本。
+- 重启前后必须确认监听进程的 PID、工作目录、启动命令和 `.next` 构建时间，避免旧进程继续提供旧构建。
+- 部署失败或版本核对不一致时停止切换，不以 HTTP `200` 作为版本生效的唯一证据。
+- 当前 Phase 1 已用版本标识临时验证；统一归档部署脚本、原子切换和自动核对列为后续部署基础设施任务。
+
 ## 2. 尚未固定且不能虚构的事项
 
 | 事项 | 当前处理 | 固定条件 |

docs/EXECUTION_PLAN.md

@@ -49,6 +49,8 @@ Phase 1 当前可在本地继续开发，也可在测试机仅部署官网骨架
 
 最小测试部署已完成：`http://192.168.199.22:3000/` 可访问，部署结果和人工视觉验收清单见 `docs/phase-1-report.md`。当前未配置自动重启、Nginx/Caddy、HTTPS 或生产服务。
 
+部署改进待办：下一次部署改为保留目录结构的统一打包部署，自动携带并核对构建提交号、关键源码哈希、`.next` 构建时间、监听进程工作目录和页面版本标识；禁止再次通过逐个文件传输更新生产/测试站。
+
 ### Phase 2：认证与权益基础
 
 - `P2-01` 建立 User、Session、PlanPolicy、MembershipGrant、QuotaAccount、UsageRecord、VerificationChallenge 和审计迁移。

docs/phase-1-report.md

@@ -187,3 +187,5 @@ npm run start -- -H 0.0.0.0 -p 3000
 - 当前访问地址：[`http://192.168.199.22:3000/`](http://192.168.199.22:3000/)。
 
 浏览器仍需强制刷新后重新截图，确认截图页脚出现 `build 0e46643`。真实 viewport、缩放比例、桌面/移动布局仍未由本执行环境直接测量，继续标记为待验收。
+
+本次旧版本暴露了逐个文件传输的部署风险：后续必须改为保留目录结构的统一打包部署，并在构建、重启和切换后自动核对提交号、源码/构建清单、监听进程工作目录和页面版本标识。该改进已记录为 `DECISIONS.md` 的 D-07 和后续执行待办。