♻️ 待回单确认：注释改为陈述事实

2026-10-22 14:47:33 +08:00
parent b4c1ad03e1
commit 6673ed38f3
2 changed files with 7 additions and 7 deletions
@@ -124,8 +124,8 @@ public class DriverWaybillServiceImpl implements IDriverWaybillService {
 		WaybillProcessSupport.STATUS_PENDING_RETURN_CONFIRM, STATUS_COMPLETED
 	);
 	/**
-	 * 进行中口径：司机手上还没走完的单。
-	 * 待回单确认也算进行中——司机侧已打完末位卡，等业务员确认回单才变已完成。
+	 * 进行中口径：司机手上还没走完的单，含待回单确认。
+	 * 待回单确认指司机已打完末位卡、等业务员确认回单，此时业务状态还不是 completed。
 	 */
 	private static final List<String> ACTIVE_STATUSES = Arrays.asList(
 		STATUS_RUNNING, STATUS_PENDING, STATUS_WAITING_DISPATCH, STATUS_DISPATCHING,
@@ -525,9 +525,9 @@ public class DriverWaybillServiceImpl implements IDriverWaybillService {
 		nodePunchMapper.insert(punch);

 		advanceCurrentProcessNode(waybill, nodeCfg);
-		// 末位打卡节点是到货/卸货/签收、且运单本身允许完成时，本次打卡就是运单的去向决定点：
-		// 回单无需确认 → 一并完成；回单需业务员确认 → 停在待回单确认等业务员确认。
-		// isLastDriverPunchNode 与 returnNeedsNoConfirmation 传的就是上面那份 processJson，未再调 resolveProcessJson 取过程配置。
+		// 末位打卡节点为到货/卸货/签收、且运单允许完成时：回单无需确认则本次打卡一并完成运单，
+		// 回单需业务员确认则停在待回单确认。
+		// isLastDriverPunchNode 与 returnNeedsNoConfirmation 传的是上面那份 processJson，未再调 resolveProcessJson 取过程配置。
 		String nodeKey = WaybillProcessSupport.nodeKey(nodeCfg);
 		String nodeName = WaybillProcessSupport.nodeName(nodeCfg);
 		String waybillBusinessStatus = waybill.getBusinessStatus();
@@ -996,8 +996,8 @@ public class ManageWaybillServiceImpl implements IManageWaybillService {
 		}
 		return switch (businessStatus) {
 			case STATUS_PENDING, "waiting_dispatch", "dispatching" -> 0;
-			// 与司机端 toAppStatus 同一份数字枚举（0 待接单 / 1 运输中 / 2 已完成 / 3 已取消），待回单确认属进行中：
-			// 两处对同一状态必须给同一个数字，给 null 前端只能落到「未知」兜底
+			// 数字枚举与司机端 toAppStatus 同源：0 待接单 / 1 运输中 / 2 已完成 / 3 已取消；
+			// 待回单确认属进行中，落 1。给 null 时前端显示「未知」。
 			case STATUS_RUNNING, WaybillProcessSupport.STATUS_PENDING_RETURN_CONFIRM -> 1;
 			case STATUS_COMPLETED -> 2;
 			case STATUS_CANCELLED -> 3;