# 实训平台客户端后端开发计划

## 一、需求分析

根据《实训平台客户端完整需求文档（V2.0）》，需要实现以下核心模块：

| 模块 | 功能点 | 状态 |
| :--- | :--- | :--- |
| **注册登录** | 手机号验证码注册、账号密码注册、微信扫码登录、自动注册 | 部分实现 |
| **通知中心** | 通知列表、详情查看、单条/全部已读 | 未实现 |
| **充值中心** | 充值套餐、套餐支付、自定义充值 | 已实现（沿用account/accountTransaction/paymentOrder表） |
| **教学管理** | 课程管理、作业管理、考试管理、考勤管理 | 未实现 |
| **优秀作品** | 作品展示、点赞互动 | 未实现 |
| **个人中心** | 个人信息、消费记录、订单记录、密码修改、手机号修改 | 部分实现 |

## 二、技术架构

### 2.1 技术栈
- **语言**: Java 17
- **框架**: Spring Boot 3.2.2
- **数据库**: MySQL
- **ORM**: MyBatis
- **缓存**: Redis + Redisson
- **认证**: Sa-Token
- **支付**: 微信支付 SDK、支付宝 SDK
- **文档**: SpringDoc OpenAPI

### 2.2 代码结构
```
src/main/java/com/kexue/skills/
├── annotation/          # 自定义注解
├── aspect/              # AOP切面
├── common/              # 通用工具类
├── config/              # 配置类
├── controller/          # 控制器
├── entity/              # 实体类
│   ├── base/            # 基础实体
│   ├── dto/             # 数据传输对象
│   ├── request/         # 请求对象
│   └── response/        # 响应对象
├── exception/           # 异常处理
├── interceptor/         # 拦截器
├── mapper/              # MyBatis映射器
├── service/             # 业务服务
│   └── impl/            # 服务实现
└── SkillsApp.java       # 启动类
```

## 三、开发计划

### 阶段一：数据库表设计与初始化（预计1天）

**任务1.1：设计并创建教学管理相关表**
- `edu_course` - 课程表
- `edu_course_student` - 课程学生关联表
- `edu_homework` - 作业表
- `edu_homework_submit` - 作业提交表
- `edu_exam` - 考试表
- `edu_exam_paper` - 考试答卷表
- `edu_attendance` - 考勤表
- `edu_attendance_record` - 考勤记录表

**任务1.2：设计并创建通知表**
- `sys_notification` - 通知表
- `sys_notification_read` - 通知已读记录表

**任务1.3：设计并创建优秀作品表**
- `edu_excellent_work` - 优秀作品表
- `edu_work_like` - 作品点赞表

**任务1.4：扩展用户表字段**
- 添加院校相关字段：school_id, college_id, major_id, grade, class_name
- 添加角色字段：role_type (1-学生, 2-老师)
- 添加账户状态字段：account_status (1-可学用户, 2-试用用户, 3-学校用户, 4-冻结用户)
- 添加激活码相关字段：activation_code, binding_status

### 阶段二：用户体系模块开发（预计2天）

**任务2.1：完善注册功能**
- 添加学校/学院/专业/年级/班级选择接口
- 实现手机号验证码注册
- 实现账号密码注册
- 支持默认角色为学生

**任务2.2：完善登录功能**
- 实现微信扫码登录（绑定wxid）
- 实现手机号密码登录
- 完善自动注册逻辑

**任务2.3：院校绑定功能**
- 实现身份信息填写接口
- 实现院校预校验接口
- 实现激活码绑定接口

**任务2.4：个人中心功能**
- 个人信息查看与修改
- 密码修改（含找回密码）
- 绑定手机号修改

### 阶段三：通知模块开发（预计1天）

**任务3.1：通知管理接口**
- 获取通知列表（按时间倒序）
- 查看通知详情（自动标记已读）
- 单条通知已读
- 全部通知已读

### 阶段四：教学管理模块开发（预计4天）

**任务4.1：课程管理**
- 老师端：创建课程、管理课程、课程学生管理、导出成绩
- 学生端：查看课程、查看课程内容

**任务4.2：作业管理**
- 老师端：作业草稿管理、发布作业、作业批改、优秀标记、删除作业
- 学生端：查看作业、提交作业、修改作业、重做退回作业

