-- =============================================================================
-- 出库明细补记「来源申请单」，让出库流水能反查回它属于哪张单
--
-- 问题
--   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;