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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-08 22:55:15 +08:00

45 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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,前端产出静态资源。