feat(套餐真流量预警): AUG26-004 真流量预警规则、达量扫描通知与导出

新增 000228 迁移:规则表 tb_package_traffic_alert_rule(每套餐商品至多一条,无软删除,package_id
非部分唯一约束)、达量预警快照表 tb_package_traffic_alert(以主套餐使用记录 + 阈值快照为唯一键,
触发时冻结用量、额度、比例、阈值、到期时间、归属与资产快照),并为 tb_package_usage 新增扫描
范围部分索引 idx_package_usage_alert_scope;down 在预警表存在数据时阻断回滚。

新增规则维护接口 GET/POST/PUT /api/admin/package-traffic-alert-rules(仅超级管理员与平台账号):
创建校验套餐存在且真流量额度大于零,阈值为 1%~100% 的两位小数;修改只影响后续扫描,不回填也
不改写既有预警快照;全部写操作记录操作者、前后值与时间。

新增每日 06:00(Asia/Shanghai)扫描任务 package:traffic:alert:scan,与套餐临期扫描共用 data_cleanup
队列:按资产汇总当前有效套餐的真流量,分子取使用记录真已用量、分母取使用记录真总量快照,命中
主套餐规则阈值时在同一事务创建预警与可靠通知事件;重复执行以唯一冲突视为已处理,不重复投递,
不建停机锁、不调用运营商。

新增预警列表、详情与异步导出 GET /api/admin/package-traffic-alerts、GET /api/admin/package-traffic-alerts/:id、
POST /api/admin/package-traffic-alerts/export,列表与详情一律读冻结快照;新增通知类型
package.traffic.alert 与受控目标 package_traffic_alert_detail,目标解析仅对超级管理员与平台账号
返回可跳转,越权与不存在统一按资源不可见处理。

同步 OpenAPI(cmd/gendocs、cmd/api/docs.go、pkg/openapi/handlers.go)、审计动作与资源注册、上下文
健康检查证据;归档变更并同步 package-traffic-alert 主 Spec。
This commit is contained in:
2026-09-16 17:05:55 +08:00
parent ef4d3696d4
commit d5bcda94fe
46 changed files with 3679 additions and 100 deletions

View File

@@ -546,6 +546,16 @@ const (
AuditActionPhoneAssetUnbindImportTaskCreated = "phone_asset_unbind_import_task.create"
// AuditActionPhoneAssetUnbindImportTaskCompleted 表示 CSV 解绑导入任务完成。
AuditActionPhoneAssetUnbindImportTaskCompleted = "phone_asset_unbind_import_task.complete"
// AuditActionPackageTrafficAlertRuleCreated 表示创建套餐真流量预警规则。
AuditActionPackageTrafficAlertRuleCreated = "package_traffic_alert_rule.create"
// AuditActionPackageTrafficAlertRuleUpdated 表示修改套餐真流量预警规则阈值或备注。
AuditActionPackageTrafficAlertRuleUpdated = "package_traffic_alert_rule.update"
// AuditActionPackageTrafficAlertRuleEnabled 表示启用套餐真流量预警规则。
AuditActionPackageTrafficAlertRuleEnabled = "package_traffic_alert_rule.enable"
// AuditActionPackageTrafficAlertRuleDisabled 表示停用套餐真流量预警规则。
AuditActionPackageTrafficAlertRuleDisabled = "package_traffic_alert_rule.disable"
// AuditActionPackageTrafficAlertTriggered 表示扫描命中阈值时创建套餐真流量达量预警事实。
AuditActionPackageTrafficAlertTriggered = "package_traffic_alert.trigger"
// AuditActionNotificationDelivered 表示 Outbox 消费后实际生成站内通知。
AuditActionNotificationDelivered = "notification.deliver"
// AuditActionNotificationRead 表示单条通知首次标记已读。
@@ -703,6 +713,10 @@ const (
AuditResourcePhoneAssetAssociation = "phone_asset_association"
// AuditResourcePhoneAssetUnbindImportTask 表示手机号—资产 CSV 解绑导入任务资源。
AuditResourcePhoneAssetUnbindImportTask = "phone_asset_unbind_import_task"
// AuditResourcePackageTrafficAlertRule 表示套餐真流量预警规则资源。
AuditResourcePackageTrafficAlertRule = "package_traffic_alert_rule"
// AuditResourcePackageTrafficAlert 表示套餐真流量达量预警事实资源。
AuditResourcePackageTrafficAlert = "package_traffic_alert"
// AuditResourceNotification 表示站内通知资源。
AuditResourceNotification = "notification"
// AuditResourceNotificationReadBatch 表示通知批量已读资源。
@@ -845,6 +859,10 @@ const (
AuditResourceRoleBusinessUserGroupTarget = "business_user_group_target"
// AuditResourceRoleShopBusinessOwnerBatch 表示店铺负责人批量交接的批次根资源。
AuditResourceRoleShopBusinessOwnerBatch = "shop_business_owner_batch"
// AuditResourceRolePackageTrafficAlertRuleTarget 表示套餐真流量预警规则资源。
AuditResourceRolePackageTrafficAlertRuleTarget = "package_traffic_alert_rule_target"
// AuditResourceRolePackageTrafficAlertTarget 表示套餐真流量达量预警事实资源。
AuditResourceRolePackageTrafficAlertTarget = "package_traffic_alert_target"
// AuditResourceRoleRetentionMonth 表示留存清理目标自然月。
AuditResourceRoleRetentionMonth = "retention_month"
// AuditResourceRoleNotificationTarget 表示本次写操作的通知资源。