64f5d567fa
Some checks failed
continuous-integration/drone/push Build is failing
1. 课程学习进度追踪
- 新增 UserCourseProgress 和 UserMaterialProgress 模型
- 新增 /api/v1/progress/* 进度追踪 API
- 更新 admin.py 使用真实课程完成率数据
2. 路由权限检查完善
- 新增前端 permissionChecker.ts 权限检查工具
- 更新 router/guard.ts 实现团队和课程权限验证
- 新增后端 permission_service.py
3. AI 陪练音频转文本
- 新增 speech_recognition.py 语音识别服务
- 新增 /api/v1/speech/* API
- 更新 ai-practice-coze.vue 支持语音输入
4. 双人对练报告生成
- 更新 practice_room_service.py 添加报告生成功能
- 新增 /rooms/{room_code}/report API
- 更新 duo-practice-report.vue 调用真实 API
5. 学习提醒推送
- 新增 notification_service.py 通知服务
- 新增 scheduler_service.py 定时任务服务
- 支持钉钉、企微、站内消息推送
6. 智能学习推荐
- 新增 recommendation_service.py 推荐服务
- 新增 /api/v1/recommendations/* API
- 支持错题、能力、进度、热门多维度推荐
7. 安全问题修复
- DEBUG 默认值改为 False
- 添加 SECRET_KEY 安全警告
- 新增 check_security_settings() 检查函数
8. 证书 PDF 生成
- 更新 certificate_service.py 添加 PDF 生成
- 添加 weasyprint、Pillow、qrcode 依赖
- 更新下载 API 支持 PDF 和 PNG 格式
83 lines
2.2 KiB
Markdown
83 lines
2.2 KiB
Markdown
# 数据库迁移说明
|
||
|
||
本目录包含 KPL 考培练系统的数据库迁移脚本。
|
||
|
||
## 迁移脚本列表
|
||
|
||
| 脚本 | 说明 | 创建时间 |
|
||
|------|------|----------|
|
||
| `add_level_badge_system.sql` | 等级与奖章系统 | 2026-01-29 |
|
||
|
||
## 执行迁移
|
||
|
||
### 测试环境（Docker）
|
||
|
||
KPL 测试环境数据库在服务器 Docker 容器中运行：
|
||
|
||
```bash
|
||
# 1. SSH 登录 KPL 服务器
|
||
ssh root@<KPL服务器IP>
|
||
|
||
# 2. 进入项目目录
|
||
cd /www/wwwroot/kpl.ireborn.com.cn
|
||
|
||
# 3. 执行迁移（方法一：直接执行）
|
||
docker exec -i kpl-mysql-dev mysql -uroot -pnj861021 kpl_dev < backend/migrations/add_level_badge_system.sql
|
||
|
||
# 或者（方法二：交互式执行）
|
||
docker exec -it kpl-mysql-dev mysql -uroot -pnj861021 kpl_dev
|
||
# 然后复制粘贴 SQL 脚本内容执行
|
||
|
||
# 方法三：从本地执行（需要先上传SQL文件到服务器）
|
||
# scp backend/migrations/add_level_badge_system.sql root@<服务器IP>:/tmp/
|
||
# ssh root@<服务器IP> "docker exec -i kpl-mysql-dev mysql -uroot -pnj861021 kpl_dev < /tmp/add_level_badge_system.sql"
|
||
```
|
||
|
||
**注意**：MySQL 容器密码为 `nj861021`（之前通过 `docker exec kpl-mysql-dev env | grep MYSQL` 确认）
|
||
|
||
### 生产环境
|
||
|
||
生产环境迁移前请确保：
|
||
1. 已备份数据库
|
||
2. 在低峰期执行
|
||
3. 测试环境验证通过
|
||
|
||
```bash
|
||
# 执行迁移（替换为实际的生产数据库配置）
|
||
mysql -h<host> -u<user> -p<password> <database> < backend/migrations/add_level_badge_system.sql
|
||
```
|
||
|
||
## 回滚方法
|
||
|
||
如需回滚，执行以下 SQL：
|
||
|
||
```sql
|
||
DROP TABLE IF EXISTS user_badges;
|
||
DROP TABLE IF EXISTS badge_definitions;
|
||
DROP TABLE IF EXISTS exp_history;
|
||
DROP TABLE IF EXISTS level_configs;
|
||
DROP TABLE IF EXISTS user_levels;
|
||
```
|
||
|
||
## 验证迁移
|
||
|
||
执行以下查询验证表是否创建成功：
|
||
|
||
```sql
|
||
SHOW TABLES LIKE '%level%';
|
||
SHOW TABLES LIKE '%badge%';
|
||
SHOW TABLES LIKE '%exp%';
|
||
|
||
-- 查看表结构
|
||
DESCRIBE user_levels;
|
||
DESCRIBE exp_history;
|
||
DESCRIBE badge_definitions;
|
||
DESCRIBE user_badges;
|
||
DESCRIBE level_configs;
|
||
|
||
-- 验证初始数据
|
||
SELECT COUNT(*) FROM level_configs; -- 应该是 10 条
|
||
SELECT COUNT(*) FROM badge_definitions; -- 应该是 20 条
|
||
SELECT COUNT(*) FROM user_levels; -- 应该等于用户数
|
||
```
|