重构:统一财务派生数据真源与重建

This commit is contained in:
yml2213
2026-11-08 19:44:27 +08:00
parent bae9a5ae5e
commit f8cbb645fe
14 changed files with 1011 additions and 541 deletions
@@ -0,0 +1,46 @@
-- 167_finance_derived_scope.sql
--
-- 财务派生范围唯一读模型:
-- 1. 只纳入 pending / assigned 履约项;
-- 2. 只纳入 paid / refunded 商业订单;
-- 3. 收入、退款、商品、渠道和业务日一次算清;
-- 4. 销售事实、重建和审计共用该视图,禁止各自拼口径。
CREATE OR REPLACE VIEW v_finance_order_item_scope AS
WITH refunded AS (
SELECT
refund.order_item_id,
SUM(refund.amount_fen)::bigint AS refund_fen
FROM order_refunds refund
WHERE refund.status = 'confirmed'
GROUP BY refund.order_item_id
)
SELECT
item.id AS order_item_id,
item.order_id,
(COALESCE(order_record.paid_at, order_record.created_at)
AT TIME ZONE 'Asia/Shanghai')::date AS stat_date,
COALESCE(order_record.paid_at, order_record.created_at) AS basis_at,
order_record.provider,
order_record.shop_id,
fulfillment.canonical_product_id,
CASE
WHEN fulfillment.status = 'pending' OR fulfillment.channel IS NULL THEN 'unclassified'
ELSE fulfillment.channel
END AS channel,
GREATEST(COALESCE(item.normalized_quantity, item.quantity, 1), 1)::numeric AS quantity,
GREATEST(COALESCE(item.revenue_amount_fen, 0), 0)::bigint AS revenue_fen,
GREATEST(COALESCE(refunded.refund_fen, 0), 0)::bigint AS refund_fen
FROM fulfillments fulfillment
JOIN order_items item ON item.id = fulfillment.order_item_id
JOIN orders order_record ON order_record.id = fulfillment.order_id
LEFT JOIN refunded ON refunded.order_item_id = item.id
WHERE fulfillment.status IN ('pending', 'assigned')
AND order_record.pay_status IN ('paid', 'refunded');
COMMENT ON VIEW v_finance_order_item_scope IS
'财务销售范围唯一读模型:收入、退款、商品、渠道和业务日统一从履约真源与商业订单计算';
CREATE INDEX IF NOT EXISTS idx_finance_entries_sales_fact_day
ON finance_journal_entries (occurred_at)
WHERE ref_type = 'sales_fact';