dev

docs/09_domainCheck_交付打包说明.md

@@ -0,0 +1,111 @@
+# 09 domainCheck 交付打包说明
+
+## 一、用途
+
+用于在 Windows 本地把当前可交付内容整理成一份压缩包，便于：
+
+- 发给运维或部署同事
+- 存档版本快照
+- 迁移到 Linux 服务器前做交付留档
+
+## 二、打包脚本
+
+根目录脚本：
+
+- `package_domain_release.ps1`
+- `verify_domain_release.ps1`
+- `prepare_final_release.ps1`
+- `show_latest_release.ps1`
+
+执行方式：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\package_domain_release.ps1
+```
+
+如需一键完成“打包 + 验包 + 生成最终准备报告”：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\prepare_final_release.ps1
+```
+
+如需快速查看当前最新交付物：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\show_latest_release.ps1
+```
+
+## 三、输出位置
+
+打包后会生成：
+
+- `release/domaincheck_release_时间戳/`
+- `release/domaincheck_release_时间戳.zip`
+- `release/domaincheck_release_时间戳.sha256.txt`
+- `release/latest_release.txt`
+- `release/latest_release.json`
+- `release/final_release_report.json`
+
+## 四、当前会包含的内容
+
+- `docs/`
+- `scripts/`
+- `domain-api/`
+  - `app`
+  - `deploy`
+  - `README.md`
+  - `requirements.txt`
+  - `.env.example`
+- `domain-web/`
+  - `src`
+  - `deploy`
+  - `README.md`
+  - `package.json`
+  - `package-lock.json`
+  - `tsconfig`
+  - `vite.config.ts`
+  - `.env.example`
+  - `.env.production.example`
+  - 若存在则带上 `dist`
+
+同时会生成：
+
+- `release_manifest.json`
+- `README_RELEASE.txt`
+- `smoke_test_report.json`
+  - 若打包时本机 Web/API 正常运行，则自动生成并随包带出
+- `.sha256.txt`
+  - 用于校验 zip 交付包完整性
+
+## 五、建议使用顺序
+
+1. 先阅读 `docs/08_domainCheck_交付说明.md`
+2. 查看 `release_manifest.json`
+3. 查看 `smoke_test_report.json`
+4. 核对 `.sha256.txt`
+   或执行：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\verify_domain_release.ps1
+```
+
+5. Windows 联调先跑 `scripts/smoke_test_stack.ps1`
+6. Linux 部署前阅读：
+   - `docs/05_domainCheck_Linux部署清单.md`
+   - `docs/07_domainCheck_WebLinux发布验收清单.md`
+   - `domain-api/deploy/linux/README.md`
+
+## 六、说明
+
+当前打包内容偏向“交付部署包”和“源代码归档包”，不包含：
+
+- `node_modules`
+- Python 虚拟环境
+- 临时运行日志
+- 数据库数据本体
+
+这样更适合交付、存档和迁移。
+
+`latest_release.txt / latest_release.json` 用于快速定位“当前最新一份交付包”，避免人工翻目录。
+
+`final_release_report.json` 用于记录最近一次“打包 + 验包”的最终状态。