feat(admin): 实现只读词库管理后台
- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
131c2b6353
commit
4e68ba3890
137 files changed
+15423
-10
No files matched your search
@@ -5,11 +5,13 @@
|
||||
| 目录 | 项目 | 状态 | 说明 |
|
||||
|---|---|---|---|
|
||||
| `importer/` | 单词导入 | 已有 | 从 Lexis 导出词书与词条,建库并导入 SQLite/PostgreSQL/MySQL |
|
||||
| `frontend/` | 单词管理前端 | 占位 | 待定技术栈 |
|
||||
| `backend/` | 单词管理后端 | 占位 | 待定技术栈 |
|
||||
| `backend/` | 管理后台后端 | 已有 | Spring Boot 3 + MyBatis-Plus,只读查询 MySQL `word_market` |
|
||||
| `frontend/` | 管理后台前端 | 已有 | Vue 3 + Vite + TypeScript + Element Plus + ECharts |
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 导入数据
|
||||
|
||||
单词导入流程见 [`importer/README.md`](importer/README.md)。命令需在 `importer/` 目录下执行:
|
||||
|
||||
```powershell
|
||||
@@ -17,6 +19,38 @@ cd importer
|
||||
python run.py
|
||||
```
|
||||
|
||||
### 2. 启动后端
|
||||
|
||||
准备数据库连接、管理员账号和 JWT 密钥(见 [`backend/README.md`](backend/README.md)):
|
||||
|
||||
```powershell
|
||||
cd backend
|
||||
$env:DB_USERNAME = 'your_user'
|
||||
$env:DB_PASSWORD = 'your_password'
|
||||
$env:ADMIN_USERNAME = 'admin'
|
||||
$env:ADMIN_PASSWORD_HASH = '$2a$10$...'
|
||||
$env:JWT_SECRET = 'at-least-32-bytes-random-secret'
|
||||
mvn spring-boot:run
|
||||
```
|
||||
|
||||
默认监听 `http://127.0.0.1:8080`。
|
||||
|
||||
### 3. 启动前端
|
||||
|
||||
```powershell
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
默认地址 `http://127.0.0.1:5173`,开发服务器代理 `/api` 到后端。
|
||||
|
||||
## 管理后台
|
||||
|
||||
只读管理后台覆盖六个模块:概览、词书、词条、词根词族、近反义词、数据质量。所有接口仅执行 `SELECT`,应用层启用只读事务,建议数据库侧使用只读账号。
|
||||
|
||||
生产部署方式为后端可执行 jar + 前端 `dist` 静态资源,由 Nginx 托管并反向代理 `/api`。
|
||||
|
||||
## 数据与产物
|
||||
|
||||
`importer/` 下的数据与研究产物不纳入 Git(见 `.gitignore`),仅保留在本机:
|
||||
@@ -30,6 +64,8 @@ Git 只跟踪源码、文档与配置。
|
||||
|
||||
## 文档
|
||||
|
||||
- 管理后端:[`backend/README.md`](backend/README.md)
|
||||
- 管理前端:[`frontend/README.md`](frontend/README.md)
|
||||
- 导入流程与算法:[`importer/README.md`](importer/README.md)
|
||||
- 数据实体关系模型:[`importer/docs/DATA-MODEL.md`](importer/docs/DATA-MODEL.md)
|
||||
- ZPK 解密内容分析:[`importer/docs/zpk-decrypted-content-analysis.md`](importer/docs/zpk-decrypted-content-analysis.md)
|
||||
Reference in new issue
Block a user