skycurtain
db20dcb611
- 八篇：总览与共性 / 登录与会话 / 全员总览 / key 管理 / 支付记录 / 成员管理 / 审计日志 / 成员视图 - 关键定案：R12 携带形态（来源徽章 + 展开行，两种空值场景区分）、纯用量模式（部门实例——无支付记录的完整子集，共性 §3.8）、响应式只做布局响应、组件能力需求清单（选型验收标准）、审计日志保留操作者列（前向兼容多管理员）、Key 与成员管理分页 + 「+ 新建成员」缝合流程 - 审阅期修订全记录见需求清单 §9「交互设计八篇定稿」
2.7 KiB
2.7 KiB
交互设计 · 全员总览
管理面首页（登录后的落地页）：整个池子的健康与用量全景——你的「全员视角」的唯一居所（开放查看面裁撤后，R5 的全员入口在这里）。
| 项目 | 内容 |
|---|---|
| 状态 | 定稿（2026-10-01） |
| 关联 | 《交互设计-总览与共性》（时间范围选择器、数值呈现）· 需求清单.md R5（全员视角归此页）· R9（多维统计） |
| 数据 | usage_logs 聚合（按成员 / key / 来源）· api_keys.log_synced_at（数据截止）· 引擎轮次摘要 |
1. 页面结构（自上而下）
1.1 健康带（页面顶部，常驻）
| 元素 | 内容 | 说明 |
|---|---|---|
| 引擎状态 | 「最近轮次：18 key，成功 16，失败 2」 | 失败数 > 0 时高亮并链到 Key 管理的失败筛选 |
| 全池数据截止 | 取全池 log_synced_at 最慢（既定聚合语义） |
落后超过 2 小时 → 黄色预警「数据截止停滞——检查引擎日志」 |
| 未关联订阅分组 | 该时段内 billing_source = subscription 且 subscription_id 为空的量 |
正常恒为 0；非零 → 红色提示（缺登记或上游行为变化）——健康指示器的可视化 |
健康带不主动轮询（打开页面刷新即可）；告警推送能力属 R4（延后），此处只做「打开页面即可见」的显形。
1.2 时间范围选择器
- 共性篇 §3.1 的核心组件；默认最近 30 天，快捷项含「本订阅期间」
1.3 按成员汇总区（主区块）
卡片栅格，每成员一张卡：
- 成员名（+备注 hover）
- 名下 key 数、该时段用量（次数 / quota / 美元）、占全员比例条（该时段内的事实占比）
- 数据截止（名下最慢）
- 「未归属（归作者）」作为一张固定的卡——无归属 key 的用量去向（
member_id IS NULL的聚合）
1.4 按 key 明细区
- 折叠表（默认收起，与按成员卡互不抢屏）：key 名、归属、状态、数据截止、该时段用量
- 行点击 → 跳转 Key 管理页该 key 详情
- 按「按来源」的分解以分段条呈现于表头上方：订阅消耗 / 充值消耗（该时段）
2. 交互流
| 动作 | 流程 |
|---|---|
| 切换时间范围 | 局部刷新全部区块（口径标注同步更新） |
| 点击健康带的失败数 | → Key 管理页，筛选「最近轮次失败」 |
| 点击成员卡 | → 该成员的 key 列表过滤视图（或成员管理页定位该成员） |
3. 空态
- 无任何 key：健康带显示「未登记任何 key」，主区块引导「去 Key 管理登记第一个」
- 有 key 无日志：各卡正常、用量为 0（空态与零值区分标注「该时段内无调用」）