# 课程发布流程完善方案

> 创建时间：2026-02-13
> 状态：✅ 已实现（2026-02-13）

---

## 一、现状分析

### 1.1 当前实现

| 方面 | 现状 |
|------|------|
| 课程状态 | DRAFT / REVIEWING（未实现） / PUBLISHED / ARCHIVED |
| 发布流程 | 草稿 → 直接发布（无审核） |
| 授权机制 | 发布时自动授权给所有活跃租户 |
| 验证逻辑 | 仅前端表单验证，无后端完整性校验 |
| 版本管理 | 有字段但未实现功能 |

### 1.2 与需求的差距

| 需求（来自设计文档） | 当前状态 |
|---------------------|---------|
| 草稿 → 审核中 → 已发布 状态流转 | ❌ 未实现审核环节 |
| 审核检查项（完整性、科学性等） | ❌ 未实现 |
| 审核意见记录 | ❌ 未实现 |
| 版本迭代机制 | ❌ 未实现 |
| 按租户细粒度授权 | ❌ 当前是全量授权 |

---

## 二、状态流转设计

### 2.1 状态流转图

```
┌─────────┐  保存   ┌─────────┐  提交   ┌─────────┐  通过   ┌─────────┐
│  新建   │ ──────▶ │  草稿   │ ──────▶ │ 审核中  │ ──────▶ │ 已发布  │
└─────────┘         └─────────┘         └─────────┘         └─────────┘
                         │                   │                   │
                         │                   │ 驳回              │ 下架
                         │                   ▼                   ▼
                         │              ┌─────────┐         ┌─────────┐
                         └─────────────▶│ 已驳回  │         │ 已下架  │
                                        └─────────┘         └─────────┘
                                             │                   │
                                             │ 重新提交          │ 重新发布
                                             └───────────┬───────┘
                                                         ▼
                                                    ┌─────────┐
                                                    │ 审核中  │
                                                    └─────────┘
```

### 2.2 状态说明

| 状态 | 英文标识 | 说明 | 允许操作 |
|------|---------|------|---------|
| 草稿 | DRAFT | 制作中，未提交审核 | 保存、编辑、删除、提交审核 |
| 审核中 | PENDING | 已提交，等待审核 | 查看详情、撤销审核 |
| 已驳回 | REJECTED | 审核未通过 | 查看驳回原因、修改后重新提交 |
| 已发布 | PUBLISHED | 审核通过，教师可见 | 下架、迭代新版本 |
| 已下架 | ARCHIVED | 暂停使用 | 重新发布 |

---

## 三、发布前验证检查

### 3.1 自动验证项（提交时强制校验）

| 检查项 | 验证规则 | 错误级别 | 提示信息 |
|--------|----------|---------|---------|
| 课程名称 | 非空，2-50字符 | 🔴 阻断 | "请输入课程名称" |
| 适用年级 | 至少选择1个年级 | 🔴 阻断 | "请选择适用年级" |
| 课程时长 | 5-60分钟 | 🔴 阻断 | "课程时长需在5-60分钟之间" |
| 封面图片 | 必须上传 | 🔴 阻断 | "请上传课程封面" |
| 数字资源 | 至少1个资源 | 🟡 警告 | "建议上传至少1个数字资源" |
| 教学流程 | 至少1个环节 | 🔴 阻断 | "请配置教学流程" |
| 版权声明 | 需确认 | 🔴 阻断 | "请确认版权合规" |

### 3.2 人工审核项（审核员手动确认）

| 检查项 | 说明 | 审核要点 |
|--------|------|---------|
| 教学科学性 | 教学目标、流程符合幼儿教育规律 | 目标明确、环节合理、符合幼儿认知水平 |
| 素材质量 | 音视频清晰度、课件美观度 | 分辨率达标、设计美观、无明显错误 |
| 标签准确性 | 领域、年级标签是否准确 | 领域分类正确、年级定位准确 |
| 版权合规 | 所有素材有合法版权 | 素材来源合法、已获得授权 |
| 内容安全 | 无敏感、不当内容 | 符合内容安全规范 |

---

## 四、审核流程设计

### 4.1 审核页面原型

