feat(finance): 历史订单退款按退款日入账

- 迁移 116 新增 refund_adjustment 渠道值,并允许该类行净收入为负
- 销售事实按退款日聚合 archived 订单的已确认退款,写冲减行
- 退款后同时回填原销售日与退款日的事实与总账
- 退款同时重算相关订单项的费用快照(比例费按净收入)
- 前端渠道筛选与标签支持「历史退款冲减」
This commit is contained in:
yml2213
2026-11-01 14:46:11 +08:00
parent cf0d600c7d
commit 624c0ef4af
7 changed files with 118 additions and 9 deletions
@@ -0,0 +1,39 @@
-- 116_refund_adjustment_facts.sql
--
-- 断代后历史订单仍会退款:这些订单项已 archived、不参与正常销售事实,
-- 需要在「退款发生日」记一笔冲减,否则退款在财务体系里完全丢失。
-- 这里新增事实渠道值 refund_adjustment 承载这类冲减行。
ALTER TABLE sales_daily_facts
DROP CONSTRAINT IF EXISTS chk_sales_daily_facts_fulfillment_mode;
ALTER TABLE sales_daily_facts
DROP CONSTRAINT IF EXISTS chk_sales_daily_facts_channel;
ALTER TABLE sales_daily_facts
ADD CONSTRAINT chk_sales_daily_facts_channel
CHECK (
channel IN (
'work_order', 'affiliate_dash', 'third_party_voucher',
'manual', 'unclassified', 'archived', 'refund_adjustment'
)
);
COMMENT ON COLUMN sales_daily_facts.channel IS
'渠道维度:work_order / affiliate_dash / third_party_voucher / manual / unclassified / archived / refund_adjustment';
-- 退款冲减行允许净收入为负(其余渠道仍要求非负)。
ALTER TABLE sales_daily_facts
DROP CONSTRAINT IF EXISTS chk_sales_daily_facts_amounts;
ALTER TABLE sales_daily_facts
ADD CONSTRAINT chk_sales_daily_facts_amounts
CHECK (
order_count >= 0
AND item_count >= 0
AND quantity >= 0
AND gross_revenue_fen >= 0
AND refund_amount_fen >= 0
AND (net_revenue_fen >= 0 OR channel = 'refund_adjustment')
AND cost_amount_fen >= 0
AND cost_missing_count >= 0
);