**任务4.3：考试管理**
- 老师端：考试草稿管理、发布考试、阅卷管理、补考管理、删除考试
- 学生端：查看考试、参加考试、参加补考

**任务4.4：考勤管理**
- 老师端：发起签到（二维码/手动点名）、管理签到记录、修改考勤状态
- 学生端：扫码签到、查看考勤记录

### 阶段五：优秀作品模块开发（预计1天）

**任务5.1：优秀作品展示**
- 获取优秀作品列表
- 作品点赞（每个作品仅可点赞1次）

### 阶段六：统一异常处理与安全加固（预计1天）

**任务6.1：统一异常处理**
- 实现统一错误提示语
- 完善全局异常处理器

**任务6.2：安全加固**
- 权限双重校验
- 数据隔离机制
- 操作日志留存

## 四、接口清单

### 4.1 用户体系接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/register/phone` | POST | 手机号验证码注册 |
| `/api/register/password` | POST | 账号密码注册 |
| `/api/login/wechat` | POST | 微信扫码登录 |
| `/api/login/phone` | POST | 手机号验证码登录 |
| `/api/login/password` | POST | 账号密码登录 |
| `/api/binding/school/check` | POST | 院校预校验 |
| `/api/binding/activation` | POST | 激活码绑定 |
| `/api/user/info` | GET | 获取个人信息 |
| `/api/user/info` | PUT | 修改个人信息 |
| `/api/user/password` | PUT | 修改密码 |
| `/api/user/phone` | PUT | 修改绑定手机号 |

### 4.2 通知接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/notification/list` | GET | 获取通知列表 |
| `/api/notification/detail/{id}` | GET | 查看通知详情 |
| `/api/notification/read/{id}` | PUT | 标记单条已读 |
| `/api/notification/read/all` | PUT | 标记全部已读 |

### 4.3 课程管理接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/course/list` | GET | 获取课程列表 |
| `/api/course/create` | POST | 创建课程 |
| `/api/course/update` | PUT | 修改课程信息 |
| `/api/course/delete/{id}` | DELETE | 删除课程 |
| `/api/course/students/{courseId}` | GET | 获取课程学生列表 |
| `/api/course/addStudents` | POST | 批量添加学生 |
| `/api/course/removeStudent` | DELETE | 踢出学生 |
| `/api/course/exportScore/{courseId}` | GET | 导出成绩 |

### 4.5 作业管理接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/homework/list/{courseId}` | GET | 获取作业列表 |
| `/api/homework/create` | POST | 创建作业草稿 |
| `/api/homework/update` | PUT | 修改作业草稿 |
| `/api/homework/delete/{id}` | DELETE | 删除作业 |
| `/api/homework/publish` | PUT | 发布作业 |
| `/api/homework/submit` | POST | 提交作业 |
| `/api/homework/correct` | PUT | 批改作业 |
| `/api/homework/excellent/{id}` | PUT | 标记优秀 |
| `/api/homework/return` | PUT | 退回作业 |

### 4.6 考试管理接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/exam/list/{courseId}` | GET | 获取考试列表 |
| `/api/exam/create` | POST | 创建考试草稿 |
| `/api/exam/update` | PUT | 修改考试草稿 |
| `/api/exam/delete/{id}` | DELETE | 删除考试 |
| `/api/exam/publish` | PUT | 发布考试 |
| `/api/exam/take/{examId}` | POST | 参加考试 |
| `/api/exam/correct` | PUT | 阅卷打分 |
| `/api/exam/makeup` | POST | 创建补考 |

### 4.7 考勤管理接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/attendance/start` | POST | 发起签到 |
| `/api/attendance/list/{courseId}` | GET | 获取签到记录列表 |
| `/api/attendance/detail/{id}` | GET | 查看签到详情 |
| `/api/attendance/sign` | POST | 扫码签到 |
| `/api/attendance/status` | PUT | 修改考勤状态 |
| `/api/attendance/myList` | GET | 个人考勤记录 |

### 4.8 优秀作品接口

| API路径 | 方法 | 功能描述 |
| :--- | :--- | :--- |
| `/api/excellent/list` | GET | 获取优秀作品列表 |
| `/api/excellent/like/{workId}` | POST | 点赞作品 |

## 五、数据库表设计

### 5.1 用户表扩展字段

