- 将变更移动到 changes/archive/2026-11-08-add-admin-console - 同步 7 个能力、37 条需求到 openspec/specs/ - openspec validate --all 全部通过 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
# admin-overview Specification
|
|
|
|
## Purpose
|
|
|
|
在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口,并支持从异常指标下钻到对应模块。
|
|
|
|
## Requirements
|
|
|
|
### Requirement: 总量指标
|
|
|
|
系统 SHALL 在概览页展示词书数、词条数、词书词条关联数、例句数、词族数、近义词头数六项核心指标。
|
|
|
|
#### Scenario: 打开概览页
|
|
|
|
- **WHEN** 已登录管理员进入概览页
|
|
- **THEN** 页面展示六项指标及其当前数值
|
|
|
|
#### Scenario: 指标查询失败
|
|
|
|
- **WHEN** 某一指标查询失败
|
|
- **THEN** 页面展示该指标的不可用状态,其余指标仍正常展示
|
|
|
|
### Requirement: 考试维度分布
|
|
|
|
系统 SHALL 按考试展示词书数与关联词条数,并 MUST 显式包含“未归类”分组,避免未设置考试的词书被忽略。
|
|
|
|
#### Scenario: 查看考试分布
|
|
|
|
- **WHEN** 管理员查看考试分布图
|
|
- **THEN** 图中包含各考试的词书数、关联词条数以及“未归类”分组
|
|
|
|
### Requirement: 词书规模排行
|
|
|
|
系统 SHALL 展示实际词条数最多的前 10 本词书,同时给出各自声明的词条数,便于发现两者差异。
|
|
|
|
#### Scenario: 查看规模排行
|
|
|
|
- **WHEN** 管理员查看词书规模排行
|
|
- **THEN** 页面按实际词条数降序列出前 10 本,并同时显示声明词条数
|
|
|
|
### Requirement: 词性分布
|
|
|
|
系统 SHALL 按 `part_of_speech` 汇总词义数量并展示主要词性占比。
|
|
|
|
#### Scenario: 查看词性分布
|
|
|
|
- **WHEN** 管理员查看词性分布
|
|
- **THEN** 页面展示各词性的义项数及占比,空词性单独归类
|
|
|
|
### Requirement: 质量红绿灯
|
|
|
|
系统 SHALL 在概览页展示关键数据质量指标摘要,并提供进入数据质量模块的入口。
|
|
|
|
#### Scenario: 查看质量摘要
|
|
|
|
- **WHEN** 管理员查看质量红绿灯
|
|
- **THEN** 页面展示异常项数量与状态,并可跳转到数据质量模块
|
|
|
|
### Requirement: 聚合结果缓存
|
|
|
|
概览聚合结果 SHALL 缓存一段时间;缓存有效期内重复请求直接返回缓存,过期后重新查询。系统 SHALL 提供手动刷新方式以强制重新计算。
|
|
|
|
#### Scenario: 缓存命中
|
|
|
|
- **WHEN** 缓存在有效期内,管理员重复打开概览页
|
|
- **THEN** 系统直接返回缓存结果,不重新执行聚合查询
|
|
|
|
#### Scenario: 手动刷新
|
|
|
|
- **WHEN** 管理员触发刷新
|
|
- **THEN** 系统忽略现有缓存并重新计算后返回
|