Files
012-kaopeilian/backend/migrations
yuliang_guo 6f0f2e6363
Some checks failed
continuous-integration/drone/push Build is failing
feat: KPL v1.5.0 功能迭代
1. 奖章条件优化
- 修复统计查询 SQL 语法
- 添加按类别检查奖章方法

2. 移动端适配
- 登录页、课程中心、课程详情
- 考试页面、成长路径、排行榜

3. 证书系统
- 数据库模型和迁移脚本
- 证书颁发/列表/下载/验证 API
- 前端证书列表页面

4. 数据大屏
- 企业级/团队级数据 API
- ECharts 可视化大屏页面
2026-01-29 16:51:17 +08:00
..
2026-01-28 15:20:03 +08:00
2026-01-24 19:33:28 +08:00
2026-01-29 16:19:22 +08:00

数据库迁移说明

本目录包含 KPL 考培练系统的数据库迁移脚本。

迁移脚本列表

脚本 说明 创建时间
add_level_badge_system.sql 等级与奖章系统 2026-01-29

执行迁移

测试环境Docker

KPL 测试环境数据库在服务器 Docker 容器中运行:

# 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. 测试环境验证通过
# 执行迁移(替换为实际的生产数据库配置)
mysql -h<host> -u<user> -p<password> <database> < backend/migrations/add_level_badge_system.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;

验证迁移

执行以下查询验证表是否创建成功:

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;  -- 应该等于用户数