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

2.4 KiB

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