Files
word-market/openspec/specs/admin-overview/spec.md
T
voidandClaude Sonnet 4.6 dd928a9513 chore(openspec): 归档 add-admin-console
- 将变更移动到 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>
2026-11-08 23:00:53 +08:00

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** 系统忽略现有缓存并重新计算后返回