📝 运次收口注释只陈述当前事实

去掉「判据是 X 而不是 Y」「两段必须同时切否则」「缺省就等于把别人的运次发出去」这类推理与改删史表述，只留当前判据与行为。
2026-10-27 22:15:32 +08:00
parent bd97b88054
commit 64ed3d476d
2 changed files with 5 additions and 8 deletions
@@ -35,10 +35,9 @@ import java.util.Set;
 * 运次查询条件
 * <p>
 * 司机端用 {@link #forDriver(Long)} 按司机档案 ID 收口；管理端用 {@link #forAdmin()} 不按司机收口。
- * 两者都不给时收口为空集——收口一旦缺省就等于把别人的运次发出去，故缺省不放行。
+ * 两者都不给时收口为空集。
 * <p>
- * 判据是司机档案 ID 而不是手机号：手机号在配载单/运单上只是派单时的快照，司机换号后并不跟随，
- * 按号收口会让改过号的司机看不到自己手上的运次，号码被回收给别人时还会反向串号。
+ * 归属判据只有司机档案 ID；driver_phone 是派单时的号码快照，不参与判定。
 */
@Data
@Schema(description = "运次查询条件")
@@ -389,12 +389,10 @@ public class TripQueryServiceImpl implements ITripQueryService {
 	}

 	/**
-	 * 运次可见范围：配载段按配载单的司机档案 ID 收口，未配载段按运单的司机档案 ID 收口。
+	 * 运次可见范围：已配载段按配载单的 driver_id 收口，未配载段按运单的 driver_id 收口。
 	 * <p>
-	 * 判据是司机档案 ID 而不是手机号：司机换号后档案 ID 不变，而派单时落在配载单/运单上的手机号
-	 * 是快照，按号收口会让改过号的司机看不到自己手上的运次；号码被回收给别人时又会反向串号。
-	 * 两段必须同时切：只切一段，另一段就会把不属于该司机的运次放进来。
-	 * 缺省收口（空、0、负数）不放行，由 {@link #scoped} 在外层挡掉。
+	 * 归属判据只有司机档案 ID（null 或非正数视为无主），driver_phone 不参与判定。
+	 * 无主的运次由 {@link #scoped} 在外层挡掉。
 	 */
 	private void applyScope(LambdaQueryWrapper<Waybill> wrapper, TripQueryVO condition) {
 		if (condition.isAllDrivers()) {