feat(admin): 实现只读词库管理后台

- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束
- 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量
- 补充前后端 README、环境变量示例与本地构建部署说明
- 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-08 22:55:15 +08:00
1 parent 131c2b6353
commit 4e68ba3890
137 files changed
+15423 -10

No files matched your search

@@ -0,0 +1,69 @@
## 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** 系统忽略现有缓存并重新计算后返回