docs(dispatch): 明确排车发布余位与直接装车确认规则

2026-10-21 18:50:57 +08:00
parent b781548e8c
commit 94faf0f017
2 changed files with 10 additions and 4 deletions
@@ -6,6 +6,8 @@

 ## 一 用户已确认的业务目标

+2026-10-21 新增内部散板需求发布选项：新建排车默认勾选“发布公共散板需求”，可在维护车辆信息时修改；按车与新建/编辑命令同事务持久化。对派送排车的候选、满载退出及未知容量口径统一见[内部散板需求池当前范围](内部拼车需求池首版开发契约.md#当前页面范围2026-10-21)，不改变排车审核、实际拣货、装车照片或发车流程。
+
 1. 2026-10-21 用户最新确认：排车列表恢复装车前、装车中、装车后、派送中、派送完成五个作业阶段。装车中可同步上传资料；确认装车完成且资料齐全才进入派送中。装完但资料未齐留在装车后，资料先齐则确认装车时直接派送；此规则替代同日此前“装完即发车”的确认。
 2. 一张排车单就是一趟车，允许同车多个客户、多个目的仓；各票货物、库存、单据和费用必须保留真实客户归属。
 3. 装车前包含车辆信息、调度审核、理货员审核；维护车辆信息后提交调度审核，再经理货员审核进入装车中。2026-10-21 用户确认审核链：客服在最初的车辆信息入口维护并提交，不新增独立客服审批级别；调度或理货员任一环节驳回均须填写原因，并统一回车辆信息／客服处理分区，离开待审队列。客服处理期间保留驳回环节、原因和原审核记录，编辑不抹除原因；重新提交开启新轮次，必须重新经过调度及理货审核，不复用旧批准。理货审核允许 Admin 或绑定仓 PDA 操作，两端共用版本、幂等和审核依据；通过前不得真实拣货，通过后才进入装车中。
@@ -127,7 +129,7 @@
 | 事项 | 确定规则 | 决策影响 |
 | --- | --- | --- |
 | 临时外配取证 | 建单人补齐本趟车辆容量、司机证照和预计任务结束，由调度审核核实；空单可先保存，审核前补齐 | 临时输入、证据上传、资格快照及审核必填；不自动建车辆或司机主档 |
-| 实际装载核对 | 在确认装车弹框接入既有实载核对，有依据的实际数据自动带出，缺项再确认；保持PDA真实拣货核平前置 | 实载来源/字段/弹框及双端核验；不新增第五个详情页签，不代填拣货箱数 |
+| 实际装载核对 | 确认弹框仅展示已扫托数、箱数并整车一次确认，不要求操作员逐托填写托位、重量、体积；已有实测由服务端带出，未知保留空值且不阻塞装车，保持PDA真实拣货核平前置 | 实载来源/字段/弹框及双端核验；不新增第五个详情页签，不代填拣货箱数 |
 | 零扫码变更 | 保留原排车单号，显式退回装车前，修改后两级审核重提 | 新审核轮次、权限和历史；已经扫码的退装/回库不在本批新增 |
 | 客户直接创建派送 | 本批整车安排仅由平台执行，客户继续查看自己的派送单，移除旧客户直接创建这类派送入口 | 派送后端移除对应Merchant创建写入口；前端任务按第九节更新Client直接消费者，保留本客户读取及合法资料操作 |
 | 换标合托同车 | 同一实托可承载两张换标单的逻辑运输来源并整托同车；各来源真实箱数、客户及扫码归属保留，托盘和实际容量只计一次 | 同车内物理占用共享、跨车排他；候选、整托完整性、扫码归属、实际装载及派送/来源状态的直接契约须一致，不能只放开重复托盘校验 |
@@ -172,7 +174,7 @@

 候选由服务端返回完整选择组及组成版本，使用未被页面筛选截断的事实闭包，兼顾既有整申请规则；前端不按当前可见相同托盘码自行拼组。正式Create/AddCargo保留显式逐来源选择并在服务端复核全组；草稿单来源动作须服务端一次命令原子处理完整组，不能用前端循环多个写请求代替整组一致性。PDA保留逐明细精确扫码，展示明确换标业务号及该来源可拣位置/额度，全部逻辑来源核平后才允许装车；不新增整托一键多次扫码或自动补拣数量。

-LoadingPreview及实际容量按每实托一行，逻辑箱数、来源状态与费用分别按真实归属保留。整托实测重量/体积不复制到每逻辑来源；业务份额只使用实际来源证据，缺少证据保持未知，不按箱数推件数或平均分摊重量。主流程先产出字段级公共骨架及唯一接口设计，前端以实际Java记录对齐；来源贡献的仓库生产者/移动触点及精确DDL由主流程提出，总控核对现有写者后逐文件分配。共享SQL/OpenAPI仍由总控集成，Maven仍由主流程唯一执行；此前普通流程通过结果不覆盖本次新增模型。
+装车确认仅传当前版本、清单摘要与幂等键，服务端按已扫实托去重计算托数（每实托一托），沿已有路线确定卸货站。已有重量、体积保留原实测依据，未知不要求现场重复测量、不填零、不推算；已知货量超出容量仍拦截，未知重量体积不作为可售余量。LoadingPreview及实际容量按每实托一行，逻辑箱数、来源状态与费用分别按真实归属保留。整托实测重量/体积不复制到每逻辑来源；业务份额只使用实际来源证据，缺少证据保持未知，不按箱数推件数或平均分摊重量。主流程先产出字段级公共骨架及唯一接口设计，前端以实际Java记录对齐；来源贡献的仓库生产者/移动触点及精确DDL由主流程提出，总控核对现有写者后逐文件分配。共享SQL/OpenAPI仍由总控集成，Maven仍由主流程唯一执行；此前普通流程通过结果不覆盖本次新增模型。

 来源贡献的直接验证按主流程明确释放的有限边界并行：派送专项唯一新增`lastleg-service/src/test/java/com/baiyue/lastleg/dispatch/service/DispatchItemSourcePersistenceTest.java`，验证冻结贡献、逐明细/客户/位置消费、已消费额度、HOLD合计及事务回滚；该文件移交前主流程确认未创建、未写入。`DispatchItemSourceService`、Repository、Mapper、Entity及公共port仍由主流程唯一维护，派送专项不并修生产；提供者受控输入的组件测试不能代替真实provider与主流程的组合回归，Maven仍只由主流程执行。