- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
78 lines
2.4 KiB
Markdown
78 lines
2.4 KiB
Markdown
# frontend — 词库管理前端
|
||
|
||
Vue 3 + Vite + TypeScript + Element Plus + ECharts。
|
||
|
||
## 功能
|
||
|
||
- 单管理员登录、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) 的部署章节。
|