gyxx-flow/docs/deployment.md

部署手册

环境要求

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

安装

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； 该变量只指向新部署的配置文件。

生成候选调度计划

.\.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 和凭据。禁止在生产任务 命令中出现旧项目盘符、用户目录解释器或旧项目工作目录。