```
┌─────────────────────────────────────────────────────────────────┐
│ 课程审核页面                                                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ 课程：《好饿的毛毛虫》完整阅读活动                               │
│ 提交人：张教研 | 提交时间：2026-02-13 10:30                      │
│                                                                 │
│ ━━ 自动检查项 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│
│ ✅ 基本信息完整                                                 │
│ ✅ 封面图片已上传                                               │
│ ✅ 数字资源：电子绘本1个、音频1个                               │
│ ✅ 教学流程：5个环节                                            │
│                                                                 │
│ ━━ 人工审核项 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│
│ ☐ 教学科学性符合要求                                           │
│ ☐ 素材质量达标                                                 │
│ ☐ 标签分类准确                                                 │
│ ☐ 版权合规                                                     │
│                                                                 │
│ ━━ 审核意见 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│
│ [_______________________________________________]               │
│ [_______________________________________________]               │
│                                                                 │
│ [✓ 通过并发布] [✗ 驳回] [暂存待讨论]                            │
└─────────────────────────────────────────────────────────────────┘
```

### 4.2 审核结果处理

| 审核结果 | 状态变更 | 后续操作 |
|---------|---------|---------|
| 通过并发布 | PENDING → PUBLISHED | 自动授权给租户，发送通知 |
| 驳回 | PENDING → REJECTED | 记录驳回原因，通知提交人 |
| 暂存待讨论 | 保持 PENDING | 记录讨论意见，等待确认 |

---

## 五、版本管理机制

### 5.1 版本号规则

| 版本类型 | 版本号变化 | 说明 | 示例 |
|---------|-----------|------|------|
| 小优化 | x.x.+1 | 修改文案、优化素材 | v1.0.0 → v1.0.1 |
| 功能更新 | x.+1.0 | 增加环节、修改流程 | v1.0.0 → v1.1.0 |
| 大改版 | +1.0.0 | 重新设计、全新版本 | v1.0.0 → v2.0.0 |

### 5.2 版本迭代流程

```
已发布课程 v1.0
     │
     ├─▶ 点击"迭代新版本"
     │       │
     │       ▼
     │   复制为新草稿 v2.0
     │       │
     │       ▼
     │   编辑修改 → 提交审核 → 发布
     │       │
     │       ▼
     │   v2.0 成为最新版本
     │   v1.0 保留历史记录
     │
     └─▶ 历史版本可查看但不可编辑
```

### 5.3 版本数据模型

```prisma
model CourseVersion {
  id             Int      @id @default(autoincrement())
  courseId       Int
  course         Course   @relation(fields: [courseId], references: [id])
  version        String                // 版本号，如 "1.0.0"
  snapshotData   String                // JSON快照（完整课程内容）
  changeLog      String?               // 变更说明
  publishedAt    DateTime @default(now())
  publishedBy    Int
  publisher      User     @relation(fields: [publishedBy], references: [id])

  @@index([courseId])
}
```

---

## 六、授权机制优化

### 6.1 当前授权方式

- 发布时自动授权给**所有活跃租户**
- 下架时取消**所有租户**授权
- 无法按套餐或指定租户控制

### 6.2 优化后的授权选项

```
┌─────────────────────────────────────────────────────────────────┐
│ 授权配置                                                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ ○ 全量授权（所有活跃租户）                                       │
│   适用场景：通用课程，适合所有幼儿园                             │
│                                                                 │
│ ○ 按套餐授权                                                    │
│   ☐ 基础套餐租户（约50个课程包）                                │
│   ☐ 标准套餐租户（约150个课程包）                               │
│   ☑ 高级套餐租户（不限）                                        │
│   适用场景：高级课程，仅限付费更高的用户                         │
│                                                                 │
│ ○ 指定租户授权                                                  │
│   [搜索租户...]                                                 │
│   ☑ 阳光幼儿园                                                 │
│   ☑ 花儿朵朵幼儿园                                             │
│   ☐ 蓝天双语幼儿园                                             │
│   适用场景：定制课程，仅限特定客户                               │
│                                                                 │
│ [确认发布] [取消]                                                │
└─────────────────────────────────────────────────────────────────┘
```

### 6.3 授权数据模型

```prisma
model TenantCourse {
  id           Int      @id @default(autoincrement())
  tenantId     Int
  tenant       Tenant   @relation(fields: [tenantId], references: [id])
  courseId     Int
  course       Course   @relation(fields: [courseId], references: [id])
  authorized   Boolean  @default(true)
  authorizedAt DateTime @default(now())
  authorizedBy Int?                  // 授权操作人
  packageType  String?               // 授权来源套餐类型

  @@unique([tenantId, courseId])
  @@index([tenantId])
  @@index([courseId])
}
```

---

## 七、技术实现方案

### 7.1 数据库变更

