gyxx-flow/docs/rollback.md

回滚手册

单任务回滚

1. 记录失败的新任务名、workflow ID、run_id 和业务日期。
2. 禁用对应 \GYXX\<workflow-id>，保留任务定义和运行证据。
3. 重新启用原计划任务，核对触发时间、账号和旧工作目录仍与基线一致。
4. 检查 state/ops/effects；in_progress 或 ambiguous 必须先做外部对账。
5. 检查 outbox；已 sent 的消息不得重发，failed 只能以同一幂等键 replay。
6. 记录回滚结果和恢复时间，保留新旧日志。

原则

• 一次只切换或回滚一个 workflow。
• 旧任务只禁用/启用，不删除；旧项目在全部观察期完成前保持只读可回滚。
• 不删除新系统数据、run journal、effect receipt 或 outbox 消息。
• 未完成对账时，不允许用直接运行脚本绕过 effect ledger。