skycurtain
db20dcb611
- 八篇：总览与共性 / 登录与会话 / 全员总览 / key 管理 / 支付记录 / 成员管理 / 审计日志 / 成员视图 - 关键定案：R12 携带形态（来源徽章 + 展开行，两种空值场景区分）、纯用量模式（部门实例——无支付记录的完整子集，共性 §3.8）、响应式只做布局响应、组件能力需求清单（选型验收标准）、审计日志保留操作者列（前向兼容多管理员）、Key 与成员管理分页 + 「+ 新建成员」缝合流程 - 审阅期修订全记录见需求清单 §9「交互设计八篇定稿」
56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
# 交互设计 · 全员总览
|
||
|
||
> 管理面首页（登录后的落地页）：整个池子的健康与用量全景——你的「全员视角」的唯一居所（开放查看面裁撤后，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（空态与零值区分标注「该时段内无调用」）
|