850 lines
28 KiB
Markdown
850 lines
28 KiB
Markdown
|
# 数据模型重构设计
|
|||
|
|
|
|||
|
|
> 创建时间：2026-02-27
|
|||
|
|
> 基于需求：17-课程包套餐重构需求.md
|
|||
|
|
> 状态：设计中
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、设计原则
|
|||
|
|
|
|||
|
|
### 1.1 重构原则
|
|||
|
|
|
|||
|
|
| 原则 | 说明 |
|
|||
|
|
|-----|------|
|
|||
|
|
| **向后兼容** | 新结构与旧结构可以共存，支持渐进式迁移 |
|
|||
|
|
| **数据安全** | 迁移过程中不丢失任何现有数据 |
|
|||
|
|
| **最小变更** | 保留可复用的表和字段，减少不必要的重构 |
|
|||
|
|
| **可扩展性** | 新结构支持后续功能迭代 |
|
|||
|
|
|
|||
|
|
### 1.2 参考最佳实践
|
|||
|
|
|
|||
|
|
基于以下资源的最佳实践：
|
|||
|
|
- [Prisma Schema Design Best Practices](https://blog.csdn.net/gitblog_00740/article/details/151825815) - LMS系统数据模型设计
|
|||
|
|
- [Microsoft Azure - SaaS Tenancy Patterns](https://learn.microsoft.com/zh-cn/azure/azure-sql/database/saas-tenancy-app-design-patterns) - 多租户SaaS架构模式
|
|||
|
|
- [Prisma Migration Strategy](https://www.prisma.io/docs/concepts/components/prisma-migrate) - 生产环境迁移策略
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、表结构变更概览
|
|||
|
|
|
|||
|
|
### 2.1 变更清单
|
|||
|
|
|
|||
|
|
| 变更类型 | 表名 | 说明 |
|
|||
|
|
|---------|------|------|
|
|||
|
|
| **🆕 新增** | CoursePackage | 课程套餐 |
|
|||
|
|
| **🆕 新增** | CoursePackageCourse | 套餐-课程包关联 |
|
|||
|
|
| **🆕 新增** | TenantPackage | 租户-套餐授权 |
|
|||
|
|
| **🆕 新增** | Theme | 主题字典 |
|
|||
|
|
| **🆕 新增** | CourseLesson | 课程（导入课/集体课/领域课） |
|
|||
|
|
| **🆕 新增** | LessonStep | 教学环节 |
|
|||
|
|
| **🆕 新增** | LessonStepResource | 环节资源关联 |
|
|||
|
|
| **🆕 新增** | SchoolCourse | 校本课程包 |
|
|||
|
|
| **🔄 重构** | Course | 课程包（字段大幅调整） |
|
|||
|
|
| **🔄 调整** | Tenant | 新增套餐相关字段 |
|
|||
|
|
| **❌ 废弃** | CourseScript | 被 CourseLesson + LessonStep 替代 |
|
|||
|
|
| **❌ 废弃** | CourseScriptPage | 被 LessonStep 替代 |
|
|||
|
|
| **❌ 废弃** | CourseActivity | 并入 CourseLesson |
|
|||
|
|
| **⚠️ 保留** | TenantCourse | 保留，作为套餐授权的补充 |
|
|||
|
|
|
|||
|
|
### 2.2 表关系图
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ 核心关系图 │
|
|||
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ ┌──────────────┐ │
|
|||
|
|
│ │ CoursePackage│ ◄─────────────────────────────────────────────┐ │
|
|||
|
|
│ │ (课程套餐) │ │ │
|
|||
|
|
│ └───────┬──────┘ │ │
|
|||
|
|
│ │ 1:N │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌──────────────────┐ N:1 ┌────────────┐ │ │
|
|||
|
|
│ │CoursePackageCourse├─────────────►│ Course │ │ │
|
|||
|
|
│ │ (套餐-课程关联) │ │ (课程包) │ │ │
|
|||
|
|
│ └──────────────────┘ └──────┬─────┘ │ │
|
|||
|
|
│ │ 1:N │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌──────────────┐ ┌────────────┐ │ │
|
|||
|
|
│ │TenantPackage │ │CourseLesson│ │ │
|
|||
|
|
│ │(租户-套餐授权)├─────────────────►│ (课程) │ │ │
|
|||
|
|
│ └──────────────┘ └──────┬─────┘ │ │
|
|||
|
|
│ │ │ 1:N │ │
|
|||
|
|
│ │ N:1 ▼ │ │
|
|||
|
|
│ ▼ ┌────────────┐ │ │
|
|||
|
|
│ ┌──────────────┐ │ LessonStep │ │ │
|
|||
|
|
│ │ Tenant │ │ (教学环节) │ │ │
|
|||
|
|
│ │ (租户) │ └──────┬─────┘ │ │
|
|||
|
|
│ └──────────────┘ │ N:N │ │
|
|||
|
|
│ ▼ │ │
|
|||
|
|
│ ┌────────────────┐ │ │
|
|||
|
|
│ │LessonStepResource│ │ │
|
|||
|
|
│ │ (环节资源关联) │ │ │
|
|||
|
|
│ └────────────────┘ │ │
|
|||
|
|
│ │ │
|
|||
|
|
│ ┌──────────────┐ │ │
|
|||
|
|
│ │SchoolCourse │────────────────────────────────────────┘ │
|
|||
|
|
│ │ (校本课程包) │ 基于Course创建 │
|
|||
|
|
│ └──────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、新增表设计
|
|||
|
|
|
|||
|
|
### 3.1 CoursePackage（课程套餐）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 课程套餐 ====================
|
|||
|
|
|
|||
|
|
model CoursePackage {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
// 基本信息
|
|||
|
|
name String
|
|||
|
|
description String? @db.Text
|
|||
|
|
|
|||
|
|
// 定价
|
|||
|
|
price Int @default(0) // 原价（分）
|
|||
|
|
discountPrice Int? @map("discount_price") // 折扣价（分）
|
|||
|
|
discountType String? @map("discount_type") // 折扣类型：EARLY_BIRD, RENEWAL, GROUP
|
|||
|
|
|
|||
|
|
// 适用年级（多选）
|
|||
|
|
gradeLevels String @default("[]") @map("grade_levels") // JSON: ["XIAO_BAN", "ZHONG_BAN"]
|
|||
|
|
|
|||
|
|
// 状态
|
|||
|
|
status String @default("DRAFT") // DRAFT, PENDING, PUBLISHED, ARCHIVED
|
|||
|
|
|
|||
|
|
// 审核相关
|
|||
|
|
submittedAt DateTime? @map("submitted_at")
|
|||
|
|
submittedBy Int? @map("submitted_by")
|
|||
|
|
reviewedAt DateTime? @map("reviewed_at")
|
|||
|
|
reviewedBy Int? @map("reviewed_by")
|
|||
|
|
reviewComment String? @map("review_comment") @db.Text
|
|||
|
|
|
|||
|
|
// 统计
|
|||
|
|
courseCount Int @default(0) @map("course_count")
|
|||
|
|
tenantCount Int @default(0) @map("tenant_count")
|
|||
|
|
|
|||
|
|
// 创建者
|
|||
|
|
createdBy Int? @map("created_by")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
publishedAt DateTime? @map("published_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
courses CoursePackageCourse[]
|
|||
|
|
tenantPackages TenantPackage[]
|
|||
|
|
|
|||
|
|
@@index([status])
|
|||
|
|
@@map("course_packages")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.2 CoursePackageCourse（套餐-课程包关联）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 套餐-课程包关联 ====================
|
|||
|
|
|
|||
|
|
model CoursePackageCourse {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
packageId Int @map("package_id")
|
|||
|
|
courseId Int @map("course_id")
|
|||
|
|
|
|||
|
|
// 年级分组
|
|||
|
|
gradeLevel String @map("grade_level") // XIAO_BAN, ZHONG_BAN, DA_BAN
|
|||
|
|
|
|||
|
|
// 排序
|
|||
|
|
sortOrder Int @default(0) @map("sort_order")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
package CoursePackage @relation(fields: [packageId], references: [id], onDelete: Cascade)
|
|||
|
|
course Course @relation(fields: [courseId], references: [id], onDelete: Cascade)
|
|||
|
|
|
|||
|
|
@@unique([packageId, courseId])
|
|||
|
|
@@index([packageId, gradeLevel])
|
|||
|
|
@@map("course_package_courses")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.3 TenantPackage（租户-套餐授权）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 租户-套餐授权 ====================
|
|||
|
|
|
|||
|
|
model TenantPackage {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
tenantId Int @map("tenant_id")
|
|||
|
|
packageId Int @map("package_id")
|
|||
|
|
|
|||
|
|
// 授权时间
|
|||
|
|
startDate DateTime @map("start_date")
|
|||
|
|
endDate DateTime @map("end_date")
|
|||
|
|
|
|||
|
|
// 授权状态
|
|||
|
|
status String @default("ACTIVE") // ACTIVE, EXPIRED, CANCELLED
|
|||
|
|
|
|||
|
|
// 价格记录（授权时的价格）
|
|||
|
|
pricePaid Int @default(0) @map("price_paid") // 实际支付价格（分）
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
tenant Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
|
|||
|
|
package CoursePackage @relation(fields: [packageId], references: [id], onDelete: Cascade)
|
|||
|
|
|
|||
|
|
@@unique([tenantId, packageId])
|
|||
|
|
@@index([tenantId, status])
|
|||
|
|
@@index([endDate])
|
|||
|
|
@@map("tenant_packages")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.4 Theme（主题字典）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 主题字典 ====================
|
|||
|
|
|
|||
|
|
model Theme {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
name String @unique
|
|||
|
|
description String? @db.Text
|
|||
|
|
|
|||
|
|
// 排序权重
|
|||
|
|
sortOrder Int @default(0) @map("sort_order")
|
|||
|
|
|
|||
|
|
// 状态
|
|||
|
|
status String @default("ACTIVE") // ACTIVE, ARCHIVED
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
courses Course[]
|
|||
|
|
|
|||
|
|
@@index([sortOrder])
|
|||
|
|
@@map("themes")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.5 CourseLesson（课程）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 课程（导入课/集体课/领域课） ====================
|
|||
|
|
|
|||
|
|
model CourseLesson {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
courseId Int @map("course_id")
|
|||
|
|
|
|||
|
|
// 课程类型
|
|||
|
|
lessonType String @map("lesson_type") // INTRODUCTION(导入课), COLLECTIVE(集体课),
|
|||
|
|
// LANGUAGE(语言), HEALTH(健康), SCIENCE(科学),
|
|||
|
|
// SOCIAL(社会), ART(艺术)
|
|||
|
|
|
|||
|
|
// 基本信息
|
|||
|
|
name String
|
|||
|
|
description String? @db.Text
|
|||
|
|
|
|||
|
|
// 时长（分钟）
|
|||
|
|
duration Int @default(25)
|
|||
|
|
|
|||
|
|
// 核心资源（仅集体课和领域课）
|
|||
|
|
videoPath String? @map("video_path") // 动画视频
|
|||
|
|
videoName String? @map("video_name")
|
|||
|
|
pptPath String? @map("ppt_path") // 课件PPT
|
|||
|
|
pptName String? @map("ppt_name")
|
|||
|
|
pdfPath String? @map("pdf_path") // 电子绘本PDF
|
|||
|
|
pdfName String? @map("pdf_name")
|
|||
|
|
|
|||
|
|
// 教学目标（富文本）
|
|||
|
|
objectives String? @db.Text
|
|||
|
|
|
|||
|
|
// 教学准备（富文本）
|
|||
|
|
preparation String? @db.Text
|
|||
|
|
|
|||
|
|
// 教学延伸（富文本，集体课和领域课有）
|
|||
|
|
extension String? @db.Text
|
|||
|
|
|
|||
|
|
// 教学反思（富文本）
|
|||
|
|
reflection String? @db.Text
|
|||
|
|
|
|||
|
|
// 测评工具
|
|||
|
|
assessmentData String? @map("assessment_data") @db.Text // JSON存储
|
|||
|
|
|
|||
|
|
// 是否使用4环节模板（仅集体课）
|
|||
|
|
useTemplate Boolean @default(false) @map("use_template")
|
|||
|
|
|
|||
|
|
// 排序
|
|||
|
|
sortOrder Int @default(0) @map("sort_order")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
course Course @relation(fields: [courseId], references: [id], onDelete: Cascade)
|
|||
|
|
steps LessonStep[]
|
|||
|
|
|
|||
|
|
@@unique([courseId, lessonType])
|
|||
|
|
@@index([courseId])
|
|||
|
|
@@map("course_lessons")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.6 LessonStep（教学环节）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 教学环节 ====================
|
|||
|
|
|
|||
|
|
model LessonStep {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
lessonId Int @map("lesson_id")
|
|||
|
|
|
|||
|
|
// 环节基本信息
|
|||
|
|
name String
|
|||
|
|
content String @db.Text // 环节内容（富文本）
|
|||
|
|
|
|||
|
|
// 时长（分钟）
|
|||
|
|
duration Int @default(5)
|
|||
|
|
|
|||
|
|
// 教学目的（富文本）
|
|||
|
|
objective String? @db.Text
|
|||
|
|
|
|||
|
|
// 关联资源ID列表
|
|||
|
|
resourceIds String? @map("resource_ids") // JSON: [1, 2, 3]
|
|||
|
|
|
|||
|
|
// 排序
|
|||
|
|
sortOrder Int @default(0) @map("sort_order")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
lesson CourseLesson @relation(fields: [lessonId], references: [id], onDelete: Cascade)
|
|||
|
|
stepResources LessonStepResource[]
|
|||
|
|
|
|||
|
|
@@index([lessonId])
|
|||
|
|
@@map("lesson_steps")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.7 LessonStepResource（环节资源关联）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 环节资源关联 ====================
|
|||
|
|
|
|||
|
|
model LessonStepResource {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
stepId Int @map("step_id")
|
|||
|
|
resourceId Int @map("resource_id")
|
|||
|
|
|
|||
|
|
sortOrder Int @default(0) @map("sort_order")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
step LessonStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
|
|||
|
|
resource CourseResource @relation(fields: [resourceId], references: [id], onDelete: Cascade)
|
|||
|
|
|
|||
|
|
@@unique([stepId, resourceId])
|
|||
|
|
@@map("lesson_step_resources")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.8 SchoolCourse（校本课程包）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 校本课程包 ====================
|
|||
|
|
|
|||
|
|
model SchoolCourse {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
// 所属学校
|
|||
|
|
tenantId Int @map("tenant_id")
|
|||
|
|
|
|||
|
|
// 基于的课程包
|
|||
|
|
sourceCourseId Int @map("source_course_id")
|
|||
|
|
|
|||
|
|
// 基本信息
|
|||
|
|
name String
|
|||
|
|
description String? @db.Text
|
|||
|
|
|
|||
|
|
// 创建者（教师）
|
|||
|
|
createdBy Int @map("created_by")
|
|||
|
|
|
|||
|
|
// 调整内容摘要
|
|||
|
|
changesSummary String? @map("changes_summary") @db.Text
|
|||
|
|
|
|||
|
|
// 调整详情（JSON）
|
|||
|
|
changesData String? @map("changes_data") @db.Text
|
|||
|
|
|
|||
|
|
// 使用统计
|
|||
|
|
usageCount Int @default(0) @map("usage_count")
|
|||
|
|
|
|||
|
|
// 状态
|
|||
|
|
status String @default("ACTIVE") // ACTIVE, ARCHIVED
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
tenant Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
|
|||
|
|
sourceCourse Course @relation(fields: [sourceCourseId], references: [id])
|
|||
|
|
lessons SchoolCourseLesson[]
|
|||
|
|
reservations SchoolCourseReservation[]
|
|||
|
|
|
|||
|
|
@@index([tenantId])
|
|||
|
|
@@index([sourceCourseId])
|
|||
|
|
@@map("school_courses")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.9 SchoolCourseLesson（校本课程）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 校本课程 ====================
|
|||
|
|
|
|||
|
|
model SchoolCourseLesson {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
schoolCourseId Int @map("school_course_id")
|
|||
|
|
sourceLessonId Int @map("source_lesson_id") // 基于的原始课程
|
|||
|
|
|
|||
|
|
// 调整类型
|
|||
|
|
lessonType String @map("lesson_type")
|
|||
|
|
|
|||
|
|
// 调整后的内容
|
|||
|
|
objectives String? @db.Text
|
|||
|
|
preparation String? @db.Text
|
|||
|
|
extension String? @db.Text
|
|||
|
|
reflection String? @db.Text
|
|||
|
|
|
|||
|
|
// 调整说明
|
|||
|
|
changeNote String? @map("change_note") @db.Text
|
|||
|
|
|
|||
|
|
// 环节数据（JSON，调整后的）
|
|||
|
|
stepsData String? @map("steps_data") @db.Text
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
schoolCourse SchoolCourse @relation(fields: [schoolCourseId], references: [id], onDelete: Cascade)
|
|||
|
|
|
|||
|
|
@@unique([schoolCourseId, lessonType])
|
|||
|
|
@@map("school_course_lessons")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.10 SchoolCourseReservation（校本课程预约）
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 校本课程预约 ====================
|
|||
|
|
|
|||
|
|
model SchoolCourseReservation {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
schoolCourseId Int @map("school_course_id")
|
|||
|
|
|
|||
|
|
// 预约信息
|
|||
|
|
teacherId Int @map("teacher_id")
|
|||
|
|
classId Int @map("class_id")
|
|||
|
|
|
|||
|
|
// 时间
|
|||
|
|
scheduledDate DateTime @map("scheduled_date")
|
|||
|
|
scheduledTime String? @map("scheduled_time") // "10:00-10:30"
|
|||
|
|
|
|||
|
|
// 状态
|
|||
|
|
status String @default("PENDING") // PENDING, CONFIRMED, COMPLETED, CANCELLED
|
|||
|
|
|
|||
|
|
// 备注
|
|||
|
|
note String? @db.Text
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
|
|||
|
|
// 关联
|
|||
|
|
schoolCourse SchoolCourse @relation(fields: [schoolCourseId], references: [id], onDelete: Cascade)
|
|||
|
|
|
|||
|
|
@@index([schoolCourseId, scheduledDate])
|
|||
|
|
@@index([teacherId, scheduledDate])
|
|||
|
|
@@map("school_course_reservations")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、重构表设计
|
|||
|
|
|
|||
|
|
### 4.1 Course（课程包）- 重构
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// ==================== 课程包（重构） ====================
|
|||
|
|
|
|||
|
|
model Course {
|
|||
|
|
id Int @id @default(autoincrement())
|
|||
|
|
|
|||
|
|
// ========== 新增字段 ==========
|
|||
|
|
|
|||
|
|
// 主题（关联主题字典）
|
|||
|
|
themeId Int? @map("theme_id")
|
|||
|
|
|
|||
|
|
// 核心内容
|
|||
|
|
coreContent String? @map("core_content") @db.Text
|
|||
|
|
|
|||
|
|
// 课程介绍（8个富文本字段）
|
|||
|
|
introSummary String? @map("intro_summary") @db.Text // 课程简介
|
|||
|
|
introHighlights String? @map("intro_highlights") @db.Text // 课程亮点
|
|||
|
|
introGoals String? @map("intro_goals") @db.Text // 课程总目标
|
|||
|
|
introSchedule String? @map("intro_schedule") @db.Text // 课程内容安排
|
|||
|
|
introKeyPoints String? @map("intro_key_points") @db.Text // 教学重难点
|
|||
|
|
introMethods String? @map("intro_methods") @db.Text // 教学方法
|
|||
|
|
introEvaluation String? @map("intro_evaluation") @db.Text // 评价方式
|
|||
|
|
introNotes String? @map("intro_notes") @db.Text // 注意事项
|
|||
|
|
|
|||
|
|
// 排课计划参考（表格数据）
|
|||
|
|
scheduleRefData String? @map("schedule_ref_data") @db.Text // JSON数组
|
|||
|
|
|
|||
|
|
// 是否有集体课（用于判断是否配置了核心课程）
|
|||
|
|
hasCollectiveLesson Boolean @default(false) @map("has_collective_lesson")
|
|||
|
|
|
|||
|
|
// ========== 保留字段 ==========
|
|||
|
|
|
|||
|
|
name String
|
|||
|
|
description String?
|
|||
|
|
|
|||
|
|
pictureBookId Int? @map("picture_book_id")
|
|||
|
|
pictureBookName String? @map("picture_book_name")
|
|||
|
|
coverImagePath String? @map("cover_image_path")
|
|||
|
|
|
|||
|
|
// 兼容旧版：数字资源（后续迁移到CourseLesson）
|
|||
|
|
ebookPaths String? @map("ebook_paths")
|
|||
|
|
audioPaths String? @map("audio_paths")
|
|||
|
|
videoPaths String? @map("video_paths")
|
|||
|
|
otherResources String? @map("other_resources")
|
|||
|
|
|
|||
|
|
// 兼容旧版：教学材料（后续迁移到CourseLesson）
|
|||
|
|
pptPath String? @map("ppt_path")
|
|||
|
|
pptName String? @map("ppt_name")
|
|||
|
|
posterPaths String? @map("poster_paths")
|
|||
|
|
tools String? @map("tools")
|
|||
|
|
studentMaterials String? @map("student_materials")
|
|||
|
|
|
|||
|
|
// 兼容旧版：课堂计划（后续迁移到CourseLesson+LessonStep）
|
|||
|
|
lessonPlanData String? @map("lesson_plan_data")
|
|||
|
|
|
|||
|
|
// 兼容旧版：延伸活动（后续迁移到领域课）
|
|||
|
|
activitiesData String? @map("activities_data")
|
|||
|
|
|
|||
|
|
// 兼容旧版：测评工具（后续迁移到CourseLesson）
|
|||
|
|
assessmentData String? @map("assessment_data")
|
|||
|
|
|
|||
|
|
gradeTags String @default("[]") @map("grade_tags")
|
|||
|
|
domainTags String @default("[]") @map("domain_tags")
|
|||
|
|
|
|||
|
|
duration Int @default(25)
|
|||
|
|
|
|||
|
|
status String @default("DRAFT")
|
|||
|
|
version String @default("1.0")
|
|||
|
|
|
|||
|
|
submittedAt DateTime? @map("submitted_at")
|
|||
|
|
submittedBy Int? @map("submitted_by")
|
|||
|
|
reviewedAt DateTime? @map("reviewed_at")
|
|||
|
|
reviewedBy Int? @map("reviewed_by")
|
|||
|
|
reviewComment String? @map("review_comment")
|
|||
|
|
reviewChecklist String? @map("review_checklist")
|
|||
|
|
|
|||
|
|
parentId Int? @map("parent_id")
|
|||
|
|
isLatest Boolean @default(true)
|
|||
|
|
|
|||
|
|
usageCount Int @default(0) @map("usage_count")
|
|||
|
|
teacherCount Int @default(0) @map("teacher_count")
|
|||
|
|
avgRating Float @default(0) @map("avg_rating")
|
|||
|
|
|
|||
|
|
createdBy Int? @map("created_by")
|
|||
|
|
|
|||
|
|
createdAt DateTime @default(now()) @map("created_at")
|
|||
|
|
updatedAt DateTime @updatedAt @map("updated_at")
|
|||
|
|
publishedAt DateTime? @map("published_at")
|
|||
|
|
|
|||
|
|
// ========== 关联 ==========
|
|||
|
|
|
|||
|
|
theme Theme? @relation(fields: [themeId], references: [id])
|
|||
|
|
|
|||
|
|
// 新增关联
|
|||
|
|
packageCourses CoursePackageCourse[]
|
|||
|
|
lessons CourseLesson[]
|
|||
|
|
schoolCourses SchoolCourse[]
|
|||
|
|
|
|||
|
|
// 保留关联
|
|||
|
|
resources CourseResource[]
|
|||
|
|
scripts CourseScript[] // 废弃但保留
|
|||
|
|
activities CourseActivity[] // 废弃但保留
|
|||
|
|
tenantCourses TenantCourse[]
|
|||
|
|
versions CourseVersion[]
|
|||
|
|
lessons_rel Lesson[] // 授课记录
|
|||
|
|
tasks Task[]
|
|||
|
|
taskTemplates TaskTemplate[]
|
|||
|
|
schedulePlans SchedulePlan[]
|
|||
|
|
scheduleTemplates ScheduleTemplate[]
|
|||
|
|
|
|||
|
|
@@index([themeId])
|
|||
|
|
@@index([status])
|
|||
|
|
@@map("courses")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.2 Tenant（租户）- 新增关联
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// 在 Tenant 模型中新增关联
|
|||
|
|
|
|||
|
|
model Tenant {
|
|||
|
|
// ... 保留原有字段 ...
|
|||
|
|
|
|||
|
|
// 新增关联
|
|||
|
|
packages TenantPackage[]
|
|||
|
|
schoolCourses SchoolCourse[]
|
|||
|
|
|
|||
|
|
// ... 保留其他关联 ...
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4.3 CourseResource（课程资源）- 新增关联
|
|||
|
|
|
|||
|
|
```prisma
|
|||
|
|
// 在 CourseResource 模型中新增关联
|
|||
|
|
|
|||
|
|
model CourseResource {
|
|||
|
|
// ... 保留原有字段 ...
|
|||
|
|
|
|||
|
|
// 新增关联
|
|||
|
|
stepResources LessonStepResource[]
|
|||
|
|
|
|||
|
|
@@map("course_resources")
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、废弃表处理
|
|||
|
|
|
|||
|
|
### 5.1 废弃策略
|
|||
|
|
|
|||
|
|
| 表名 | 废弃方式 | 说明 |
|
|||
|
|
|-----|---------|------|
|
|||
|
|
| CourseScript | 保留，标记废弃 | 数据迁移后不删除，保留历史记录 |
|
|||
|
|
| CourseScriptPage | 保留，标记废弃 | 数据迁移后不删除，保留历史记录 |
|
|||
|
|
| CourseActivity | 保留，标记废弃 | 数据迁移后不删除，保留历史记录 |
|
|||
|
|
|
|||
|
|
### 5.2 数据迁移说明
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
数据迁移映射：
|
|||
|
|
|
|||
|
|
CourseScript → CourseLesson + LessonStep
|
|||
|
|
├─ stepName → LessonStep.name
|
|||
|
|
├─ teacherScript → LessonStep.content
|
|||
|
|
├─ duration → LessonStep.duration
|
|||
|
|
├─ objective → LessonStep.objective
|
|||
|
|
└─ resourceIds → LessonStepResource 关联
|
|||
|
|
|
|||
|
|
CourseScriptPage → LessonStep（合入）
|
|||
|
|
├─ questions → LessonStep.content
|
|||
|
|
└─ teacherNotes → LessonStep.content
|
|||
|
|
|
|||
|
|
CourseActivity → CourseLesson（领域课）
|
|||
|
|
├─ name → CourseLesson.name
|
|||
|
|
├─ activityGuide → CourseLesson.extension
|
|||
|
|
└─ domain → CourseLesson.lessonType
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、迁移方案
|
|||
|
|
|
|||
|
|
### 6.1 迁移步骤
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Phase 1: 创建新表（不删除旧表）
|
|||
|
|
├─ 创建 Theme 表
|
|||
|
|
├─ 创建 CoursePackage 表
|
|||
|
|
├─ 创建 CoursePackageCourse 表
|
|||
|
|
├─ 创建 TenantPackage 表
|
|||
|
|
├─ 创建 CourseLesson 表
|
|||
|
|
├─ 创建 LessonStep 表
|
|||
|
|
├─ 创建 LessonStepResource 表
|
|||
|
|
├─ 创建 SchoolCourse 表
|
|||
|
|
├─ 创建 SchoolCourseLesson 表
|
|||
|
|
└─ 创建 SchoolCourseReservation 表
|
|||
|
|
|
|||
|
|
Phase 2: 修改现有表
|
|||
|
|
├─ Course 表新增字段（themeId, coreContent, intro* 等）
|
|||
|
|
├─ CourseResource 表保持不变
|
|||
|
|
├─ Tenant 表新增关联
|
|||
|
|
└─ 其他表保持不变
|
|||
|
|
|
|||
|
|
Phase 3: 数据迁移
|
|||
|
|
├─ 初始化 Theme 字典数据
|
|||
|
|
├─ 为现有 Course 创建默认的 CourseLesson
|
|||
|
|
├─ 迁移 CourseScript → CourseLesson + LessonStep
|
|||
|
|
├─ 迁移 CourseActivity → CourseLesson（领域课）
|
|||
|
|
└─ 更新统计字段
|
|||
|
|
|
|||
|
|
Phase 4: 应用层适配
|
|||
|
|
├─ 更新 API 接口
|
|||
|
|
├─ 更新前端页面
|
|||
|
|
└─ 测试验证
|
|||
|
|
|
|||
|
|
Phase 5: 清理（可选）
|
|||
|
|
├─ 标记旧表为废弃
|
|||
|
|
└─ 评估是否需要删除旧表数据
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 6.2 安全措施
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
// 迁移前备份
|
|||
|
|
async function backupBeforeMigration() {
|
|||
|
|
// 1. 导出关键表数据
|
|||
|
|
const courses = await prisma.course.findMany();
|
|||
|
|
const scripts = await prisma.courseScript.findMany();
|
|||
|
|
const activities = await prisma.courseActivity.findMany();
|
|||
|
|
|
|||
|
|
// 2. 保存到文件
|
|||
|
|
fs.writeFileSync('backup/courses.json', JSON.stringify(courses));
|
|||
|
|
fs.writeFileSync('backup/scripts.json', JSON.stringify(scripts));
|
|||
|
|
fs.writeFileSync('backup/activities.json', JSON.stringify(activities));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 迁移脚本示例
|
|||
|
|
async function migrateCourseToNewStructure(courseId: number) {
|
|||
|
|
const course = await prisma.course.findUnique({
|
|||
|
|
where: { id: courseId },
|
|||
|
|
include: {
|
|||
|
|
scripts: { orderBy: { stepIndex: 'asc' } },
|
|||
|
|
activities: true
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
if (!course) return;
|
|||
|
|
|
|||
|
|
// 1. 创建集体课（如果有脚本数据）
|
|||
|
|
if (course.scripts.length > 0) {
|
|||
|
|
const collectiveLesson = await prisma.courseLesson.create({
|
|||
|
|
data: {
|
|||
|
|
courseId: course.id,
|
|||
|
|
lessonType: 'COLLECTIVE',
|
|||
|
|
name: `${course.name} - 集体课`,
|
|||
|
|
duration: course.duration,
|
|||
|
|
useTemplate: true,
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// 2. 迁移脚本为环节
|
|||
|
|
for (const script of course.scripts) {
|
|||
|
|
await prisma.lessonStep.create({
|
|||
|
|
data: {
|
|||
|
|
lessonId: collectiveLesson.id,
|
|||
|
|
name: script.stepName,
|
|||
|
|
content: script.teacherScript || '',
|
|||
|
|
duration: script.duration,
|
|||
|
|
objective: script.objective,
|
|||
|
|
resourceIds: script.resourceIds,
|
|||
|
|
sortOrder: script.stepIndex,
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 3. 迁移延伸活动为领域课
|
|||
|
|
for (const activity of course.activities) {
|
|||
|
|
const lessonType = mapDomainToLessonType(activity.domain);
|
|||
|
|
await prisma.courseLesson.create({
|
|||
|
|
data: {
|
|||
|
|
courseId: course.id,
|
|||
|
|
lessonType: lessonType,
|
|||
|
|
name: activity.name,
|
|||
|
|
duration: activity.duration || 25,
|
|||
|
|
extension: activity.activityGuide,
|
|||
|
|
sortOrder: activity.sortOrder,
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 4. 更新课程包标记
|
|||
|
|
await prisma.course.update({
|
|||
|
|
where: { id: courseId },
|
|||
|
|
data: { hasCollectiveLesson: course.scripts.length > 0 }
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 领域映射
|
|||
|
|
function mapDomainToLessonType(domain: string | null): string {
|
|||
|
|
const mapping: Record<string, string> = {
|
|||
|
|
'语言': 'LANGUAGE',
|
|||
|
|
'健康': 'HEALTH',
|
|||
|
|
'科学': 'SCIENCE',
|
|||
|
|
'社会': 'SOCIAL',
|
|||
|
|
'艺术': 'ART',
|
|||
|
|
};
|
|||
|
|
return mapping[domain || ''] || 'LANGUAGE';
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、API变更说明
|
|||
|
|
|
|||
|
|
### 7.1 新增API
|
|||
|
|
|
|||
|
|
| 模块 | 路径 | 说明 |
|
|||
|
|
|-----|------|------|
|
|||
|
|
| 套餐管理 | `POST /admin/packages` | 创建套餐 |
|
|||
|
|
| 套餐管理 | `PUT /admin/packages/:id/courses` | 添加课程包到套餐 |
|
|||
|
|
| 课程管理 | `POST /admin/courses/:id/lessons` | 创建课程 |
|
|||
|
|
| 课程管理 | `POST /admin/courses/:id/lessons/:lessonId/steps` | 创建教学环节 |
|
|||
|
|
| 学校端 | `POST /school/school-courses` | 创建校本课程包 |
|
|||
|
|
| 学校端 | `POST /school/school-courses/:id/reservations` | 预约校本课程 |
|
|||
|
|
|
|||
|
|
### 7.2 修改API
|
|||
|
|
|
|||
|
|
| 模块 | 路径 | 变更说明 |
|
|||
|
|
|-----|------|---------|
|
|||
|
|
| 课程包详情 | `GET /teacher/courses/:id` | 返回新结构数据 |
|
|||
|
|
| 备课模式 | `GET /teacher/courses/:id/lessons` | 按课程维度获取 |
|
|||
|
|
| 上课模式 | `POST /teacher/lessons/start` | 支持选择课程 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 八、后续优化建议
|
|||
|
|
|
|||
|
|
### 8.1 性能优化
|
|||
|
|
|
|||
|
|
- 为常用查询字段添加索引
|
|||
|
|
- 考虑将富文本字段拆分到单独表（如果内容过大）
|
|||
|
|
- 使用Redis缓存热点数据
|
|||
|
|
|
|||
|
|
### 8.2 扩展性考虑
|
|||
|
|
|
|||
|
|
- 课程类型可使用枚举定义
|
|||
|
|
- 考虑支持自定义课程类型
|
|||
|
|
- 校本课程包的版本管理
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*本文档创建于 2026-02-27*
|
|||
|
|
*基于需求文档：17-课程包套餐重构需求.md*
|