fix(outbound): 补发申请人取原申请人,绝不再回退为库管

问题
----
上一版在库管未指定「补发给谁」时,把补发单申请人回退成了**当前操作人(库管)**。
但补发是**原申请人的需求**,挂到库管名下逻辑不通 —— 那张单会出现在库管的
「我的申请」里,而真正该拿东西的人什么也看不到。

根因
----
trans_outbound 只有 consumer_name(**扫码时前端自由填写**的领用人/客户名,
既不可靠也可能是外部客户),没有任何指回原审批单的关联,所以当时只能退而求其次。

根治
----
一、trans_outbound 新增 applicant_id,**创建出库时从关联审批单带出**
    (request_id 已强制必填、approval 恒非 None,故新单据必然有值)。
    落这一列后,「退回 → 补发」即可自动找回真正的原申请人。
    ⚠ 存量行为 NULL —— 存量出库与其来源审批单之间没有任何可用关联,无从回填。
      刻意留 NULL 而不是按姓名猜(consumer_name 是自由文本,会重名错绑),
      与 dispatch_operator 同一取舍:宁可留空,也不猜。

二、退回接口的申请人优先级改为:
      ① 前端显式指定 reissue_applicant_id
      ② 原出库明细记录的 applicant_id(真实原申请人)
      ③ 都没有 → **报错要求指定**
    ★ 彻底移除「回退为当前操作人」—— 那正是本次要修的逻辑错误。

三、出库列表明细返回 applicant_id,供前端精确预填。

验证(9 项断言全通过)
  · 新单据 → 申请人 = 原申请人(12),绝不是库管(7)
  · 显式指定优先于原申请人
  ★ 历史单据未指定 → 接口拒绝、要求选择「补发给谁」、整笔回滚、
    且**未生成任何挂在库管名下的补发单**
  · 历史单据 + 显式指定 → 正常
  库存与数据零残留。
This commit is contained in:
yueli
2026-09-17 12:07:21 +08:00
parent 05524c988a
commit 0005a689dc
4 changed files with 98 additions and 11 deletions

View File

@ -237,7 +237,11 @@ class OutboundService:
'outbound_type': data.get('outbound_type', 'SALES'),
'signature_path': data.get('signature_path'),
'operator_name': operator_name,
'remark': data.get('remark')
'remark': data.get('remark'),
# ★ 申请人从**关联审批单**带出。落这一列是为了让后续「退回 → 补发」
# 能把补发单挂回真正该拿东西的人名下 —— consumer_name 是自由文本
# (可能是客户名),不能作为依据。
'applicant_id': approval.applicant_id,
}
beijing_tz = timezone(timedelta(hours=8))
@ -835,6 +839,10 @@ class OutboundService:
# ★ 退回额度三件套:前端据此显示「已退 / 可退」并置灰已退满的行
'returned_quantity': returned,
'returnable_quantity': qty - returned,
# ★ 原申请人ID:退回弹窗勾选「需要补发」时据此**精确预填**「补发给谁」。
# 为 NULL 表示该出库产生于本列上线之前(历史无从回填),
# 前端不预填,由库管在选择器里明确指定。
'applicant_id': d.applicant_id,
'unit_price': price,
'subtotal': subtotal,
'batch_sn': batch_sn,