huertian/jinduguanli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix:固定时间戳单位为秒

Browse Source
This commit is contained in:
huertian 2025-01-03 14:09:53 +08:00
parent f990f6b7a3
commit 6dd845cdd7
8 changed files with 303 additions and 267 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

298
API文档.md
View File

@ -56,11 +56,12 @@
### 课程任务相关字段
1. **进度状态 (progressStatus)**
- 0: 脚本上传
- 1: 脚本确认
- 2: 视频拍摄
- 3: 后期制作
- 4: 任务完成
- 0: 未开始
- 1: 脚本制作
- 2: 脚本审核
- 3: 脚本确认
- 4: 视频拍摄与制作
- 5: 视频确认
## 用户接口
@ -274,12 +275,12 @@
### 1. 获取课程任务列表
- **接口**：`GET /api/lesson-tasks`
- **描述**：分页获取课程任务列表
- **描述**：分页获取课程任务列表，可按用户筛选
- **认证**：需要
- **查询参数**：
- `page`: 页码（从 1 开始）
- `size`: 每页数量（默认 10）
- `userId`: 用户 ID（可选）
- `userId`: 用户ID（可选）
- **成功响应**：
```json
{
@ -288,27 +289,35 @@
"data": {
"content": [
{
"id": 6,
"courseName": "Test Course",
"microLessonName": "Test Lesson",
"userId": 12,
"progressStatus": 1,
"scriptUploadTime": 1734578081,
"scriptConfirmTime": 1734578081,
"videoCaptureTime": 1734578081,
"videoConfirmTime": 1734578081,
"finishTime": 1734578081,
"advise": "Test advice",
"createdAt": 1734578081,
"updatedAt": 1734578081
"id": 1,
"courseName": "数学",
"microLessonName": "数学1-1",
"userId": 1,
"progressStatus": 4,
"scriptCreateTime": 1734940587,
"scriptReviewTime": null,
"scriptConfirmTime": 1734940825,
"videoCreateTime": 1734940832,
"videoConfirmTime": 1734940837,
"finishTime": 1734940837,
"advise": "",
"createdAt": 1734674726,
"updatedAt": 1734940837
}
],
"totalElements": 4,
"pageable": {
"pageNumber": 0,
"pageSize": 10,
"sort": {
"empty": true,
"unsorted": true,
"sorted": false
}
},
"totalElements": 7,
"totalPages": 1,
"size": 10,
"number": 0,
"first": true,
"last": true,
"first": true,
"empty": false
}
}
@ -317,29 +326,30 @@
### 2. 获取单个课程任务
- **接口**：`GET /api/lesson-tasks/{id}`
- **描述**：获取指定 ID 的课程任务
- **描述**：根据ID获取课程任务详情
- **认证**：需要
- **路径参数**：
- `id`: 课程任务 ID
- `id`: 课程任务ID
- **成功响应**：
```json
{
"code": 10000,
"message": "成功",
"data": {
"id": 6,
"courseName": "Test Course",
"microLessonName": "Test Lesson",
"userId": 12,
"progressStatus": 1,
"scriptUploadTime": 1734578081,
"scriptConfirmTime": 1734578081,
"videoCaptureTime": 1734578081,
"videoConfirmTime": 1734578081,
"finishTime": 1734578081,
"advise": "Test advice",
"createdAt": 1734578081,
"updatedAt": 1734578081
"id": 1,
"courseName": "数学",
"microLessonName": "数学1-1",
"userId": 1,
"progressStatus": 4,
"scriptCreateTime": 1734940587,
"scriptReviewTime": null,
"scriptConfirmTime": 1734940825,
"videoCreateTime": 1734940832,
"videoConfirmTime": 1734940837,
"finishTime": 1734940837,
"advise": "",
"createdAt": 1734674726,
"updatedAt": 1734940837
}
}
```
@ -352,55 +362,10 @@
- **请求体**：
```json
{
"courseName": "Java基础", // 课程名称，不可为空
"microLessonName": "Java变量", // 微课名称，不可为空
"userId": 1, // 负责人ID，不可为空，关联users表
"advise": "请注意讲解速度" // 任务建议或备注，可选
}
```
- **成功响应**：
```json
{
"code": 10000,
"message": "成功",
"data": {
"id": 6,
"courseName": "Java基础",
"microLessonName": "Java变量",
"userId": 1,
"progressStatus": 1,
"scriptUploadTime": ,
"scriptConfirmTime": ,
"videoCaptureTime": ,
"videoConfirmTime": ,
"finishTime": ,
"advise": "请注意讲解速度",
"createdAt": 1734578081,
"updatedAt": 1734578081
}
}
```
### 4. 更新课程任务
- **接口**：`PUT /api/lesson-tasks/{id}`
- **描述**：更新指定 ID 的课程任务
- **认证**：需要
- **路径参数**：
- `id`: 课程任务 ID
- **请求体**：
```json
{
"courseName": "Updated Course", // 课程名称
"microLessonName": "Updated Lesson", // 微课名称
"userId": 12, // 用户ID
"progressStatus": 2, // 进度状态
"scriptUploadTime": 1734578081, // 脚本上传时间
"scriptConfirmTime": 1734578081, // 脚本确认时间
"videoCaptureTime": 1734578081, // 视频录制时间
"videoConfirmTime": 1734578081, // 视频确认时间
"finishTime": 1734578081, // 完成时间
"advise": "Updated advice" // 建议
"courseName": "测试课程",
"microLessonName": "测试微课",
"userId": 1,
"advise": "任务说明"
}
```
- **成功响应**：
@ -409,46 +374,69 @@
"code": 10000,
"message": "成功",
"data": {
"id": 6,
"courseName": "Updated Course",
"microLessonName": "Updated Lesson",
"userId": 12,
"progressStatus": 2,
"scriptUploadTime": 1734578081,
"scriptConfirmTime": 1734578081,
"videoCaptureTime": 1734578081,
"videoConfirmTime": 1734578081,
"finishTime": 1734578081,
"advise": "Updated advice",
"createdAt": 1734578081,
"updatedAt": 1734578081
"id": 11,
"courseName": "测试课程",
"microLessonName": "测试微课",
"userId": 1,
"progressStatus": 0,
"scriptCreateTime": null,
"scriptReviewTime": null,
"scriptConfirmTime": null,
"videoCreateTime": null,
"videoConfirmTime": null,
"finishTime": null,
"advise": "任务说明",
"createdAt": 1735003870,
"updatedAt": 1735003870
}
}
```
### 5. 删除课程任务
### 4. 更新课程任务
- **接口**：`DELETE /api/lesson-tasks/{id}`
- **描述**：删除指定 ID 的课程任务
- **接口**：`PUT /api/lesson-tasks/{id}`
- **描述**：更新课程任务信息
- **认证**：需要
- **路径参数**：
- `id`: 课程任务 ID
- `id`: 课程任务ID
- **请求体**：
```json
{
"progressStatus": 1,
"advise": "更新的任务说明"
}
```
- **成功响应**：
```json
{
"code": 10000,
"message": "成功",
"data": null
"data": {
"id": 11,
"courseName": "测试课程",
"microLessonName": "测试微课",
"userId": 1,
"progressStatus": 1,
"scriptCreateTime": 1735003922,
"scriptReviewTime": null,
"scriptConfirmTime": null,
"videoCreateTime": null,
"videoConfirmTime": null,
"finishTime": null,
"advise": "更新的任务说明",
"createdAt": 1735003870,
"updatedAt": 1735003922
}
}
```
### 6. 按部门 ID 查询课程任务
### 5. 获取部门课程任务
- **接口**：`GET /api/lesson-tasks/department/{departmentId}`
- **描述**：获取指定部门下正常状态用户的课程任务列表（分页）
- **描述**：获取指定部门的课程任务列表
- **认证**：需要
- **路径参数**：
- `departmentId`: 部门 ID
- `departmentId`: 部门ID
- **查询参数**：
- `page`: 页码（从 1 开始）
- `size`: 每页数量（默认 10）
@ -461,89 +449,51 @@
"content": [
{
"id": 1,
"courseName": "物理",
"microLessonName": "微课1-1",
"courseName": "数学",
"microLessonName": "数学1-1",
"userId": 1,
"username": "教师账号1", // 新增：用户名字段
"username": "教师账号1",
"progressStatus": 4,
"scriptUploadTime": 1734498510,
"scriptConfirmTime": 1734498510,
"videoCaptureTime": 1734498510,
"videoConfirmTime": 1734498510,
"finishTime": 1734498510,
"advise": null,
"createdAt": 1734578081,
"updatedAt": 1734580393
"scriptCreateTime": 1734940587,
"scriptReviewTime": null,
"scriptConfirmTime": 1734940825,
"videoCreateTime": 1734940832,
"videoConfirmTime": 1734940837,
"finishTime": 1734940837,
"advise": "",
"createdAt": 1734674726,
"updatedAt": 1734940837
}
],
"totalElements": 10,
"totalPages": 1,
"size": 10,
"number": 0,
"first": true,
"last": true,
"empty": false
"pageable": {
"pageNumber": 0,
"pageSize": 10
},
"totalElements": 11,
"totalPages": 2
}
}
```
### 7. 更新课程任务进度
### 6. 删除课程任务
- **接口**：`PUT /api/lesson-tasks/{id}`
- **描述**：更新课程任务的进度状态和建议
- **接口**：`DELETE /api/lesson-tasks/{id}`
- **描述**：删除指定的课程任务
- **认证**：需要
- **路径参数**：
- `id`: 课程任务 ID
- **请求体**：
```json
{
"progressStatus": 2, // 进度状态（可选）
"advise": "{\"method\":\"wechat\",\"uploaded\":true}" // 建议（可选）
}
```
- **说明**：
- 更新进度状态时会自动更新对应的时间戳：
- 状态 1：更新 scriptUploadTime
- 状态 2：更新 scriptConfirmTime
- 状态 3：更新 videoCaptureTime
- 状态 4：更新 videoConfirmTime
- 状态 5：更新 finishTime
- 只会更新请求体中包含的字段，未提供的字段保持不变
- `id`: 课程任务ID
- **成功响应**：
```json
{
"code": 10000,
"message": "成功",
"data": {
"id": 10,
"courseName": "测试课程",
"microLessonName": "测试微课",
"userId": 1,
"progressStatus": 2,
"scriptUploadTime": null,
"scriptConfirmTime": 1734663755,
"videoCaptureTime": null,
"videoConfirmTime": null,
"finishTime": null,
"advise": "{\"method\":\"wechat\",\"uploaded\":true}",
"createdAt": 1734602440,
"updatedAt": 1734663755
}
"data": null
}
```
## 注意事项
1. 所有需要认证的接口必须在请求头中携带有效的 JWT 令牌
2. 所有时间戳字段均为秒级时间戳
3. 分页接口的页码从 1 开始
4. 用户密码在传输和存储时都会进行加密处理
5. 课程任务的 progressStatus 字段状态码说明：
- 0: 脚本上传
- 1: 脚本确认
- 2: 视频拍摄
- 3: 后期制作
- 4: 任务完成
6. 用户状态说明：
- 1: 正常
- 0: 禁用
1. 所有时间戳字段均使用秒级时间戳（10位）
2. 课程任务状态变更时会自动记录相应的时间戳
3. 部门课程任务列表会额外返回用户名信息
4. 分页参数中的页码从1开始

34
src/main/java/com/huertian/jinduguanli/dto/LessonTaskDTO.java
View File

@ -11,9 +11,10 @@ public class LessonTaskDTO {
private Long userId;
private String username; // 添加用户名字段
private Integer progressStatus;
private Long scriptUploadTime;
private Long scriptCreateTime;
private Long scriptReviewTime;
private Long scriptConfirmTime;
private Long videoCaptureTime;
private Long videoCreateTime;
private Long videoConfirmTime;
private Long finishTime;
private String advise;
@ -29,9 +30,10 @@ public class LessonTaskDTO {
dto.setUserId(lessonTask.getUserId());
dto.setUsername(username);
dto.setProgressStatus(lessonTask.getProgressStatus());
dto.setScriptUploadTime(lessonTask.getScriptUploadTime());
dto.setScriptCreateTime(lessonTask.getScriptCreateTime());
dto.setScriptReviewTime(lessonTask.getScriptReviewTime());
dto.setScriptConfirmTime(lessonTask.getScriptConfirmTime());
dto.setVideoCaptureTime(lessonTask.getVideoCaptureTime());
dto.setVideoCreateTime(lessonTask.getVideoCreateTime());
dto.setVideoConfirmTime(lessonTask.getVideoConfirmTime());
dto.setFinishTime(lessonTask.getFinishTime());
dto.setAdvise(lessonTask.getAdvise());
@ -88,12 +90,20 @@ public class LessonTaskDTO {
this.progressStatus = progressStatus;
}
public Long getScriptUploadTime() {
return scriptUploadTime;
public Long getScriptCreateTime() {
return scriptCreateTime;
}
public void setScriptUploadTime(Long scriptUploadTime) {
this.scriptUploadTime = scriptUploadTime;
public void setScriptCreateTime(Long scriptCreateTime) {
this.scriptCreateTime = scriptCreateTime;
}
public Long getScriptReviewTime() {
return scriptReviewTime;
}
public void setScriptReviewTime(Long scriptReviewTime) {
this.scriptReviewTime = scriptReviewTime;
}
public Long getScriptConfirmTime() {
@ -104,12 +114,12 @@ public class LessonTaskDTO {
this.scriptConfirmTime = scriptConfirmTime;
}
public Long getVideoCaptureTime() {
return videoCaptureTime;
public Long getVideoCreateTime() {
return videoCreateTime;
}
public void setVideoCaptureTime(Long videoCaptureTime) {
this.videoCaptureTime = videoCaptureTime;
public void setVideoCreateTime(Long videoCreateTime) {
this.videoCreateTime = videoCreateTime;
}
public Long getVideoConfirmTime() {

29
src/main/java/com/huertian/jinduguanli/dto/LessonTaskRequest.java
View File

@ -10,9 +10,10 @@ public class LessonTaskRequest {
private String microLessonName;
private Long userId;
private Integer progressStatus;
private Long scriptUploadTime;
private Long scriptCreateTime;
private Long scriptReviewTime;
private Long scriptConfirmTime;
private Long videoCaptureTime;
private Long videoCreateTime;
private Long videoConfirmTime;
private Long finishTime;
private String advise;
@ -49,12 +50,20 @@ public class LessonTaskRequest {
this.progressStatus = progressStatus;
}
public Long getScriptUploadTime() {
return scriptUploadTime;
public Long getScriptCreateTime() {
return scriptCreateTime;
}
public void setScriptUploadTime(Long scriptUploadTime) {
this.scriptUploadTime = scriptUploadTime;
public void setScriptCreateTime(Long scriptCreateTime) {
this.scriptCreateTime = scriptCreateTime;
}
public Long getScriptReviewTime() {
return scriptReviewTime;
}
public void setScriptReviewTime(Long scriptReviewTime) {
this.scriptReviewTime = scriptReviewTime;
}
public Long getScriptConfirmTime() {
@ -65,12 +74,12 @@ public class LessonTaskRequest {
this.scriptConfirmTime = scriptConfirmTime;
}
public Long getVideoCaptureTime() {
return videoCaptureTime;
public Long getVideoCreateTime() {
return videoCreateTime;
}
public void setVideoCaptureTime(Long videoCaptureTime) {
this.videoCaptureTime = videoCaptureTime;
public void setVideoCreateTime(Long videoCreateTime) {
this.videoCreateTime = videoCreateTime;
}
public Long getVideoConfirmTime() {

11
src/main/java/com/huertian/jinduguanli/entity/LessonTask.java
View File

@ -32,9 +32,10 @@ public class LessonTask implements Serializable {
@Column(nullable = false)
private Integer progressStatus;
private Long scriptUploadTime;
private Long scriptCreateTime;
private Long scriptReviewTime;
private Long scriptConfirmTime;
private Long videoCaptureTime;
private Long videoCreateTime;
private Long videoConfirmTime;
private Long finishTime;
@ -48,9 +49,9 @@ public class LessonTask implements Serializable {
@PrePersist
protected void onCreate() {
logger.info("创建新课程任务 - 课程名称: {}, 小课名称: {}, 用户ID: {}",
logger.info("创建新课程任务 - 课程名称: {}, 微课名称: {}, 用户ID: {}",
this.courseName, this.microLessonName, this.userId);
progressStatus = 1;
progressStatus = 0;
long now = System.currentTimeMillis() / 1000;
createdAt = now;
updatedAt = now;
@ -60,7 +61,7 @@ public class LessonTask implements Serializable {
@PreUpdate
protected void onUpdate() {
logger.info("更新课程任务 - ID: {}, 课程名称: {}, 小课名称: {}",
logger.info("更新课程任务 - ID: {}, 课程名称: {}, 微课名称: {}",
this.id, this.courseName, this.microLessonName);
updatedAt = System.currentTimeMillis() / 1000;
logger.info("更新课程任务成功 - ID: {}, 更新时间: {}", id, updatedAt);

12
src/main/java/com/huertian/jinduguanli/entity/User.java
View File

@ -47,6 +47,18 @@ public class User implements UserDetails {
@Column(name = "updated_at", nullable = false)
private Long updatedAt;
@PrePersist
protected void onCreate() {
long now = System.currentTimeMillis() / 1000;
createdAt = now;
updatedAt = now;
}
@PreUpdate
protected void onUpdate() {
updatedAt = System.currentTimeMillis() / 1000;
}
@Override
public Collection<? extends GrantedAuthority> getAuthorities() {
return Collections.singletonList(new SimpleGrantedAuthority("ROLE_USER"));

42
src/main/java/com/huertian/jinduguanli/service/LessonTaskService.java
View File

@ -53,12 +53,12 @@ public class LessonTaskService {
@Transactional
@CacheEvict(value = { "lessonTasks", "lessonTask" }, allEntries = true)
public LessonTask create(LessonTaskRequest request) {
logger.info("开始创建课程任务 - 课程名称: {}, 小课名称: {}, 用户ID: {}",
logger.info("开始创建课程任务 - 课程名称: {}, 微课名称: {}, 用户ID: {}",
request.getCourseName(), request.getMicroLessonName(), request.getUserId());
validateRequest(request);
LessonTask task = new LessonTask();
BeanUtils.copyProperties(request, task);
task.setProgressStatus(0); // 初始状态
task.setProgressStatus(0); // 初始状态：未开始
LessonTask savedTask = lessonTaskRepository.save(task);
logger.info("创建课程任务成功 - 任务ID: {}", savedTask.getId());
return savedTask;
@ -76,36 +76,42 @@ public class LessonTaskService {
// 根据进度状态更新时间戳
long currentTime = System.currentTimeMillis() / 1000;
switch (request.getProgressStatus()) {
case 0: // 初始状态
task.setScriptUploadTime(null);
case 0: // 未开始
task.setScriptCreateTime(null);
task.setScriptReviewTime(null);
task.setScriptConfirmTime(null);
task.setVideoCaptureTime(null);
task.setVideoCreateTime(null);
task.setVideoConfirmTime(null);
task.setFinishTime(null);
break;
case 1: // 脚本上传
task.setScriptUploadTime(currentTime);
case 1: // 脚本制作
task.setScriptCreateTime(currentTime);
task.setScriptReviewTime(null);
task.setScriptConfirmTime(null);
task.setVideoCaptureTime(null);
task.setVideoCreateTime(null);
task.setVideoConfirmTime(null);
task.setFinishTime(null);
break;
case 2: // 脚本确认
case 2: // 脚本审核
task.setScriptReviewTime(currentTime);
task.setScriptConfirmTime(null);
task.setVideoCreateTime(null);
task.setVideoConfirmTime(null);
task.setFinishTime(null);
break;
case 3: // 脚本确认
task.setScriptConfirmTime(currentTime);
task.setVideoCaptureTime(null);
task.setVideoCreateTime(null);
task.setVideoConfirmTime(null);
task.setFinishTime(null);
break;
case 3: // 视频拍摄
task.setVideoCaptureTime(currentTime);
case 4: // 视频拍摄与制作
task.setVideoCreateTime(currentTime);
task.setVideoConfirmTime(null);
task.setFinishTime(null);
break;
case 4: // 视频确认
case 5: // 视频确认
task.setVideoConfirmTime(currentTime);
task.setFinishTime(null);
break;
case 5: // 任务完成
task.setFinishTime(currentTime);
break;
}
@ -164,7 +170,7 @@ public class LessonTaskService {
* 根据部门ID和状态查询课程任务列表（分页）
*
* @param departmentId 部门ID
* @param status 任务状态（可选）：0-脚本上传, 1-脚本确认, 2-视频拍摄, 3-后期制作, 4-任务完成
* @param status 任务状态（可选）：0-未开始, 1-脚本制作, 2-脚本审核, 3-脚本确认, 4-视频拍摄与制作, 5-视频确认
* @param pageable 分页参数
* @return 课程任务分页数据
*/
@ -191,7 +197,7 @@ public class LessonTaskService {
throw new IllegalArgumentException("课程名称不能为空");
}
if (request.getMicroLessonName() == null || request.getMicroLessonName().trim().isEmpty()) {
throw new IllegalArgumentException("小课名称不能为空");
throw new IllegalArgumentException("微课名称不能为空");
}
if (request.getUserId() == null) {
throw new IllegalArgumentException("用户ID不能为空");

5
src/main/java/com/huertian/jinduguanli/service/UserService.java
View File

@ -76,9 +76,8 @@ public class UserService implements UserDetailsService {
user.setJobs(request.getJobs());
user.setCreatorId(request.getCreatorId());
user.setStatus(1);
user.setCreatedAt(System.currentTimeMillis() / 1000);
user.setUpdatedAt(System.currentTimeMillis() / 1000);
// 时间戳由 @PrePersist 处理，这里不需要手动设置
userRepository.save(user);
return ApiResponse.success();

139
数据库.md
View File

@ -15,7 +15,8 @@ CREATE TABLE departments (
```
### 字段说明
- `id`: 部门ID，自增主键
- `id`: 部门 ID，自增主键
- `name`: 部门名称，不可为空
- `description`: 部门描述，可为空
- `created_at`: 创建时间，毫秒级时间戳
@ -45,11 +46,12 @@ CREATE TABLE users (
```
### 字段说明
- `id`: 用户ID，自增主键
- `id`: 用户 ID，自增主键
- `username`: 用户名，不可为空
- `email`: 邮箱地址，不可为空，唯一索引
- `password`: 密码（加密存储），不可为空
- `department_id`: 所属部门ID，外键关联departments表
- `department_id`: 所属部门 ID，外键关联 departments 表
- `roles`: 用户角色，整数枚举：
- 1: 教师
- 2: 普通管理员
@ -60,8 +62,8 @@ CREATE TABLE users (
- 2: 课程购买方项目负责人
- 3: 课程制作方沟通联络人
- 4: 系统制作方项目负责人
- `avatar`: 用户头像URL，可为空
- `creator_id`: 创建该用户的管理员ID
- `avatar`: 用户头像 URL，可为空
- `creator_id`: 创建该用户的管理员 ID
- `status`: 用户状态：
- 1: 正常
- 0: 禁用
@ -69,6 +71,7 @@ CREATE TABLE users (
- `updated_at`: 更新时间，毫秒级时间戳
### 索引
- 主键索引：`id`
- 外键索引：`idx_users_department_id (department_id)`
- 唯一索引：`email`
@ -78,68 +81,114 @@ CREATE TABLE users (
存储课程制作任务的信息和进度。
```sql
CREATE TABLE lesson_tasks (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
course_name VARCHAR(100) NOT NULL COMMENT '课程名称',
micro_lesson_name VARCHAR(100) NOT NULL COMMENT '微课名称',
user_id BIGINT NOT NULL COMMENT '负责人ID',
progress_status INT NOT NULL DEFAULT 0 COMMENT '当前任务进度状态: 0-脚本上传, 1-脚本确认, 2-视频拍摄, 3-后期制作, 4-任务完成',
script_upload_time BIGINT DEFAULT NULL COMMENT '脚本上传时间（时间戳）',
script_confirm_time BIGINT DEFAULT NULL COMMENT '脚本确认时间（时间戳）',
video_capture_time BIGINT DEFAULT NULL COMMENT '视频拍摄时间（时间戳）',
video_confirm_time BIGINT DEFAULT NULL COMMENT '视频确认时间（时间戳）',
finish_time BIGINT DEFAULT NULL COMMENT '任务完成时间（时间戳）',
advise TEXT DEFAULT NULL COMMENT '任务建议或备注',
created_at BIGINT NOT NULL COMMENT '创建时间（时间戳）',
updated_at BIGINT NOT NULL COMMENT '更新时间（时间戳）',
FOREIGN KEY (user_id) REFERENCES users (id) ON DELETE CASCADE,
INDEX idx_lesson_tasks_user_id (user_id),
INDEX idx_lesson_tasks_progress_status (progress_status)
) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT ='课程任务表';
CREATE TABLE lesson_tasks
(
id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID，系统自动生成的唯一标识',
course_name VARCHAR(100) NOT NULL COMMENT '所属课程名称，标识任务所属的主课程',
micro_lesson_name VARCHAR(100) NOT NULL COMMENT '具体微课名称，标识任务所属的具体微课单元',
user_id BIGINT NOT NULL COMMENT '任务负责人ID，关联users表的主键id',
progress_status INT NOT NULL DEFAULT 0 COMMENT '任务进度状态：
0-未开始：任务创建后的初始状态
1-脚本制作：正在编写课程脚本
2-脚本审核：脚本提交审核阶段
3-脚本确认：脚本审核通过确认
4-视频拍摄与制作：进行视频录制和后期制作
5-视频确认：最终视频审核确认',
script_create_time BIGINT DEFAULT NULL COMMENT '脚本开始制作的时间戳，状态1时记录',
script_review_time BIGINT DEFAULT NULL COMMENT '脚本提交审核的时间戳，状态2时记录',
script_confirm_time BIGINT DEFAULT NULL COMMENT '脚本审核通过的时间戳，状态3时记录',
video_create_time BIGINT DEFAULT NULL COMMENT '开始视频制作的时间戳，状态4时记录',
video_confirm_time BIGINT DEFAULT NULL COMMENT '视频审核通过的时间戳，状态5时记录',
finish_time BIGINT DEFAULT NULL COMMENT '整个任务完成的时间戳，最终确认后记录',
advise TEXT DEFAULT NULL COMMENT '任务相关的建议、修改意见或其他重要备注信息',
created_at BIGINT NOT NULL COMMENT '记录创建的时间戳，系统自动生成',
updated_at BIGINT NOT NULL COMMENT '记录最后更新的时间戳，系统自动更新',
-- 外键约束：确保user_id关联到users表的有效用户
CONSTRAINT fk_lesson_tasks_user FOREIGN KEY (user_id) REFERENCES users (id) ON DELETE CASCADE ON UPDATE CASCADE,
-- 索引设计：
-- 1. 用户ID索引：用于快速查找特定用户的所有任务
INDEX idx_user_id (user_id),
-- 2. 进度状态索引：用于按状态筛选和统计任务
INDEX idx_progress_status (progress_status),
-- 3. 课程名称索引：用于按课程分组和查询
INDEX idx_course_name (course_name),
-- 4. 复合索引：用于同时按用户和状态查询
INDEX idx_user_progress (user_id, progress_status)
) ENGINE=InnoDB
DEFAULT CHARSET=utf8mb4
COMMENT='课程任务管理表：记录微课制作的完整流程，包括脚本编写、审核、视频制作等各个环节的进度和时间节点';
```
### 字段说明
- `id`: 任务ID，自增主键
- `id`: 任务 ID，自增主键
- `course_name`: 课程名称，不可为空
- `micro_lesson_name`: 微课名称，不可为空
- `user_id`: 负责人ID，外键关联users表
- `user_id`: 负责人 ID，外键关联 users 表
- `progress_status`: 任务进度状态：
- 0: 脚本上传
- 1: 脚本确认
- 2: 视频拍摄
- 3: 后期制作
- 4: 任务完成
- `script_upload_time`: 脚本上传时间，毫秒级时间戳
- `script_confirm_time`: 脚本确认时间，毫秒级时间戳
- `video_capture_time`: 视频拍摄时间，毫秒级时间戳
- `video_confirm_time`: 视频确认时间，毫秒级时间戳
- `finish_time`: 任务完成时间，毫秒级时间戳
- `advise`: 任务相关的建议或备注，文本字段
- `created_at`: 创建时间，毫秒级时间戳
- `updated_at`: 更新时间，毫秒级时间戳
- 0: 未开始
- 1: 脚本制作
- 2: 脚本审核
- 3: 脚本确认
- 4: 视频拍摄与制作
- 5: 视频确认
- `script_create_time`: 脚本开始制作的时间戳，状态 1 时记录
- `script_review_time`: 脚本提交审核的时间戳，状态 2 时记录
- `script_confirm_time`: 脚本审核通过的时间戳，状态 3 时记录
- `video_create_time`: 开始视频制作的时间戳，状态 4 时记录
- `video_confirm_time`: 视频审核通过的时间戳，状态 5 时记录
- `finish_time`: 整个任务完成的时间戳，最终确认后记录
- `advise`: 任务相关的建议、修改意见或其他重要备注信息
- `created_at`: 记录创建的时间戳，系统自动生成
- `updated_at`: 记录最后更新的时间戳，系统自动更新
### 索引
- 主键索引：`id`
- 外键索引：`idx_lesson_tasks_user_id (user_id)`
- 普通索引：`idx_lesson_tasks_progress_status (progress_status)`
- 外键索引：`idx_user_id (user_id)`
- 普通索引：`idx_progress_status (progress_status)`
- 普通索引：`idx_course_name (course_name)`
- 复合索引：`idx_user_progress (user_id, progress_status)`
## 数据库关系
1. `users.department_id` -> `departments.id`
- 一个部门可以有多个用户
- 一个用户只能属于一个部门
- 使用RESTRICT约束，防止删除仍有用户的部门
- 使用 RESTRICT 约束，防止删除仍有用户的部门
2. `lesson_tasks.user_id` -> `users.id`
- 一个用户可以负责多个课程任务
- 一个课程任务只能有一个负责人
- 使用CASCADE约束，删除用户时自动删除其负责的课程任务
- 使用 CASCADE 约束，删除用户时自动删除其负责的课程任务
3. `lesson_tasks` 和 `users` 表关系:
- 一对多关系：一个用户（users）可以负责多个课程任务（lesson_tasks）
- 通过 `user_id` 外键关联，确保任务负责人的有效性
- 使用 CASCADE 级联删除：当用户被删除时，相关任务也会被自动删除
- 使用 CASCADE 级联更新：当用户 ID 更新时，相关任务的 user_id 也会自动更新
4. 索引说明：
- `idx_user_id`: 优化按负责人查询任务的性能
- `idx_progress_status`: 优化按任务状态筛选和统计的性能
- `idx_course_name`: 优化按课程名称查询和分组的性能
- `idx_user_progress`: 优化同时按用户和任务状态查询的性能，适用于查看特定用户的特定状态任务
5. 时间节点追踪：
- 系统通过各个时间戳字段（script_create_time, script_review_time 等）完整记录任务的每个阶段
- 可以通过这些时间戳计算各阶段的耗时，用于任务进度分析和效率优化
## 注意事项
1. 所有时间戳字段使用BIGINT类型，存储毫秒级时间戳
2. 字符编码统一使用utf8mb4，支持完整的Unicode字符集
3. 所有表都使用InnoDB引擎，支持事务和外键
1. 所有时间戳字段使用 BIGINT 类型，存储毫秒级时间戳
2. 字符编码统一使用 utf8mb4，支持完整的 Unicode 字符集
3. 所有表都使用 InnoDB 引擎，支持事务和外键
4. 关键字段都建立了适当的索引以提高查询性能
5. 用户密码在存储前需要进行加密处理
6. 删除用户时会自动删除其关联的课程任务，但不会影响部门数据