# 课程关联日历命令使用说明

## 功能描述

这个Laravel命令 `LinkCoursesToCalendar` 用于将指定的课程列表自动关联到`calendars`日历表中。

## 主要功能

1. **批量课程关联**: 一次性处理69个指定的课程
2. **智能匹配**: 支持精确匹配、模糊匹配和相似度匹配三种策略
3. **重复检查**: 自动检查并跳过已存在日历记录的课程
4. **事务保护**: 使用数据库事务确保数据一致性
5. **详细统计**: 提供完整的处理结果统计

## 命令使用方法

### 基本用法
```bash
php artisan link:courses-to-calendar
```

## 课程列表

命令会处理以下69个课程：

### 高研班系列
- 高研班｜第四期高级科创人才研修班-第七模块
- 高研班｜第五期高级科创人才研修班-第五模块
- 高研班｜第六期高级科创人才研修班-第三模块
- 高研班｜第五期高级科创人才研修班-毕业模块
- 高研班｜第四期高级科创人才研修班-第八模块
- ... (共29个高研班课程)

### 第二课堂系列
- 第二课堂｜走进珂玛科技
- 第二课堂｜走进世华科技
- 第二课堂｜走进姑苏区
- 第二课堂｜走进科沃斯
- ... (共17个第二课堂课程)

### 其他培训类
- 人才培训、初创班、攀峰班、产业加速营、专题培训等 (共23个课程)

## 匹配策略

### 1. 精确匹配
直接匹配courses表中的name字段

### 2. 模糊匹配
使用LIKE查询进行部分匹配

### 3. 相似度匹配
- 使用Levenshtein算法计算字符串相似度
- 最低相似度阈值：30%
- 自动选择相似度最高的课程

## 日历记录创建

为每个匹配的课程创建以下日历记录：

```php
[
    'type' => 1,                    // 类型1为课程
    'course_id' => $course->id,     // 关联的课程ID
    'date' => $course->start_date,  // 课程开始日期
    'title' => $course->name,       // 课程标题
    'content' => $course->content,  // 课程内容
    'start_time' => '09:00:00',     // 默认开始时间
    'end_time' => '17:00:00',       // 默认结束时间
    'url' => $course->url,          // 课程链接
]
```

## 输出示例

```
开始将课程关联到calendars日历表...
总共需要处理 69 个课程
正在处理课程: 第三期：张平院士— 6G通信与AI融合
✓ 找到匹配课程: 第三期：张平院士— 6G通信与AI融合 (ID: 123)
✓ 成功创建日历记录 (ID: 456) 关联课程: 第三期：张平院士— 6G通信与AI融合

正在处理课程: 高研班｜第四期高级科创人才研修班-第七模块
通过模糊匹配找到课程: '第四期高级科创人才研修班-第七模块'
✓ 成功创建日历记录 (ID: 457) 关联课程: 第四期高级科创人才研修班-第七模块

============================================================
处理完成！
成功关联课程数量: 65
已存在日历记录: 2
未找到匹配课程: 2

未找到匹配的课程列表:
  - 某个未找到的课程1
  - 某个未找到的课程2

已存在日历记录的课程列表:
  - 某个已存在的课程1
  - 某个已存在的课程2
```

## 安全特性

1. **数据库事务**: 所有操作在事务中执行，出错时自动回滚
2. **重复检查**: 防止创建重复的日历记录
3. **软删除过滤**: 只处理未被软删除的课程
4. **错误处理**: 完善的异常处理机制

## 注意事项

1. **备份数据**: 建议执行前备份`calendars`表数据
2. **权限检查**: 确保数据库连接正常，有足够的读写权限
3. **课程匹配**: 相似度匹配可能不是100%准确，建议执行后检查结果
4. **重复执行**: 命令可以安全地重复执行，已存在的记录会被跳过

## 错误处理

命令包含完善的错误处理机制：
- 数据库连接错误处理
- 事务回滚保护
- 详细的错误日志输出
- 匹配失败统计

## 数据库表要求

### courses表
- `id`: 主键
- `name`: 课程名称
- `start_date`: 开始日期
- `end_date`: 结束日期
- `content`: 课程内容
- `url`: 课程链接
- `deleted_at`: 软删除时间戳

### calendars表
- `type`: 类型（1=课程，2=课堂，3=事件）
- `course_id`: 关联的课程ID
- `date`: 日期
- `title`: 标题
- `content`: 内容
- `start_time`: 开始时间
- `end_time`: 结束时间
- `url`: 链接