2026-10-27-child-data-differential-save-design.md 2.2 KB

子数据差量保存与多端身份一致性

用户已在本会话确认全部普通保存改用差量增删改,并要求先修代码、覆盖 Web 与小程序。依据本次测试与生产只读审计实施;不执行历史修复、数据库写入或部署。

保存契约

  • 编辑已有子行保留服务端 ID、创建字段和未参与本次编辑的业务字段;新行才生成 UUID。
  • 子集合缺省/None 表示不修改;显式 [] 表示移除集合,但受引用保护限制。
  • 非当前租户/主单的 ID、重复 ID 不得更新;校验在任何删除/新增前完成。
  • 业务明细有下游引用时禁止移除,返回可理解错误。历史软删关联不在保存时自动重绑。
  • 无独立身份的关系集合按业务键差量处理;重复自然键去重或校验,保持未变关系 ID。
  • Web、移动 H5、小程序编辑加载和提交保留子行 ID;新增/复制去掉来源明细 ID。不得将产品库 ID 误作明细 ID。
  • 报销流程节点按 ID 更新,在途实例依赖现行定义,阻止影响在途流程的定义变更;不在本次引入新流程引擎。
  • 审批新轮次、流程版本快照、明确的单据作废重开保持原业务语义,不变成覆盖历史。

分域范围

物流:装/送货段产品及引用保护、计划及段合同关联、归档品牌、出入库品牌、运输回传及品牌、车辆人员关系;Web/H5 与原生小程序相关提交链路。 CRM:报价产品、合同产品及调价区间,合同引用保护,更新集合缺省语义,多端表单身份与复制。 报销:费用明细、发票关系、流程节点与在途保护,多端费用/流程表单。 系统和值班:用户角色/职位、职位成员同步、角色菜单/自定义权限、值班指定人员,保留抢班及版本历史。

验收

同内容保存两次 ID 不变;修改一行不重建其余行;新增/删除仅影响目标行;缺省集合不清空;非法/重复/越权 ID 原子拒绝;被引用行不删除;创建及归档/回传字段不因普通保存丢失;编辑与复制身份规则覆盖各入口。测试使用内存/模拟数据库,不使用测试或生产业务库进行写入。