feat: 为现场日历增加单据类型并同步派车记录,减少重复录入。
按起止地关键词生成现场出入库计划,同步来源修改和删除,保留历史记录不补录。调整卡片及复制文本的单据类型格式,并记录测试库和生产库迁移结果。
This commit is contained in:
1 parent
1ae8603045
commit
fcbf8a9b65
17 files changed
+732
-42
No files matched your search
@@ -0,0 +1,28 @@
|
||||
# 派车日历自动同步现场日历
|
||||
|
||||
用户已确认按起止地匹配同步,历史记录不补录,开始实施。
|
||||
|
||||
## 规则与边界
|
||||
|
||||
- 仅酸、碱、其他日历作为来源;始发地含“山峡”或“云栋”为出库,目的地含任一关键词为入库,两端命中为一条“出入库计划”,均不命中不生成。
|
||||
- 同步日期、车辆及车牌快照、产品及名称快照、起止地、数量和备注,不联动实际运输单或库存。
|
||||
- 来源更新时原地更新关联现场记录;失去匹配或来源删除时软删除;重新匹配时恢复原关联行,保持 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 配置及小程序包变更。
|
||||
Reference in new issue
Block a user