```sql
-- sys_user 表新增字段（仅添加通用字段，角色专属字段移至扩展表）
ALTER TABLE `sys_user` 
ADD COLUMN `account_status` TINYINT(1) DEFAULT '1' COMMENT '账户状态：1-可学用户，2-试用用户，3-学校用户，4-冻结用户',
ADD COLUMN `wxid` VARCHAR(100) DEFAULT NULL COMMENT '微信ID';
```

### 5.2 用户角色关联表

```sql
CREATE TABLE `sys_user_role` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `user_id` BIGINT(20) NOT NULL COMMENT '用户ID',
  `role_code` VARCHAR(50) NOT NULL COMMENT '角色编码：student-学生，teacher-老师，admin-管理员',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_role` (`user_id`, `role_code`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_role_code` (`role_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户角色关联表';
```

### 5.3 学生扩展表

```sql
CREATE TABLE `edu_student` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `user_id` BIGINT(20) NOT NULL COMMENT '用户ID（关联sys_user）',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID',
  `college_id` BIGINT(20) DEFAULT NULL COMMENT '学院ID',
  `major_id` BIGINT(20) DEFAULT NULL COMMENT '专业ID',
  `grade` VARCHAR(20) DEFAULT NULL COMMENT '年级',
  `class_name` VARCHAR(50) DEFAULT NULL COMMENT '班级',
  `student_no` VARCHAR(50) DEFAULT NULL COMMENT '学号',
  `real_name` VARCHAR(50) DEFAULT NULL COMMENT '真实姓名',
  `activation_code` VARCHAR(50) DEFAULT NULL COMMENT '激活码',
  `binding_status` TINYINT(1) DEFAULT '0' COMMENT '绑定状态：0-未绑定，1-已绑定',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_id` (`user_id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_college_id` (`college_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生扩展表';
```

### 5.4 教师扩展表

```sql
CREATE TABLE `edu_teacher` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `user_id` BIGINT(20) NOT NULL COMMENT '用户ID（关联sys_user）',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID',
  `college_id` BIGINT(20) DEFAULT NULL COMMENT '学院ID',
  `real_name` VARCHAR(50) DEFAULT NULL COMMENT '真实姓名',
  `teacher_no` VARCHAR(50) DEFAULT NULL COMMENT '教师编号',
  `title` VARCHAR(50) DEFAULT NULL COMMENT '职称',
  `activation_code` VARCHAR(50) DEFAULT NULL COMMENT '激活码',
  `binding_status` TINYINT(1) DEFAULT '0' COMMENT '绑定状态：0-未绑定，1-已绑定',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_user_id` (`user_id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_college_id` (`college_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='教师扩展表';
```

### 5.5 通知表

```sql
CREATE TABLE `sys_notification` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `user_id` BIGINT(20) NOT NULL COMMENT '用户ID',
  `title` VARCHAR(100) NOT NULL COMMENT '通知标题',
  `content` TEXT NOT NULL COMMENT '通知内容',
  `type` TINYINT(1) DEFAULT '1' COMMENT '通知类型：1-系统通知，2-作业通知，3-考试通知，4-考勤通知',
  `is_read` TINYINT(1) DEFAULT '0' COMMENT '是否已读：0-未读，1-已读',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_is_read` (`is_read`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='通知表';
```

### 5.6 课程表

```sql
CREATE TABLE `edu_course` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `name` VARCHAR(100) NOT NULL COMMENT '课程名称',
  `cover` VARCHAR(255) DEFAULT NULL COMMENT '课程封面',
  `description` TEXT DEFAULT NULL COMMENT '课程简介',
  `class_time` VARCHAR(100) DEFAULT NULL COMMENT '上课时间',
  `teaching_method` TINYINT(1) DEFAULT '1' COMMENT '授课方式：1-线上，2-线下，3-混合',
  `teacher_id` BIGINT(20) NOT NULL COMMENT '创建老师ID',
  `status` TINYINT(1) DEFAULT '1' COMMENT '课程状态：1-进行中，2-已结课',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_teacher_id` (`teacher_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='课程表';
```

### 5.7 课程学生关联表

```sql
CREATE TABLE `edu_course_student` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `course_id` BIGINT(20) NOT NULL COMMENT '课程ID',
  `student_id` BIGINT(20) NOT NULL COMMENT '学生ID',
  `join_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '加入时间',
  `is_kicked` TINYINT(1) DEFAULT '0' COMMENT '是否被踢出：0-正常，1-已踢出',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_course_student` (`course_id`, `student_id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_course_id` (`course_id`),
  KEY `idx_student_id` (`student_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='课程学生关联表';
```

### 5.8 作业表

```sql
CREATE TABLE `edu_homework` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `course_id` BIGINT(20) NOT NULL COMMENT '课程ID',
  `name` VARCHAR(100) NOT NULL COMMENT '作业名称',
  `requirement` TEXT DEFAULT NULL COMMENT '作业要求',
  `questions` TEXT NOT NULL COMMENT '题目JSON',
  `allow_late` TINYINT(1) DEFAULT '0' COMMENT '是否允许迟交',
  `start_time` DATETIME NOT NULL COMMENT '开始时间',
  `end_time` DATETIME NOT NULL COMMENT '截止时间',
  `status` TINYINT(1) DEFAULT '1' COMMENT '状态：1-草稿，2-已发布',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_course_id` (`course_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='作业表';
```

### 5.9 作业提交表

```sql
CREATE TABLE `edu_homework_submit` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `homework_id` BIGINT(20) NOT NULL COMMENT '作业ID',
  `student_id` BIGINT(20) NOT NULL COMMENT '学生ID',
  `answers` TEXT NOT NULL COMMENT '答案JSON',
  `submit_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '提交时间',
  `is_late` TINYINT(1) DEFAULT '0' COMMENT '是否迟交',
  `status` TINYINT(1) DEFAULT '1' COMMENT '状态：1-待批改，2-已批改，3-已退回',
  `score` DECIMAL(5,2) DEFAULT NULL COMMENT '分数',
  `comment` TEXT DEFAULT NULL COMMENT '评语',
  `is_excellent` TINYINT(1) DEFAULT '0' COMMENT '是否优秀',
  `redo_end_time` DATETIME DEFAULT NULL COMMENT '重做截止时间',
  `redo_count` INT(11) DEFAULT '0' COMMENT '重做次数',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_homework_id` (`homework_id`),
  KEY `idx_student_id` (`student_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='作业提交表';
```

### 5.10 考试表

```sql
CREATE TABLE `edu_exam` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `course_id` BIGINT(20) NOT NULL COMMENT '课程ID',
  `name` VARCHAR(100) NOT NULL COMMENT '考试名称',
  `requirement` TEXT DEFAULT NULL COMMENT '考试要求',
  `questions` TEXT NOT NULL COMMENT '考卷JSON',
  `duration` INT(11) NOT NULL COMMENT '考试时长（分钟）',
  `start_time` DATETIME NOT NULL COMMENT '开始时间',
  `end_time` DATETIME NOT NULL COMMENT '截止时间',
  `status` TINYINT(1) DEFAULT '1' COMMENT '状态：1-草稿，2-已发布，3-已结束',
  `is_makeup` TINYINT(1) DEFAULT '0' COMMENT '是否补考',
  `parent_exam_id` BIGINT(20) DEFAULT NULL COMMENT '关联主考ID',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_course_id` (`course_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考试表';
```

### 5.11 考试答卷表

```sql
CREATE TABLE `edu_exam_paper` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `exam_id` BIGINT(20) NOT NULL COMMENT '考试ID',
  `student_id` BIGINT(20) NOT NULL COMMENT '学生ID',
  `answers` TEXT NOT NULL COMMENT '答案JSON',
  `submit_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '提交时间',
  `status` TINYINT(1) DEFAULT '1' COMMENT '状态：1-待阅卷，2-已阅卷',
  `score` DECIMAL(5,2) DEFAULT NULL COMMENT '分数',
  `comment` TEXT DEFAULT NULL COMMENT '评语',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_exam_student` (`exam_id`, `student_id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_exam_id` (`exam_id`),
  KEY `idx_student_id` (`student_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考试答卷表';
```

### 5.12 考勤表

```sql
CREATE TABLE `edu_attendance` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `course_id` BIGINT(20) NOT NULL COMMENT '课程ID',
  `name` VARCHAR(100) DEFAULT NULL COMMENT '签到名称（按时间自动生成）',
  `start_time` DATETIME NOT NULL COMMENT '开始时间',
  `duration` INT(11) DEFAULT '15' COMMENT '签到时长（分钟）',
  `type` TINYINT(1) DEFAULT '1' COMMENT '签到类型：1-二维码签到，2-手动点名',
  `status` TINYINT(1) DEFAULT '1' COMMENT '状态：1-进行中，2-已结束',
  `qr_code` VARCHAR(255) DEFAULT NULL COMMENT '二维码内容',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_course_id` (`course_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考勤表';
```

### 5.13 考勤记录表

```sql
CREATE TABLE `edu_attendance_record` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `attendance_id` BIGINT(20) NOT NULL COMMENT '考勤ID',
  `student_id` BIGINT(20) NOT NULL COMMENT '学生ID',
  `status` TINYINT(1) DEFAULT '1' COMMENT '考勤状态：1-出勤，2-迟到，3-缺勤，4-请假',
  `sign_time` DATETIME DEFAULT NULL COMMENT '签到时间',
  `remark` VARCHAR(255) DEFAULT NULL COMMENT '备注（手动点名时填写）',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_attendance_student` (`attendance_id`, `student_id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_attendance_id` (`attendance_id`),
  KEY `idx_student_id` (`student_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考勤记录表';
```

### 5.14 优秀作品表

```sql
CREATE TABLE `edu_excellent_work` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `work_type` TINYINT(1) NOT NULL COMMENT '作品类型：1-作业，2-考试',
  `work_id` BIGINT(20) NOT NULL COMMENT '关联作业/考试ID',
  `submit_id` BIGINT(20) NOT NULL COMMENT '关联提交ID',
  `student_id` BIGINT(20) NOT NULL COMMENT '学生ID',
  `score` DECIMAL(5,2) DEFAULT NULL COMMENT '分数',
  `comment` TEXT DEFAULT NULL COMMENT '评语',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '标记时间',
  PRIMARY KEY (`id`),
  KEY `idx_school_id` (`school_id`),
  KEY `idx_work_type_work_id` (`work_type`, `work_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优秀作品表';
```

### 5.15 作品点赞表

```sql
CREATE TABLE `edu_work_like` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `school_id` BIGINT(20) NOT NULL COMMENT '学校ID（数据隔离）',
  `work_id` BIGINT(20) NOT NULL COMMENT '优秀作品ID',
  `user_id` BIGINT(20) NOT NULL COMMENT '点赞用户ID',
  `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '点赞时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_work_user` (`work_id`, `user_id`),
  KEY `idx_school_id` (`school_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='作品点赞表';
```

## 六、开发进度安排

| 阶段 | 任务 | 预计天数 | 负责人 |
| :--- | :--- | :--- | :--- |
| 第一阶段 | 数据库表设计与初始化 | 1 | 开发人员 |
| 第二阶段 | 用户体系模块开发 | 2 | 开发人员 |
| 第三阶段 | 通知模块开发 | 1 | 开发人员 |
| 第四阶段 | 教学管理模块开发 | 4 | 开发人员 |
| 第五阶段 | 优秀作品模块开发 | 1 | 开发人员 |
| 第六阶段 | 统一异常处理与安全加固 | 1 | 开发人员 |
| **总计** | | **10天** | |

## 七、风险与注意事项

### 7.1 风险识别

| 风险 | 描述 | 应对措施 |
| :--- | :--- | :--- |
| 数据权限安全 | 用户可能越权访问其他用户数据 | 前端展示+后端接口双重校验，token验证 |
| 并发问题 | 高并发场景下的数据一致性问题 | 使用Redis分布式锁，数据库事务 |
| 支付安全 | 支付回调可能被篡改 | 验证签名，使用安全的回调地址 |
| 接口幂等性 | 重复提交导致数据重复 | 使用防重复提交注解，唯一业务ID |

### 7.2 注意事项

1. **权限校验**：所有API查询严格校验token与对应用户ID
2. **数据排序**：所有数据获取接口默认按日期最新排序
3. **操作留痕**：课程/作业/考试/考勤/充值操作全量日志留存≥1年
4. **流程不可逆**：院校绑定、注册登录、作业考试发布流程严格按文档执行
5. **异常处理**：统一错误提示语，返回标准化错误信息

---

**文档版本**: V1.0  
**创建时间**: 2026-04-30  
**创建人**: 系统生成