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