kindergarten_java/docs/数据库迁移指南.md

数据库迁移指南

数据库配置

服务器地址: 8.148.151.56:3306 数据库名: reading_platform 用户名: root 密码: reading_platform_pwd

---

需要创建的表

本次迁移需要创建以下 7 个新表：

1. course_package - 课程套餐表
2. course_package_course - 套餐课程关联表
3. tenant_package - 租户套餐关联表
4. course_lesson - 课程环节表
5. lesson_step - 教学环节表
6. lesson_step_resource - 环节资源关联表
7. theme - 主题字典表

---

执行方式

方式 1：使用数据库管理工具（推荐）

1. 打开 Navicat、phpMyAdmin、DBeaver 等数据库管理工具
2. 连接到数据库：8.148.151.56:3306
3. 选择数据库：reading_platform
4. 打开 SQL 执行窗口
5. 复制下面的 SQL 脚本并执行

方式 2：使用 MySQL 命令行

mysql -h 8.148.151.56 -P 3306 -u root -preading_platform_pwd reading_platform < V20260312__create_new_tables.sql

方式 3：在线执行（如果没有本地工具）

访问在线 SQL 执行工具或使用 SSH 连接到服务器后执行。

---

SQL 脚本

1. 课程套餐表

CREATE TABLE IF NOT EXISTS `course_package` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(255) NOT NULL COMMENT '套餐名称',
  `description` TEXT COMMENT '套餐描述',
  `price` BIGINT NOT NULL COMMENT '价格（分）',
  `discount_price` BIGINT COMMENT '折后价格（分）',
  `discount_type` VARCHAR(50) COMMENT '折扣类型',
  `grade_levels` VARCHAR(500) COMMENT '适用年级',
  `course_count` INT NOT NULL DEFAULT 0 COMMENT '课程数量',
  `status` VARCHAR(50) NOT NULL DEFAULT 'DRAFT' COMMENT '状态',
  `submitted_at` DATETIME COMMENT '提交时间',
  `submitted_by` BIGINT COMMENT '提交人ID',
  `reviewed_at` DATETIME COMMENT '审核时间',
  `reviewed_by` BIGINT COMMENT '审核人ID',
  `review_comment` TEXT COMMENT '审核意见',
  `published_at` DATETIME COMMENT '发布时间',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='课程套餐表';

2. 套餐课程关联表

CREATE TABLE IF NOT EXISTS `course_package_course` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `package_id` BIGINT NOT NULL COMMENT '套餐ID',
  `course_id` BIGINT NOT NULL COMMENT '课程ID',
  `grade_level` VARCHAR(50) COMMENT '适用年级',
  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_package_course` (`package_id`, `course_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='套餐课程关联表';

3. 租户套餐关联表

CREATE TABLE IF NOT EXISTS `tenant_package` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `tenant_id` BIGINT NOT NULL COMMENT '租户ID',
  `package_id` BIGINT NOT NULL COMMENT '套餐ID',
  `start_date` DATE NOT NULL COMMENT '开始日期',
  `end_date` DATE NOT NULL COMMENT '结束日期',
  `price_paid` BIGINT NOT NULL DEFAULT 0 COMMENT '实付价格',
  `status` VARCHAR(50) NOT NULL DEFAULT 'ACTIVE' COMMENT '状态',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_package_id` (`package_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='租户套餐关联表';

4. 课程环节表

CREATE TABLE IF NOT EXISTS `course_lesson` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `course_id` BIGINT NOT NULL COMMENT '课程ID',
  `lesson_type` VARCHAR(50) NOT NULL COMMENT '课程类型',
  `name` VARCHAR(255) NOT NULL COMMENT '课程名称',
  `description` TEXT COMMENT '课程描述',
  `duration` INT COMMENT '时长（分钟）',
  `video_path` VARCHAR(500) COMMENT '视频路径',
  `video_name` VARCHAR(255) COMMENT '视频名称',
  `ppt_path` VARCHAR(500) COMMENT 'PPT路径',
  `ppt_name` VARCHAR(255) COMMENT 'PPT名称',
  `pdf_path` VARCHAR(500) COMMENT 'PDF路径',
  `pdf_name` VARCHAR(255) COMMENT 'PDF名称',
  `objectives` TEXT COMMENT '教学目标',
  `preparation` TEXT COMMENT '教学准备',
  `extension` TEXT COMMENT '教学延伸',
  `reflection` TEXT COMMENT '教学反思',
  `assessment_data` TEXT COMMENT '评测数据',
  `use_template` TINYINT(1) DEFAULT 0 COMMENT '是否使用模板',
  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_course_id` (`course_id`),
  UNIQUE KEY `uk_course_lesson_type` (`course_id`, `lesson_type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='课程环节表';

5. 教学环节表

CREATE TABLE IF NOT EXISTS `lesson_step` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `lesson_id` BIGINT NOT NULL COMMENT '课程环节ID',
  `name` VARCHAR(255) NOT NULL COMMENT '环节名称',
  `content` TEXT COMMENT '环节内容',
  `duration` INT NOT NULL DEFAULT 5 COMMENT '时长（分钟）',
  `objective` TEXT COMMENT '教学目标',
  `resource_ids` TEXT COMMENT '资源ID列表',
  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_lesson_id` (`lesson_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='教学环节表';

6. 环节资源关联表

CREATE TABLE IF NOT EXISTS `lesson_step_resource` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `step_id` BIGINT NOT NULL COMMENT '环节ID',
  `resource_id` BIGINT NOT NULL COMMENT '资源ID',
  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号',
  PRIMARY KEY (`id`),
  KEY `idx_step_id` (`step_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='环节资源关联表';

7. 主题字典表

CREATE TABLE IF NOT EXISTS `theme` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(255) NOT NULL COMMENT '主题名称',
  `description` TEXT COMMENT '主题描述',
  `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号',
  `status` VARCHAR(50) NOT NULL DEFAULT 'ACTIVE' COMMENT '状态',
  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='主题字典表';

---

验证表创建

执行完成后，运行以下 SQL 验证：

-- 查看所有表
SHOW TABLES;

-- 查看新创建的表
SELECT TABLE_NAME, TABLE_COMMENT
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'reading_platform'
AND TABLE_NAME IN ('course_package', 'course_package_course', 'tenant_package',
                   'course_lesson', 'lesson_step', 'lesson_step_resource', 'theme');

---

注意事项

1. 执行前备份: 建议先备份数据库
2. 字符集: 所有表使用 utf8mb4 字符集
3. 引擎: 使用 InnoDB 存储引擎
4. 索引: 已创建必要的索引以提高查询性能

---

下一步

表创建完成后，可以：

1. 启动 Java 后端应用
2. 访问 Swagger 文档测试 API：http://localhost:8080/swagger-ui.html
3. 进行功能测试

---

创建时间: 2026-03-12