Files
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

2.4 KiB
Raw Permalink Blame History

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 的部署章节。