```prisma
// Course 模型变更
model Course {
  id              Int      @id @default(autoincrement())
  // ... 现有字段 ...

  // 状态相关（新增/修改）
  status          CourseStatus  @default(DRAFT)
  submittedAt     DateTime?     // 提交审核时间
  submittedBy     Int?          // 提交人ID
  reviewedAt      DateTime?     // 审核时间
  reviewedBy      Int?          // 审核人ID
  reviewComment   String?       // 审核意见
  reviewChecklist Json?         // 审核检查项结果 [{item, passed, comment}]

  // 版本相关（新增）
  version         String        @default("1.0.0")
  parentId        Int?          // 父版本ID
  isLatest        Boolean       @default(true)  // 是否最新版本

  // 关联
  submitter       User?         @relation("CourseSubmitter", fields: [submittedBy], references: [id])
  reviewer        User?         @relation("CourseReviewer", fields: [reviewedBy], references: [id])
  parent          Course?       @relation("CourseVersions", fields: [parentId], references: [id])
  children        Course[]      @relation("CourseVersions")
  versions        CourseVersion[]

  @@index([status])
  @@index([parentId])
}

// 课程版本快照（新增）
model CourseVersion {
  id             Int      @id @default(autoincrement())
  courseId       Int
  course         Course   @relation(fields: [courseId], references: [id])
  version        String
  snapshotData   String   // JSON格式的课程完整内容快照
  changeLog      String?  // 变更说明
  publishedAt    DateTime @default(now())
  publishedBy    Int
  publisher      User     @relation(fields: [publishedBy], references: [id])

  @@index([courseId])
}

// 课程状态枚举（修改）
enum CourseStatus {
  DRAFT       // 草稿
  PENDING     // 待审核（原 REVIEWING）
  REJECTED    // 已驳回
  PUBLISHED   // 已发布
  ARCHIVED    // 已下架
}
```

### 7.2 API 设计

| 方法 | 路径 | 说明 | 权限 |
|------|------|------|------|
| POST | `/api/v1/courses/:id/submit` | 提交审核 | 超管 |
| POST | `/api/v1/courses/:id/approve` | 审核通过并发布 | 超管（审核权限） |
| POST | `/api/v1/courses/:id/reject` | 审核驳回 | 超管（审核权限） |
| POST | `/api/v1/courses/:id/withdraw` | 撤销审核申请 | 超管（提交人） |
| POST | `/api/v1/courses/:id/publish` | 直接发布（绕过审核） | 超管（特殊权限） |
| POST | `/api/v1/courses/:id/unpublish` | 下架课程 | 超管 |
| POST | `/api/v1/courses/:id/iterate` | 创建新版本迭代 | 超管 |
| GET | `/api/v1/courses/:id/versions` | 获取版本历史 | 超管 |
| POST | `/api/v1/courses/:id/validate` | 验证课程完整性 | 超管 |

### 7.3 API 请求/响应示例

#### 提交审核

```typescript
// POST /api/v1/courses/:id/submit
// Request
{
  "copyrightConfirmed": true  // 确认版权合规
}

// Response
{
  "success": true,
  "data": {
    "id": 1,
    "status": "PENDING",
    "submittedAt": "2026-02-13T10:30:00Z"
  }
}
```

#### 审核通过

```typescript
// POST /api/v1/courses/:id/approve
// Request
{
  "checklist": [
    { "item": "教学科学性", "passed": true, "comment": "教学设计合理" },
    { "item": "素材质量", "passed": true, "comment": "" },
    { "item": "标签准确性", "passed": true, "comment": "" },
    { "item": "版权合规", "passed": true, "comment": "已确认" }
  ],
  "comment": "审核通过，课程设计优秀",
  "authOption": "all"  // all | package | specific
}

// Response
{
  "success": true,
  "data": {
    "id": 1,
    "status": "PUBLISHED",
    "publishedAt": "2026-02-13T11:00:00Z",
    "authorizedTenants": 128
  }
}
```

#### 审核驳回

```typescript
// POST /api/v1/courses/:id/reject
// Request
{
  "checklist": [
    { "item": "教学科学性", "passed": true, "comment": "" },
    { "item": "素材质量", "passed": false, "comment": "音频清晰度不足" },
    { "item": "标签准确性", "passed": true, "comment": "" },
    { "item": "版权合规", "passed": true, "comment": "" }
  ],
  "comment": "请更换高清音频文件后重新提交"
}

// Response
{
  "success": true,
  "data": {
    "id": 1,
    "status": "REJECTED",
    "reviewedAt": "2026-02-13T11:00:00Z"
  }
}
```

