feat: consolidate legacy workflows into gyxx-flow

2026-07-28 14:51:15 +08:00
commit c23b62a8c8
374 changed files with 132990 additions and 0 deletions
@@ -0,0 +1,39 @@
+# 部署手册
+
+## 环境要求
+
+- 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` 和凭据。禁止在生产任务
+命令中出现旧项目盘符、用户目录解释器或旧项目工作目录。