- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
45 lines
3.0 KiB
Markdown
45 lines
3.0 KiB
Markdown
## Why
|
||
|
||
`importer` 已将 Lexis 词库完整导入 MySQL `word_market`(36 张表、约 364 万行),但目前没有任何浏览或可视化入口。核对词书内容、排查数据质量问题只能手写 SQL,效率低且容易误操作。需要一套只读管理后台,把词书、词条、词根词族、近反义词四个业务域的数据可视化,并支持从看板钻取到明细,帮助快速理解和核查这批数据。
|
||
|
||
本期明确只做查询与展示,不提供任何增删改,避免误改源数据。
|
||
|
||
## What Changes
|
||
|
||
- 新建 `backend/`:Spring Boot 3(Java 17)+ MyBatis-Plus,只读连接 MySQL `word_market`。
|
||
- 新建 `frontend/`:Vue 3 + Vite + TypeScript + Element Plus + ECharts。
|
||
- 单管理员登录:账号密码来自环境变量,登录后签发 JWT;前端路由守卫与 401 拦截。
|
||
- 概览看板:总量 KPI、考试分布、词书规模排行、词性分布、数据质量红绿灯。
|
||
- 词书模块:1,025 本词书的列表、筛选、详情与词条清单分页。
|
||
- 词条模块:38,116 个词条的搜索、详情,覆盖义项、短语、例句、易混词、收录词书。
|
||
- 词根词族模块:词素(前缀/词根/后缀)、单词卡片、词族及**树形族谱**。
|
||
- 近反义词模块:词头列表、义项详情、分考试近义组与反义词。
|
||
- 数据质量模块:声明 vs 实际、缺失文件/引用、无结构化义项、跨域覆盖度。
|
||
- 全局只读约束:所有接口仅执行 SELECT,应用层开启 read-only 事务,数据库侧建议使用只读账号。
|
||
- 聚合查询使用 Caffeine 缓存,列表与子资源统一分页。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
- `admin-auth`: 单管理员凭据校验、JWT 签发与校验、未认证访问拦截。
|
||
- `admin-overview`: 概览看板的 KPI 与分布图表数据。
|
||
- `book-catalog`: 词书列表、筛选、详情与词条清单的只读浏览。
|
||
- `word-lexicon`: 词条搜索、详情及义项/短语/例句/易混词/收录词书等子资源浏览。
|
||
- `word-morphology`: 词素、单词卡片、词族及树形族谱的只读浏览。
|
||
- `synonym-relations`: 近义词头、义项、分考试近义组与反义词的只读浏览。
|
||
- `data-quality`: 数据质量指标与异常明细的聚合展示。
|
||
|
||
### Modified Capabilities
|
||
|
||
无。当前 `openspec/specs/` 下没有既有能力,本次全部为新增。
|
||
|
||
## Impact
|
||
|
||
- 代码:`backend/`、`frontend/` 由占位目录变为实际工程;`importer/` 与数据库 schema 不改动。
|
||
- 数据:只读访问 MySQL `s1.void01.com:3306/word_market`,不新增表、不写入。
|
||
- 配置:需要数据库连接信息、管理员账号与密码哈希、JWT 密钥等环境变量;不得硬编码凭据。
|
||
- 外部依赖:词书封面通过 `https://static.beingfine.cn` + `book.cover_url` 访问。
|
||
- 性能:概览聚合依赖 Caffeine 缓存,避免高频全表聚合;详情页子资源必须分页。
|
||
- 运维:前后端分离部署,后端产出可执行 jar,前端产出静态资源。
|