- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
Purpose
在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口。
ADDED 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 系统忽略现有缓存并重新计算后返回