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

09 domainCheck 交付打包说明

一、用途

用于在 Windows 本地把当前可交付内容整理成一份压缩包，便于：

• 发给运维或部署同事
• 存档版本快照
• 迁移到 Linux 服务器前做交付留档

二、打包脚本

根目录脚本：

• package_domain_release.ps1
• verify_domain_release.ps1
• prepare_final_release.ps1
• show_latest_release.ps1

执行方式：

powershell -ExecutionPolicy Bypass -File .\package_domain_release.ps1

如需一键完成“打包 + 验包 + 生成最终准备报告”：

powershell -ExecutionPolicy Bypass -File .\prepare_final_release.ps1

如需快速查看当前最新交付物：

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 -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 用于记录最近一次“打包 + 验包”的最终状态。