-- 卡流量采集队列与全量切换(add-card-traffic-queue-and-observed-deduction)。 -- 1. tb_iot_card 增加"待建起点"标记:带标记的卡第一次通过采集队列写入时,只写快照、把本月最大快照全部记为已结算、 -- 不扣费,然后清标记。全量切换时全部卡置位,避免把卡表基线算法已扣过的本月用量再扣一遍;换卡新卡同样置位。 -- 2. 新增采集记录 tb_card_traffic_collection:采集时刻有套餐的卡每次采集一条(含接口失败、读数为 0、被队列拦下), -- 按 observed_at 按月分区,保留 90 天,过期按整月分区删除(由应用层维护分区)。系统写入,不软删。 -- 3. 不使用数据库外键;iot_card_id 由应用层显式校验(ENG-MODEL-001)。 ALTER TABLE tb_iot_card ADD COLUMN traffic_baseline_pending BOOLEAN NOT NULL DEFAULT FALSE; COMMENT ON COLUMN tb_iot_card.traffic_baseline_pending IS '卡流量待建起点:第一次通过采集队列写入时只建起点不扣费,之后清除'; UPDATE tb_iot_card SET traffic_baseline_pending = TRUE WHERE deleted_at IS NULL; CREATE TABLE tb_card_traffic_collection ( id BIGSERIAL, iot_card_id BIGINT NOT NULL, observed_at TIMESTAMPTZ NOT NULL, observation_id VARCHAR(128) NOT NULL DEFAULT '', source VARCHAR(32) NOT NULL DEFAULT '', scene VARCHAR(64) NOT NULL DEFAULT '', result VARCHAR(32) NOT NULL, vendor_used_mb NUMERIC(14,3), queue_points JSONB, decision VARCHAR(32) NOT NULL DEFAULT '', month_used_mb NUMERIC(14,3), stale_guarded BOOLEAN, delta_mb NUMERIC(14,3), event_id VARCHAR(128) NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), PRIMARY KEY (id, observed_at) ) PARTITION BY RANGE (observed_at); CREATE INDEX idx_card_traffic_collection_card_time ON tb_card_traffic_collection (iot_card_id, observed_at DESC); CREATE INDEX idx_card_traffic_collection_observation ON tb_card_traffic_collection (observation_id); COMMENT ON TABLE tb_card_traffic_collection IS '卡流量采集记录:采集时刻有套餐的卡每次采集一条,按月分区保留 90 天'; COMMENT ON COLUMN tb_card_traffic_collection.observation_id IS '采集 ID,与流量事件、扣费审计串联'; COMMENT ON COLUMN tb_card_traffic_collection.source IS '来源:polling/manual_sync/business_event'; COMMENT ON COLUMN tb_card_traffic_collection.scene IS '场景:traffic_polling/manual_refresh/pre_activation_settlement 等'; COMMENT ON COLUMN tb_card_traffic_collection.result IS '读数结果:ok/failed/rate_limited/invalid_payload/no_reading/invalid_reading'; COMMENT ON COLUMN tb_card_traffic_collection.vendor_used_mb IS '运营商原始读数(MB),没有给值时为空'; COMMENT ON COLUMN tb_card_traffic_collection.queue_points IS '入队后的采集队列(采集时间 + 读数)'; COMMENT ON COLUMN tb_card_traffic_collection.decision IS '写入判断:written/baseline/queue_not_full/slope_negative/out_of_order/settled_existing,读数无效时为空'; COMMENT ON COLUMN tb_card_traffic_collection.month_used_mb IS '写入时换算后的本月累计(MB)'; COMMENT ON COLUMN tb_card_traffic_collection.stale_guarded IS '写入时是否触发重置日防旧值'; COMMENT ON COLUMN tb_card_traffic_collection.delta_mb IS '写入时本次增量(MB)'; COMMENT ON COLUMN tb_card_traffic_collection.event_id IS '写入时的流量事件 ID'; CREATE TABLE tb_card_traffic_collection_202610 PARTITION OF tb_card_traffic_collection FOR VALUES FROM ('2026-10-01 00:00:00+08') TO ('2026-11-01 00:00:00+08'); CREATE TABLE tb_card_traffic_collection_202611 PARTITION OF tb_card_traffic_collection FOR VALUES FROM ('2026-11-01 00:00:00+08') TO ('2026-12-01 00:00:00+08'); CREATE TABLE tb_card_traffic_collection_202612 PARTITION OF tb_card_traffic_collection FOR VALUES FROM ('2026-12-01 00:00:00+08') TO ('2027-01-01 00:00:00+08');