diff --git a/db_migrations/phase11_trans_outbound_request_link.sql b/db_migrations/phase11_trans_outbound_request_link.sql new file mode 100644 index 0000000..e8170ef --- /dev/null +++ b/db_migrations/phase11_trans_outbound_request_link.sql @@ -0,0 +1,72 @@ +-- ============================================================================= +-- 出库明细补记「来源申请单」,让出库流水能反查回它属于哪张单 +-- +-- 问题 +-- trans_outbound 只有 applicant_id(申请人,见 phase8),没有任何指回 +-- outbound_approval 的外键。出库时 request_id 是**强制必填**的,approval +-- 对象在服务层也一直在手上,但只把 applicant_id 复制过来就丢弃了 —— 于是 +-- 从一条出库明细无法回答「这是哪张申请单出的库」: +-- · 申请单号 request_no 查不到 +-- · 申请说明 / 明细快照 items_json 查不到 +-- · 同一张申请单分几次扫码出库时,这几条明细也串不起来 +-- +-- 本次改动 +-- trans_outbound 新增 request_id,创建出库时从关联审批单带出。 +-- 创建出库时 approval 恒非 None(request_id 已强制必填),故新单据必然有值。 +-- +-- --------------------------------------------------------------------------- +-- ★ 为什么是 request_id(主键)而不是 request_no(单号) +-- 与 phase8 同一个理由:主键没有歧义,单号是业务字段、将来格式可能变。 +-- 要展示单号时 join 一次 outbound_approval 即可。 +-- +-- ★ 为什么不回填存量行 +-- 与 phase8 完全一样:存量出库明细与其来源审批单之间**没有任何可用的关联** +-- (创建时只把审批单状态置为 3,没落任何外键),无从回填。刻意留 NULL 而不是 +-- 按单号/时间猜 —— NULL 表示「这张单产生于本列上线之前」。 +-- +-- ★ 与 applicant_id 的关系 +-- 两者都由 approval 带出,但语义正交:applicant_id 是「人」,request_id 是 +-- 「那张单」。退回补发用前者(挂回真正该拿东西的人),单据追溯用后者。 +-- +-- 幂等:带 IF NOT EXISTS,可重复执行。不含 psql 元命令,DataGrip 可直接执行。 +-- ============================================================================= + +BEGIN; + +ALTER TABLE trans_outbound + ADD COLUMN IF NOT EXISTS request_id integer; + +COMMENT ON COLUMN trans_outbound.request_id IS + '来源出库申请单ID(outbound_approval.id),创建出库时从关联审批单带出。该列上线前的历史行为 NULL(无从回填)'; + +-- 支撑「某张申请单出过哪些明细」的反查,以及按单聚合对账 +CREATE INDEX IF NOT EXISTS ix_trans_outbound_request + ON trans_outbound (request_id); + +COMMIT; + + +-- ============================================================================= +-- 执行后核对 +-- ============================================================================= +SELECT '=== 1) 新列已就位 ===' AS "核对项"; +SELECT column_name, data_type FROM information_schema.columns + WHERE table_name = 'trans_outbound' AND column_name = 'request_id'; + +SELECT '=== 2) 索引已就位 ===' AS "核对项"; +SELECT indexname FROM pg_indexes + WHERE tablename = 'trans_outbound' AND indexname = 'ix_trans_outbound_request'; + +SELECT '=== 3) 存量行应全部为 NULL(历史无从回填)===' AS "核对项"; +SELECT count(*) AS 出库明细总数, + count(request_id) AS 已记录来源单 + FROM trans_outbound; + + +-- ============================================================================= +-- 回滚段 +-- ============================================================================= +-- BEGIN; +-- DROP INDEX IF EXISTS ix_trans_outbound_request; +-- ALTER TABLE trans_outbound DROP COLUMN IF EXISTS request_id; +-- COMMIT; diff --git a/inventory-backend/app/models/outbound.py b/inventory-backend/app/models/outbound.py index f06e591..e9f67bb 100644 --- a/inventory-backend/app/models/outbound.py +++ b/inventory-backend/app/models/outbound.py @@ -148,6 +148,15 @@ class TransOutbound(db.Model): # ⚠ 该列上线前的历史行为 NULL —— 存量出库与其来源审批单之间没有任何可用 # 关联,无从回填;退回时由库管在选择器里明确指定。 applicant_id = db.Column(db.Integer, index=True) + # ★ 来源申请单ID:创建出库时从**关联审批单**带出(出库时 request_id 已强制 + # 必填,approval 恒非 None)。与上面的 applicant_id 语义正交 —— + # applicant_id 是「人」,本列是「那张单」。 + # 为什么要它:原先只落了 applicant_id,从一条出库明细反查不到它属于哪张 + # 申请单(单号 request_no、申请说明、明细快照 items_json 都在申请单上)。 + # ⚠ 该列上线前的历史行为 NULL —— 存量出库与来源审批单之间没有任何可用关联, + # 无从回填。 + # DDL 见 db_migrations/phase11_trans_outbound_request_link.sql + request_id = db.Column(db.Integer, index=True) signature_path = db.Column(db.Text) # 电子签名图片路径 outbound_time = db.Column(db.DateTime, default=beijing_time) operator_name = db.Column(db.String(100)) # 操作员 @@ -179,6 +188,7 @@ class TransOutbound(db.Model): 'returnable_quantity': qty - returned, 'unit_price': float(self.unit_price) if self.unit_price else 0, 'consumer_name': self.consumer_name, + 'request_id': self.request_id, 'signature_path': self.signature_path, 'outbound_time': self.outbound_time.strftime('%Y-%m-%d %H:%M:%S') if self.outbound_time else None, 'operator_name': self.operator_name,