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
+74
-4
@@ -1,7 +1,77 @@
|
||||
# frontend — 单词管理前端
|
||||
# frontend — 词库管理前端
|
||||
|
||||
占位目录,技术栈待定。
|
||||
Vue 3 + Vite + TypeScript + Element Plus + ECharts。
|
||||
|
||||
用途:浏览、检索、编辑与管理由 `importer` 导入的词书、词条及其关联数据。
|
||||
## 功能
|
||||
|
||||
后续确定技术栈与目录结构后在此实现。
|
||||
- 单管理员登录、token 持久化、路由守卫与 401 自动跳转。
|
||||
- 概览:六项 KPI、考试分布、词书规模排行、词性分布、质量红绿灯、跨域覆盖度,支持强制刷新聚合缓存。
|
||||
- 词书:列表筛选、详情、词条清单分页与搜索、封面占位。
|
||||
- 词条:搜索列表 + 右侧抽屉详情,义项/短语/例句/收录词书按 Tab 懒加载,支持空状态与分页。
|
||||
- 词根词族:词素、单词卡片、词族列表与详情,词族树形族谱按节点懒加载。
|
||||
- 近反义词:组规模分布图、词头列表、词头详情(分考试近义组与反义词)。
|
||||
- 数据质量:指标摘要与口径提示、声明与实际差异、缺失引用明细、跨域覆盖度、实体跳转。
|
||||
|
||||
## 开发
|
||||
|
||||
```powershell
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
默认地址:http://127.0.0.1:5173。开发服务器将 `/api` 代理到 `http://127.0.0.1:8080`;如后端端口不同:
|
||||
|
||||
```powershell
|
||||
$env:VITE_PROXY_TARGET = 'http://127.0.0.1:18080'
|
||||
npm run dev
|
||||
```
|
||||
|
||||
后端未启动时可临时使用本地 mock:
|
||||
|
||||
```powershell
|
||||
$env:VITE_USE_MOCK = 'true'
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## 构建
|
||||
|
||||
```powershell
|
||||
npm run build
|
||||
```
|
||||
|
||||
产物在 `dist/`。构建前会执行 `vue-tsc --noEmit` 类型检查。
|
||||
|
||||
## 环境变量
|
||||
|
||||
复制 `.env.example` 为 `.env`:
|
||||
|
||||
```text
|
||||
VITE_USE_MOCK=false
|
||||
VITE_API_BASE_URL=/api
|
||||
VITE_COVER_BASE_URL=https://static.beingfine.cn
|
||||
```
|
||||
|
||||
- `VITE_USE_MOCK`:仅在明确设为 `true` 时使用本地 mock。
|
||||
- `VITE_API_BASE_URL`:接口前缀,默认 `/api`。
|
||||
- `VITE_COVER_BASE_URL`:词书封面 CDN 前缀。
|
||||
|
||||
## 目录
|
||||
|
||||
```text
|
||||
src/
|
||||
api/ Axios 封装、各模块接口与类型
|
||||
charts/ ECharts 配置
|
||||
components/ DataTable、CoverImage、StatCard、SectionPanel
|
||||
layouts/ AdminLayout 侧边栏布局
|
||||
mocks/ 离线开发用的概览数据快照
|
||||
router/ 路由与登录守卫
|
||||
stores/ 认证状态
|
||||
styles/ 全局基础样式
|
||||
utils/ 封面地址、存储键、HTML 文本清理
|
||||
views/ 登录、概览、词书、词条、词根词族、近反义词、数据质量
|
||||
```
|
||||
|
||||
## 生产部署
|
||||
|
||||
`npm run build` 后将 `dist/` 交给 Nginx,并把 `/api` 反向代理到后端。示例配置见 [`../backend/README.md`](../backend/README.md) 的部署章节。
|
||||
Reference in new issue
Block a user