修复:保护平台订单原始事实不被清理和覆盖

This commit is contained in:
yml2213
2026-11-09 13:20:36 +08:00
parent 9ff9eda3b3
commit 4159a435d5
22 changed files with 429 additions and 267 deletions
@@ -0,0 +1,57 @@
-- 152_order_source_facts_immutable.sql
--
-- 永久保留平台订单事实:
-- 1. 每次来源同步追加完整订单快照,供审计和后续重放;
-- 2. 快照只允许插入,不允许应用更新或删除;
-- 3. orders.raw_payload_json 由应用写入口保证首次写入后不再覆盖。
CREATE TABLE IF NOT EXISTS order_source_snapshots (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES orders(id) ON DELETE RESTRICT,
provider TEXT NOT NULL,
platform TEXT NOT NULL,
shop_id TEXT NOT NULL DEFAULT '',
platform_order_id TEXT NOT NULL,
source_label TEXT NOT NULL DEFAULT '',
payload_json JSONB NOT NULL,
payload_sha256 TEXT NOT NULL,
recorded_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
CONSTRAINT chk_order_source_snapshots_payload_sha256
CHECK (payload_sha256 ~ '^[0-9a-f]{64}$'),
CONSTRAINT uq_order_source_snapshots_payload
UNIQUE (order_id, payload_sha256)
);
CREATE INDEX IF NOT EXISTS idx_order_source_snapshots_order
ON order_source_snapshots(order_id, recorded_at DESC, id DESC);
CREATE INDEX IF NOT EXISTS idx_order_source_snapshots_platform_order
ON order_source_snapshots(provider, platform, platform_order_id, recorded_at DESC);
COMMENT ON TABLE order_source_snapshots IS
'平台订单同步的不可变原始快照;重复同步只追加,不覆盖订单主表原始报文';
COMMENT ON COLUMN order_source_snapshots.payload_json IS
'平台来源事件、原始报文与订单项完整快照';
COMMENT ON COLUMN order_source_snapshots.payload_sha256 IS
'完整快照内容 SHA-256,用于同一订单重复消息幂等';
CREATE OR REPLACE FUNCTION reject_order_source_snapshot_mutation()
RETURNS TRIGGER
LANGUAGE plpgsql
AS $$
BEGIN
IF current_setting('app.allow_order_fact_repair', TRUE) = 'on' THEN
RETURN CASE WHEN TG_OP = 'DELETE' THEN OLD ELSE NEW END;
END IF;
RAISE EXCEPTION 'order_source_snapshots is append-only'
USING ERRCODE = '23514';
END;
$$;
DROP TRIGGER IF EXISTS trg_order_source_snapshots_append_only
ON order_source_snapshots;
CREATE TRIGGER trg_order_source_snapshots_append_only
BEFORE UPDATE OR DELETE ON order_source_snapshots
FOR EACH ROW
EXECUTE FUNCTION reject_order_source_snapshot_mutation();