2.5 KiB
2.5 KiB
派车日历自动同步现场日历
用户已确认按起止地匹配同步，历史记录不补录，开始实施。
规则与边界
- 仅酸、碱、其他日历作为来源；始发地含“山峡”或“云栋”为出库，目的地含任一关键词为入库，两端命中为一条“出入库计划”，均不命中不生成。
- 同步日期、车辆及车牌快照、产品及名称快照、起止地、数量和备注，不联动实际运输单或库存。
- 来源更新时原地更新关联现场记录；失去匹配或来源删除时软删除；重新匹配时恢复原关联行，保持 ID 和创建信息。
- 上线前记录不补录，即使后续编辑也不启用同步。上线后新建的来源即使初始不匹配，也支持后续修改命中。
- 手工现场记录独立维护；自动现场记录只读，提示在来源派车日历维护，后端同时拒绝直接修改/删除。
- 现场卡片将类型以普通文字放在路线末尾，如“山峡 → 芜湖（出库计划）”，不使用 Tag；复制文本保留车牌、产品和数量，隐藏起止地和备注，类型放在每条产品行末尾的中文括号中。
实现选择
采用后端同步事务，所有客户端统一生效。前端分步创建会产生部分成功；异步任务会延迟并增加重试成本，本需求无需引入。
pl_dispatch_calendar 增加内部 site_sync_enabled（默认 0，服务创建新来源显式设 1），以及只读 source_record_id（手工行 NULL）。唯一索引 (tenant_no, source_record_id) 限制每个来源最多一条关联行，包括软删除行。迁移只变更结构，不更新业务记录。
更新和删除先按租户、用户数据范围锁定来源行，再同步关联行并一次提交；任何失败回滚。关联行继承来源创建人和部门以保持数据范围一致。接口只读输出 sourceRecordId，输入禁止伪造关联和开关。
MySQL 死锁错误 1213 回滚后最多尝试三次完整事务，其他错误直接抛出。重试范围不含提交后的查询，避免重放已提交的新增操作。
验收
覆盖三个来源日历、两种关键词、四种匹配情况、重复保存、变更月份/车辆/产品、取消匹配/重新命中、来源删除、手工现场不递归、历史不补录、隔离和事务失败回滚。Web 现场详情显示维护提示并隐藏编辑删除；原手工 CRUD 保持不变。
上线顺序：单据类型迁移 → 同步关联迁移 → 后端和 Web 发布。无需 env 配置及小程序包变更。