- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.4 KiB
2.4 KiB
frontend — 词库管理前端
Vue 3 + Vite + TypeScript + Element Plus + ECharts。
功能
- 单管理员登录、token 持久化、路由守卫与 401 自动跳转。
- 概览:六项 KPI、考试分布、词书规模排行、词性分布、质量红绿灯、跨域覆盖度,支持强制刷新聚合缓存。
- 词书:列表筛选、详情、词条清单分页与搜索、封面占位。
- 词条:搜索列表 + 右侧抽屉详情,义项/短语/例句/收录词书按 Tab 懒加载,支持空状态与分页。
- 词根词族:词素、单词卡片、词族列表与详情,词族树形族谱按节点懒加载。
- 近反义词:组规模分布图、词头列表、词头详情(分考试近义组与反义词)。
- 数据质量:指标摘要与口径提示、声明与实际差异、缺失引用明细、跨域覆盖度、实体跳转。
开发
cd frontend
npm install
npm run dev
默认地址:http://127.0.0.1:5173。开发服务器将 /api 代理到 http://127.0.0.1:8080;如后端端口不同:
$env:VITE_PROXY_TARGET = 'http://127.0.0.1:18080'
npm run dev
后端未启动时可临时使用本地 mock:
$env:VITE_USE_MOCK = 'true'
npm run dev
构建
npm run build
产物在 dist/。构建前会执行 vue-tsc --noEmit 类型检查。
环境变量
复制 .env.example 为 .env:
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 前缀。
目录
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 的部署章节。