Files
word-market/frontend/README.md
T
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

78 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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) 的部署章节。