# 部署手册

## 环境要求

- Windows 10/11 或 Windows Server，系统时区 `China Standard Time`
- Python 3.12、`uv`、Windows Task Scheduler
- 凭据由环境变量或外部密钥系统提供，不写入源码或清单

## 安装

```powershell
cd D:\gyxx-flow
uv sync --python 3.12 --extra test
$env:GYXX_DATA_ROOT = 'D:\gyxx-flow\var'
.\.venv\Scripts\python.exe -m gyxx_flow doctor --json
.\.venv\Scripts\python.exe -m pytest
```

不再配置任何 `GYXX_LEGACY_*_ROOT`。运行代码和资源随 `gyxx_flow` 包部署，
四个旧项目可以不挂载。商品模块需要独立配置时，可设置 `GYXX_PRODUCT_CONFIG`；
该变量只指向新部署的配置文件。

## 生成候选调度计划

```powershell
.\.venv\Scripts\python.exe -m gyxx_flow schedule plan `
  --output D:\gyxx-flow\var\schedule-plan\candidate `
  --start-date 2026-07-27 `
  --python-executable D:\gyxx-flow\.venv\Scripts\python.exe
```

输出包含 21 个 XML、`install.ps1`、`plan.json` 和 `drift.json`。生成计划不会
注册任务。只有生产门禁通过并获得明确授权后，才能人工审阅并逐个使用
`install.ps1 -Apply -WorkflowId <id>`；安装器强制一次只处理一个任务。

## 可迁移部署

复制项目或安装 wheel 后，只需重新设置 `GYXX_DATA_ROOT` 和凭据。禁止在生产任务
命令中出现旧项目盘符、用户目录解释器或旧项目工作目录。