---

## 八、前端改造方案

### 8.1 课程列表状态标签

```
┌──────────┬─────────────────────────────────────────────────────────┐
│ 状态     │ 操作按钮                                                │
├──────────┼─────────────────────────────────────────────────────────┤
│ 🟡 草稿  │ [编辑] [删除] [提交审核]                                │
│ 🔵 审核中│ [查看] [撤销]                                           │
│ 🔴 已驳回│ [查看] [查看驳回原因] [重新编辑] [重新提交]              │
│ 🟢 已发布│ [查看] [编辑] [下架] [迭代新版本] [查看数据]            │
│ ⚫ 已下架│ [查看] [重新发布] [查看数据]                            │
└──────────┴─────────────────────────────────────────────────────────┘
```

### 8.2 课程编辑页面

**底部操作栏改造：**

```
┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   [上一步] [下一步] [保存草稿] [预览] [提交审核]                 │
│                                                                 │
│   注：提交审核前请确保：                                         │
│   ☐ 已上传封面图片                                              │
│   ☐ 已配置教学流程                                              │
│   ☐ 已确认版权合规                                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

### 8.3 审核管理页面（新增）

```
┌──────────────────────────────────────────────────────────────────────┐
│ 审核管理                                         待审核: 5 门课程    │
├──────────────────────────────────────────────────────────────────────┤
│ 筛选：状态：[待审核 ▼]  提交人：[全部 ▼]  时间：[最近7天 ▼]        │
│                                                                      │
│ ┌────┬────────────────┬─────────┬───────────┬──────────┬──────────┐ │
│ │序号│  课程名称       │ 提交人  │ 提交时间   │ 自动检查  │  操作    │ │
│ ├────┼────────────────┼─────────┼───────────┼──────────┼──────────┤ │
│ │ 1  │好饿的毛毛虫    │ 张教研  │02-13 10:30│ ✅ 全部通过│[审核]   │ │
│ ├────┼────────────────┼─────────┼───────────┼──────────┼──────────┤ │
│ │ 2  │猜猜我有多爱你  │ 李教研  │02-12 15:20│ ⚠️ 有警告 │[审核]   │ │
│ ├────┼────────────────┼─────────┼───────────┼──────────┼──────────┤ │
│ │ 3  │逃家小兔        │ 王教研  │02-11 09:00│ ❌ 有错误 │[查看]   │ │
│ │    │                │         │           │          │[退回修改]│ │
│ └────┴────────────────┴─────────┴───────────┴──────────┴──────────┘ │
└──────────────────────────────────────────────────────────────────────┘
```

---

## 九、实施计划

### 9.1 阶段划分

| 阶段 | 功能 | 优先级 | 预估工作量 | 依赖 |
|------|------|--------|-----------|------|
| **P0** | 发布前完整性验证 | 🔴 高 | 1天 | 无 |
| **P0** | 审核状态流转 | 🔴 高 | 2天 | P0验证 |
| **P0** | 前端状态标签和操作按钮 | 🔴 高 | 1天 | P0状态流转 |
| **P1** | 审核意见记录 | 🟡 中 | 1天 | P0 |
| **P1** | 驳回后重新提交流程 | 🟡 中 | 0.5天 | P1审核意见 |
| **P1** | 审核管理页面 | 🟡 中 | 1.5天 | P1 |
| **P2** | 版本迭代机制 | 🟢 低 | 2天 | P0 |
| **P2** | 版本历史快照 | 🟢 低 | 1天 | P2版本迭代 |
| **P3** | 细粒度授权控制 | 🟢 低 | 1.5天 | P0 |
| **P3** | 授权配置界面 | 🟢 低 | 1天 | P3授权 |

### 9.2 详细任务分解

#### 第一阶段（P0 - 核心流程）

**Day 1：发布前验证**
- [ ] 后端：实现课程完整性验证服务
- [ ] 后端：添加验证API端点
- [ ] 前端：验证提示UI组件
- [ ] 前端：提交前验证调用

**Day 2-3：审核状态流转**
- [ ] 数据库：添加新状态和字段
- [ ] 后端：实现 submit/approve/reject API
- [ ] 后端：状态变更通知逻辑
- [ ] 前端：课程列表状态标签
- [ ] 前端：操作按钮改造

**Day 4：前端完善**
- [ ] 前端：提交审核确认弹窗
- [ ] 前端：版权确认勾选
- [ ] 前端：验证未通过提示

#### 第二阶段（P1 - 审核完善）

**Day 5：审核意见**
- [ ] 数据库：添加审核意见字段
- [ ] 后端：保存审核检查项结果
- [ ] 前端：驳回原因展示

**Day 6：审核管理页面**
- [ ] 前端：审核列表页面
- [ ] 前端：审核详情页面
- [ ] 前端：审核操作交互

#### 第三阶段（P2/P3 - 扩展功能）

- 版本迭代机制
- 细粒度授权控制

---

## 十、待讨论问题

### 10.1 审核流程

- [x] 是否需要多人审核？还是单人审核即可？
  - **决策：单人审核即可**
  - 任一有审核权限的超管审核通过即可发布

- [x] 审核人是否可以审核自己提交的课程？
  - **决策：不允许自审**
  - 提交人和审核人不能是同一人，代码层面需要校验

- [ ] 是否需要审核超时自动提醒？
  - **决策：暂不实现**，后续根据需求迭代

### 10.2 发布权限

- [x] 是否允许超管绕过审核直接发布？
  - **决策：仅特定角色可绕过**
  - 超级管理员可绕过审核直接发布
  - 普通超管/教研人员仍需走审核流程

- [x] 直接发布是否需要二次确认？
  - **决策：需要**
  - 直接发布时需弹窗确认，显示跳过审核的提示

- [ ] 是否需要发布审批日志？
  - **决策：需要**
  - 记录所有发布操作，包括操作人、时间、方式（审核通过/直接发布）

### 10.3 版本策略

- [x] 新版本发布后，旧版本是否保留？
  - **决策：保留旧版本**
  - 学校可选择使用新版本或继续使用旧版本

- [x] 已使用旧版本上课的学校是否可以继续使用？
  - **决策：可以**
  - 新版本发布不影响已创建的授课记录

- [ ] 版本回滚是否需要支持？
  - **决策：暂不支持**
  - 如有问题可发布新修复版本

### 10.4 授权粒度

- [x] 是否需要立即实现细粒度授权？
  - **决策：暂不实现**
  - 保持当前全量授权方式（发布时授权给所有活跃租户）
  - 后续根据业务需求迭代

- [ ] 授权变更是否需要通知租户？
  - **决策：暂不实现**
  - 后续迭代时考虑

- [x] 是否支持定时授权（如：预约上线时间）？
  - **决策：暂不实现**
  - 发布后立即生效

---

## 十、已确认的开发范围

### 10.1 本次实现功能

| 功能 | 优先级 | 状态 |
|------|--------|------|
| 发布前完整性验证 | P0 | ✅ 已实现 |
| 审核状态流转（DRAFT → PENDING → PUBLISHED/REJECTED） | P0 | ✅ 已实现 |
| 单人审核机制（禁止自审） | P0 | ✅ 已实现 |
| 超级管理员直接发布权限 | P0 | ✅ 已实现 |
| 驳回后重新提交流程 | P1 | ✅ 已实现 |
| 审核意见记录 | P1 | ✅ 已实现 |
| 审核管理页面 | P1 | ✅ 已实现 |
| 版本迭代机制（保留旧版本） | P2 | ✅ 已实现 |
| 发布审批日志 | P1 | ✅ 已实现 |

### 10.2 暂不实现功能

| 功能 | 原因 | 预计迭代时间 |
|------|------|-------------|
| 多人审核流程 | 当前规模不需要 | 待定 |
| 细粒度授权控制 | 业务需求不明确 | 待定 |
| 预约上线时间 | 当前无需定时发布 | 待定 |
| 审核超时提醒 | 暂无强需求 | 待定 |
| 版本回滚 | 可通过发布新版解决 | 待定 |

---

## 十一、参考资料

1. [CMS内容审核工作流详解](https://www.woshipm.com/operate/4783399.html)
2. [课程审核与发布流程详解](https://blog.csdn.net/2201_75550069/article/details/149466534)
3. [企业课程管理系统2025评测](https://www.zdsztech.com/blog/qi-ye-ke-cheng-guan-li-xi-tong-na-jia-qiang-2025-nian-zui-zui-xin-ping/)
4. [October CMS内容工作流引擎](https://blog.csdn.net/gitblog_01198/article/details/153449487)
5. [在线课程管理系统开发实战](https://blog.csdn.net/H12131213/article/details/155601761)

---

## 十二、变更记录

| 日期 | 版本 | 变更内容 | 作者 |
|------|------|---------|------|
| 2026-02-13 | v1.0 | 初始版本 | Claude |
