feat: 卡流量改为日快照计量并统一停复机规则
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
卡流量计量(按名单灰度,默认 off): - 新增卡日快照与切换水位表(000241),按通道上游流量重置日换算自然月、重置日防旧值 - 已切换的卡按月对账产生增量,无生效中套餐只结算不发事件;第一次切换写水位 - 已切换卡读数有效即判定通道阈值,卡表本月用量用快照覆盖,日流量读快照 - 配置 JUNHONG_TRAFFIC_CALC_MODE/CARDS、JUNHONG_TRAFFIC_FLOW_SNAPSHOT_ENABLED 停复机规则(总开关 JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED,默认关闭): - 复机不看停机原因,持通道阈值锁仍拒绝;暂停轮询的卡不自动停复机 - 通道新增实名管控 realname_control_enabled(000242,默认 0),开启后不区分行业卡与实名策略 - 实名管控从 0 改 1 需确认,修改并入通道更新审计 OpenSpec Change: rebuild-card-traffic-metering-and-stop-resume
This commit is contained in:
8
migrations/000241_add_card_flow_day_and_switch.down.sql
Normal file
8
migrations/000241_add_card_flow_day_and_switch.down.sql
Normal file
@@ -0,0 +1,8 @@
|
||||
-- 回滚卡日快照与切换水位:删除 tb_card_flow_switch 与 tb_card_flow_day,与 up 严格倒序成对。
|
||||
-- 不可逆说明(ENG-MIG-001 例外条件):快照与切换水位删除后无法由数据库重建;只在计量模式已退回 off、
|
||||
-- 且无需按快照复算或补数据时执行。删除后老算法(卡表基线)照常运行,不受影响。
|
||||
|
||||
DROP INDEX IF EXISTS uk_card_flow_switch_card;
|
||||
DROP TABLE IF EXISTS tb_card_flow_switch;
|
||||
DROP INDEX IF EXISTS uk_card_flow_day_card_date;
|
||||
DROP TABLE IF EXISTS tb_card_flow_day;
|
||||
60
migrations/000241_add_card_flow_day_and_switch.up.sql
Normal file
60
migrations/000241_add_card_flow_day_and_switch.up.sql
Normal file
@@ -0,0 +1,60 @@
|
||||
-- 卡流量计量改为日快照:新增卡日快照表与切换水位表。
|
||||
-- 背景:现有增量按「运营商读数 − tb_iot_card.last_gateway_reading_mb」计算,基线一旦被异常读数抬高
|
||||
-- 就会一直错下去(卡冻结、读数为 0 重复计、二次销售多计)。新算法照搬老卡管:每卡每天一条「本月自然月累计」
|
||||
-- 快照,增量 = 本月最大快照 − 本月已结算合计。详见 docs/卡流量计算技术方案-参考老卡管.md。
|
||||
--
|
||||
-- 设计选择:
|
||||
-- 1. tb_card_flow_day 每卡每天一行,唯一键 (iot_card_id, flow_date),由应用层 INSERT ... ON CONFLICT 原子写入,
|
||||
-- month_used_mb 只增不减;系统写入,不软删、不记 creator/updater,永久保留。
|
||||
-- 2. settled_mb 记录当天已结算增量合计:发出的增量、无生效套餐时丢弃的增量、切换时视为老算法已结算的部分。
|
||||
-- 3. tb_card_flow_switch 每卡一行,卡第一次走新算法时写入;退回老算法时由维护者删除,再次切换时重新写入。
|
||||
-- 4. 不使用数据库外键;iot_card_id 由应用层显式校验(ENG-MODEL-001)。
|
||||
|
||||
CREATE TABLE tb_card_flow_day (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
iot_card_id BIGINT NOT NULL,
|
||||
flow_date DATE NOT NULL,
|
||||
month_used_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
vendor_used_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
settled_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
stale_guarded BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
obs_count INTEGER NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
);
|
||||
|
||||
CREATE UNIQUE INDEX uk_card_flow_day_card_date ON tb_card_flow_day (iot_card_id, flow_date);
|
||||
|
||||
COMMENT ON TABLE tb_card_flow_day IS '卡日流量快照:每卡每天一条本月自然月累计';
|
||||
COMMENT ON COLUMN tb_card_flow_day.iot_card_id IS 'IoT卡ID';
|
||||
COMMENT ON COLUMN tb_card_flow_day.flow_date IS '快照日期(上海时区)';
|
||||
COMMENT ON COLUMN tb_card_flow_day.month_used_mb IS '本月自然月累计流量(MB),按通道上游流量重置日换算,只增不减';
|
||||
COMMENT ON COLUMN tb_card_flow_day.vendor_used_mb IS '当天最后一次有效的运营商原始读数(MB),排障用';
|
||||
COMMENT ON COLUMN tb_card_flow_day.settled_mb IS '当天已结算增量合计(MB)';
|
||||
COMMENT ON COLUMN tb_card_flow_day.stale_guarded IS '重置日当天是否触发过防旧值(读数按 0 记)';
|
||||
COMMENT ON COLUMN tb_card_flow_day.obs_count IS '当天有效观测次数';
|
||||
|
||||
CREATE TABLE tb_card_flow_switch (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
iot_card_id BIGINT NOT NULL,
|
||||
switched_at TIMESTAMPTZ NOT NULL,
|
||||
month_used_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
vendor_used_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
old_baseline_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
old_month_usage_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
old_reading_accepted BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
old_increment_mb NUMERIC(14,3) NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
);
|
||||
|
||||
CREATE UNIQUE INDEX uk_card_flow_switch_card ON tb_card_flow_switch (iot_card_id);
|
||||
|
||||
COMMENT ON TABLE tb_card_flow_switch IS '卡流量计量切换水位:卡第一次走新算法时的衔接点';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.iot_card_id IS 'IoT卡ID';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.switched_at IS '第一次走新算法的观测时刻';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.month_used_mb IS '切换时本月最大快照(MB)';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.vendor_used_mb IS '切换时运营商读数(MB)';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.old_baseline_mb IS '切换时卡表 last_gateway_reading_mb(MB)';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.old_month_usage_mb IS '切换时卡表 current_month_usage_mb(MB)';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.old_reading_accepted IS '切换这次观测基线算法是否接受读数(冻结卡为 false)';
|
||||
COMMENT ON COLUMN tb_card_flow_switch.old_increment_mb IS '切换这次观测基线算法算出的增量(MB)';
|
||||
5
migrations/000242_add_carrier_realname_control.down.sql
Normal file
5
migrations/000242_add_carrier_realname_control.down.sql
Normal file
@@ -0,0 +1,5 @@
|
||||
-- 回滚通道实名管控开关:删除约束与 tb_carrier.realname_control_enabled,与 up 严格倒序成对。
|
||||
-- 不可逆说明(ENG-MIG-001 例外条件):各通道的实名管控配置删除后只能依据 tb_audit_event 中通道更新审计的前后值人工恢复。
|
||||
|
||||
ALTER TABLE tb_carrier DROP CONSTRAINT IF EXISTS ck_carrier_realname_control_enabled;
|
||||
ALTER TABLE tb_carrier DROP COLUMN IF EXISTS realname_control_enabled;
|
||||
12
migrations/000242_add_carrier_realname_control.up.sql
Normal file
12
migrations/000242_add_carrier_realname_control.up.sql
Normal file
@@ -0,0 +1,12 @@
|
||||
-- 通道实名管控开关:tb_carrier 增加 realname_control_enabled。
|
||||
-- 背景:停复机的实名门槛原来默认生效,并与行业卡、卡/设备实名策略耦合,想放开只能逐张改实名策略。
|
||||
-- 新规则(停复机新规则总开关开启后)改为按通道配置:0 不管控(默认),1 管控(未实名停机、实名后才复机)。
|
||||
-- 本列只用于停复机,不复用 realname_link_type 等现有实名字段;存量通道全部为 0,不迁移、不修改任何卡或设备数据。
|
||||
|
||||
ALTER TABLE tb_carrier
|
||||
ADD COLUMN realname_control_enabled SMALLINT NOT NULL DEFAULT 0;
|
||||
|
||||
COMMENT ON COLUMN tb_carrier.realname_control_enabled IS '通道实名管控 0-不管控 1-管控;只在停复机新规则总开关开启后参与停复机判断';
|
||||
|
||||
ALTER TABLE tb_carrier
|
||||
ADD CONSTRAINT ck_carrier_realname_control_enabled CHECK (realname_control_enabled IN (0, 1));
|
||||
Reference in New Issue
Block a user