Files
one-pipe-system/openspec/changes/add-carrier-traffic-threshold-hit-query/design.md
luo 5364916b1d
All checks were successful
构建并部署前端到测试环境 / deploy (push) Successful in 54s
fix: 运营商管理
2026-09-29 09:15:05 +08:00

23 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Context
现有前端没有运营商通道阈值命中记录页面或对应 API 类型。后端已提供只读分页查询接口,页面需忠实呈现不可变的命中时快照和周期恢复状态。
## Goals / Non-Goals
- Goals: 提供受限于平台账号的筛选、分页和证据查询;不丢失空值的历史语义。
- Non-Goals: 修改通道阈值、发起停复机、导出记录、查看卡片详情,或查询上游响应。
## Decisions
- Decision: 在系统管理路径下新增独立隐藏查询页,由运营商管理页提供入口;路由使用 `allowedUserTypes: [1, 2]`,页面自身也在请求前检查平台账号。
- Rationale: 接口只允许超级管理员和平台账号。前端隐藏/保护页面入口,后端仍是最终授权及卡数据范围过滤边界。
- Decision: 精确 ID 筛选使用数值输入,计费周期起点使用日期时间选择器,判定时间使用日期时间范围选择器;时间序列化为带时区 RFC3339 秒级字符串。
- Rationale: 与接口的精确匹配和闭区间语义一致,避免按日期截断或丢失时区。
- Decision: 页面仅展示响应快照,不再查询通道配置或根据当前阈值重算历史值。
- Rationale: 命中值冻结于判定时;历史缺失值必须保留接口规定的空值含义。
## Risks / Trade-offs
- 查询页不依赖后端菜单节点;前端入口仅对平台账号显示,页面路由限制用户类型,API 仍执行最终授权和数据范围过滤。
- 表格包含多列证据字段,采用现有可横向滚动的管理台表格以保持信息完整。