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:
1 parent
131c2b6353
commit
4e68ba3890
137 files changed
+15423
-10
No files matched your search
@@ -0,0 +1,88 @@
|
||||
## Purpose
|
||||
|
||||
汇总词库的数据质量问题,提供可解释的指标口径和到明细的下钻入口,帮助定位需要修复的数据。
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 质量摘要
|
||||
|
||||
系统 SHALL 提供数据质量摘要,至少包含:声明与实际词条数不一致的词书数、缺失词书文件数、缺失 zpk 引用数、无结构化义项的词条数、无义项的近义词头数、未设置考试的词书数。
|
||||
|
||||
#### Scenario: 查看质量摘要
|
||||
|
||||
- **WHEN** 管理员打开数据质量模块
|
||||
- **THEN** 页面展示上述指标的当前数值和状态
|
||||
|
||||
#### Scenario: 指标查询失败
|
||||
|
||||
- **WHEN** 某一质量指标查询失败
|
||||
- **THEN** 页面展示该指标不可用,其余指标正常展示
|
||||
|
||||
### Requirement: 指标口径说明
|
||||
|
||||
每个质量指标 SHALL 附带口径说明,明确统计范围和判定条件,避免管理员误读。
|
||||
|
||||
#### Scenario: 查看口径
|
||||
|
||||
- **WHEN** 管理员将鼠标悬停或点击指标说明
|
||||
- **THEN** 页面展示该指标的统计范围与判定条件
|
||||
|
||||
### Requirement: 声明与实际差异明细
|
||||
|
||||
系统 SHALL 列出声明词条数与实际词条数不一致的词书,展示两者数值及差值,并支持跳转到词书详情。
|
||||
|
||||
#### Scenario: 查看差异明细
|
||||
|
||||
- **WHEN** 管理员打开声明与实际差异明细
|
||||
- **THEN** 页面列出全部不一致词书及其声明数、实际数和差值
|
||||
|
||||
#### Scenario: 跳转到词书
|
||||
|
||||
- **WHEN** 管理员点击某本差异词书
|
||||
- **THEN** 前端跳转到该词书详情
|
||||
|
||||
### Requirement: 缺失引用与文件明细
|
||||
|
||||
系统 SHALL 列出缺失词书文件、缺失 zpk 引用等异常明细,并标明对应标识,便于人工核查。
|
||||
|
||||
#### Scenario: 查看缺失明细
|
||||
|
||||
- **WHEN** 管理员打开缺失明细
|
||||
- **THEN** 页面列出每个异常项的标识、来源和缺失类型
|
||||
|
||||
### Requirement: 跨域覆盖度
|
||||
|
||||
系统 SHALL 展示单词卡片、词族、近义词头与词条索引词之间的文本交集覆盖率,并说明关联是弱关联。
|
||||
|
||||
#### Scenario: 查看覆盖度
|
||||
|
||||
- **WHEN** 管理员打开跨域覆盖度视图
|
||||
- **THEN** 页面展示各域与词条索引词的交集数量、占比和未覆盖数量
|
||||
|
||||
### Requirement: 异常下钻
|
||||
|
||||
系统 SHALL 允许从质量异常项跳转到对应的词书、词条或近义词详情,前提是存在可直接定位的实体标识。
|
||||
|
||||
#### Scenario: 下钻到实体
|
||||
|
||||
- **WHEN** 管理员点击一个可定位的异常项
|
||||
- **THEN** 前端跳转到对应实体详情页
|
||||
|
||||
#### Scenario: 无法定位
|
||||
|
||||
- **WHEN** 异常项没有可定位的实体标识
|
||||
- **THEN** 页面仅展示明细,不提供跳转
|
||||
|
||||
### Requirement: 质量结果缓存
|
||||
|
||||
质量摘要与覆盖度等聚合结果 SHALL 缓存一段时间,并支持手动刷新强制重算。
|
||||
|
||||
#### Scenario: 缓存命中
|
||||
|
||||
- **WHEN** 缓存在有效期内重复访问质量模块
|
||||
- **THEN** 系统返回缓存结果
|
||||
|
||||
#### Scenario: 手动刷新
|
||||
|
||||
- **WHEN** 管理员触发刷新
|
||||
- **THEN** 系统忽略缓存并重新计算
|
||||
Reference in new issue
Block a user