break
d5bcda94fe
新增 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。
29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
## Scope
|
||
|
||
- 迭代编号：`AUG26-004`。
|
||
|
||
## Why
|
||
|
||
运营需要在套餐真实流量达量时通知资产所属店铺的有效业务员；现有套餐和通知能力没有规则、去重预警事实或可导出的触发快照。
|
||
|
||
## What Changes
|
||
|
||
- 为每个套餐商品维护至多一条 1%～100% 真流量预警规则；规则变更只影响后续扫描，既有预警冻结快照。
|
||
- 扫描同一资产全部当前有效套餐的真流量汇总，分子取使用记录真已用量、分母取使用记录真总量快照，以实际消耗流量的套餐记录关联资产和主套餐规则判断达量；不读取虚流量、展示量、卡级累计或运营商通道累计值。
|
||
- 为同一套餐使用记录和阈值快照仅建一条预警，事务内同时写可靠通知事件，通知当时有效业务员，并提供权限受控列表与异步导出。
|
||
- 预警与运营商通道阈值严格分离：不建停机锁、不调用运营商、不做停复机。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
- `package-traffic-alert`: 真流量规则、预警事实、通知和导出。
|
||
|
||
### Modified Capabilities
|
||
|
||
- 无。既有套餐状态与通知接收人隔离规则保持不变。
|
||
|
||
## Impact
|
||
|
||
影响套餐配置、套餐使用/流量扫描任务、资产投影、通知事件、导出、审计和新增 Schema。
|