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