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