Files
shanxia2.0/docs/superpowers/plans/2026-10-30-refresh-calendar-site.md
T

2.1 KiB

三天历史派车补派现场日历

用户确认范围:按派车日期 2026-10-28 至 2026-10-30(含两端),在测试与生产执行。

实现:backend/scripts/refresh_dispatch_calendar_site.py 为运维脚本,显式指定环境文件、租户、日期范围;默认只读预览,--apply 才提交。复用当前服务的山峡/云栋出入库匹配与差量同步。仅命中规则的历史记录开启后续同步;已有自动记录按来源 ID 更新或恢复,失去匹配或来源软删除则软删除自动记录。手工现场、其他租户及范围外来源不变。

一次执行在一个事务内锁定来源和关联记录;失败整体回滚;记录专用 calendar-site-refresh 审计身份。无差异不触碰目标时间。脚本仅供具有数据库访问权限的运维人员使用,不增加 HTTP 入口。

  • 编写预览、三类来源、边界日期、跨租户、手工现场、幂等、更新/软删除/恢复、失败回滚测试并先验证缺失实现。
  • 实现脚本,运行日历及同步回归:106 项通过。
  • 两库预览,核对租户和影响数量。
  • 两库正式执行,重复预览及独立查询验证。

执行结果(2026-10-30):租户 shanxia2.0,测试库新增 0、已有同步不变 1、不匹配跳过 5;生产库新增 15、启用历史来源同步 15、不匹配跳过 1。逐条独立核对复制字段和单据类型、唯一来源关联;执行前后快照比较确认其他原记录未改变。再次预览两库新增/更新/恢复/删除/启用数量全部为 0。

代码复核补充:异常的“关联存在但来源未启用且已失去匹配”在只读预览时即报错,正式执行也整体回滚,相关测试已覆盖。本次实际数据未出现此异常。

追加执行:用户授权仅生产库,派车日期 2026-10-31 至 2026-11-05(含两端),租户 shanxia2.0。新增现场记录 6 条并启用对应来源后续同步,4 条不匹配跳过,无更新/恢复/删除。独立逐条核对字段、单据类型及唯一来源关联,其他原记录保持不变;重复预览无待变更项。未连接或刷新测试库。