# 实训平台客户端完整需求文档（V2\.0）

## 文档说明

本文档基于原始零散需求、批注优化与核心业务规则整合，**剔除疑问、统一口径、明确边界、规范格式**，形成可直接交付研发的完整客户端需求，覆盖用户体系、注册登录、通知、充值、教学管理、优秀作品、个人中心全模块。

## 一、核心基础规则

### 1\. 通用约束

1. **数据权限**：所有 API 查询严格校验`token`与对应用户 ID，仅允许查询当前账户信息，禁止越权访问

2. **数据排序**：所有数据获取接口默认按**日期最新**排序

3. **权限边界**：未采购平台的学校，师生仅可登录、使用基础功能，**无教学管理模块（作业 / 考试 / 课程 / 考勤）权限**

4. **角色定义**：客户端仅支持**老师、学生**两种核心身份，无其他角色

### 2\. 账户体系规则（强制）

1. **身份绑定流程**：绑定已采购院校需遵循「填身份信息→院校预校验→专属激活码→绑码校验」流程，禁止跳步

2. **激活码规则**：1 人 1 码、与姓名 / 学号 / 院校 / 角色强绑定，绑定后失效，无通用码

3. **账户状态与权限**

    - 可学用户（未绑院校）：仅基础功能，无教学模块

    - 试用用户（绑未采购院校）：基础 \+ 试用功能，无教学模块

    - 学校用户（绑已采购院校）：全功能权限，开放教学模块

    - 冻结用户：禁止登录，禁用所有功能

## 二、注册需求

### 1\. 注册方式

支持**手机号验证码注册、账号密码注册**两种自由注册方式，二选一。

### 2\. 注册必填信息

所有注册方式均需填写：**学校、学院、专业、年级、班级**，信息与平台组织机构库关联选择，非纯文本输入。

### 3\. 注册默认角色

自由注册默认角色为**学生**，老师角色需院校管理员后台批量创建 / 审核开通。

### 4\. 密码规则

密码需满足：**不低于 8 位，数字 \+ 字母混合**，禁止纯数字 / 纯字母。

## 三、登录需求

### 1\. 登录方式

老师、学生均支持 4 种登录方式：**微信扫码登录、手机号验证码登录、账号密码登录、手机号密码登录**，登录失败返回标准化错误提示。

### 2\. 微信登录规则

微信扫码登录需提前绑定微信，注册阶段同步写入`wxid`至用户表，实现微信与账户唯一绑定。

### 3\. 自动注册规则

手机号验证码登录、微信扫码登录时，**无账户则自动创建新用户**，默认角色为学生，学校 / 学院 / 专业 / 年级 / 班级信息沿用注册规则必填。

## 四、通知需求

用户（老师 / 学生）在通知中心页面可完成以下操作，解决消息漏看、状态混乱问题：

1. **获取通知列表**：查看全部系统通知，按时间倒序排列

2. **查看通知详情**：点击单条通知查看完整内容

3. **单条通知已读**：查看详情后自动触发，变更为已读状态

4. **全部通知已读**：点击「全部已读」按钮，一键标记所有通知为已读

## 五、充值需求

用户在充值中心页面可完成算力充值，解决算力付费、套餐选择问题：

1. **获取充值套餐**：展示管理员后台配置的官方充值套餐，包含套餐名称、算力额度、价格、有效期

2. **套餐支付**：选择固定套餐，通过**微信 / 支付宝扫码**完成支付

3. **自定义充值**：支持自由输入充值金额，通过**微信 / 支付宝扫码**完成支付

4. **支付结果**：支付成功后实时到账算力，支付失败返回失败原因

## 六、教学板块需求

### 6\.1 通用规则

1. **草稿定义**：未发布的作业 / 考试为**草稿**，仅可编辑 / 删除；发布后草稿修改不影响已发布内容

2. **发布规则**：作业 / 考试仅可发布至老师创建的课程，支持多选课程，发布后学生收到通知

3. **题目类型**：支持填空题、单选题、多选题、简答题，简答题支持文字作答、图片上传、文件上传（老师配置）

### 6\.2 课程管理

#### 老师端（课程创建者）

老师在课程管理页面可完成以下操作，解决班级管理、教学组织问题：

1. **筛选学生**：按学院 / 专业 / 年级 / 班级筛选学生，返回**真实姓名、头像、用户 ID、联系方式、学号**

2. **创建课程**：填写课程名称、封面、简介、上课时间、授课方式，支持**批量添加学生**（班级全选 / Excel 导入手机号），创建成功后通知学生

3. **管理课程**：修改课程信息（已结课课程不可编辑）、删除草稿状态课程

4. **查看课程列表**：查看自己创建的所有课程，展示课程名、上课时间、状态

5. **课程学生管理**：查看课程内学生列表、批量添加学生、踢出学生（踢出后保留作业 / 考试数据），操作后通知学生

6. **导出成绩**：选择课程内考试，导出 Excel 成绩表，包含姓名、学号、平均分、分数、排名、总评成绩

#### 学生端

学生在课程中心页面可完成以下操作，解决课程学习、信息查看问题：

1. **查看课程**：展示已加入的课程，包含课程标题、老师、封面、上课时间

2. **查看课程内容**：查看课程内作业、考试、考勤信息

### 6\.3 作业管理

#### 老师端

老师在作业管理页面可完成以下操作，解决作业布置、批改、管理问题：

1. **作业草稿管理**：创建、编辑、删除作业草稿，草稿包含名称、要求、题目、是否允许迟交、截止时间

2. **发布作业**：将草稿发布至课程，设置开始 / 截止时间，通知课程内学生

3. **查看作业列表**：查看课程内作业，展示标题、截止时间、提交情况、批改状态

4. **作业批改管理**：查看学生提交详情、批改作业（打分 \+ 评语）、修改分数、批量退回作业（设置重交截止时间，通知学生）

5. **优秀标记**：将学生作业标记为优秀 / 取消优秀

6. **删除作业**：删除作业及已提交 / 批改数据

#### 学生端

学生在作业页面可完成以下操作，解决作业提交、修改、重做问题：

1. **查看作业**：查看课程内作业列表，展示标题、时间、提交状态、迟交权限

2. **提交作业**：按题目要求作答，支持文字 / 图片 / 文件

3. **修改作业**：截止时间前可修改已提交作业

4. **重做作业**：按老师退回要求，在截止时间前重新提交

### 6\.4 考试管理

#### 老师端

老师在考试管理页面可完成以下操作，解决考试组织、阅卷、补考问题：

1. **考试草稿管理**：创建、编辑、删除考试草稿，草稿包含名称、要求、考卷、时间

2. **发布考试**：将草稿发布至课程，设置开始 / 截止时间、考试时长，通知学生

3. **查看考试列表**：查看课程内考试，展示名称、时间、时长、状态、提交情况

4. **考试阅卷管理**：查看学生答卷、打分、写评语、修改分数

5. **补考管理**：筛选不及格学生，创建并发布补考，补考成绩规则：及格覆盖原成绩，超上限按上限计分

6. **删除考试**：删除考试及学生答卷数据

#### 学生端

学生在考试页面可完成以下操作，解决考试参与、补考问题：

1. **查看考试**：查看课程内考试列表，展示名称、时间、状态、分数

2. **参加考试**：在考试时间内进入答题页，倒计时作答，超时强制提交（切页视为空提交）

3. **参加补考**：完成老师发布的补考并提交

### 6\.5 考勤管理

#### 老师端

老师在考勤页面可完成以下操作，解决课堂签到、统计问题：

1. **发起签到**：课程内开启签到，设置时长，支持**二维码签到、手动点名**两种方式，通知所有学生

2. **管理签到**：查看全部签到记录（名称、时间、状态、出勤统计）、查看单次签到详情、修改学生考勤状态（出勤 / 迟到 / 缺勤 / 请假），手动点名可添加备注

3. **签到规则**：未签到自动标记为旷课，签到记录按开始时间命名

#### 学生端

学生在考勤页面可完成以下操作，解决签到、查看考勤问题：

1. **扫码签到**：扫描老师二维码完成签到

2. **查看考勤**：查看所有考勤记录与个人状态（出勤 / 迟到 / 缺勤 / 请假）

## 七、优秀作品需求

用户在优秀作品页面可完成以下操作，解决作品展示、互动问题：

1. **查看优秀作品**：获取所有老师标记的优秀作业 / 考试作品

2. **作品互动**：老师 / 学生可对作品点赞，**每个作品仅可点赞 1 次**

## 八、个人中心需求

用户在个人中心页面可完成以下操作，解决信息管理、账单查看问题：

1. **查看个人信息**：展示部门、昵称、手机号、头像

2. **查看消费记录**：查看算力消耗、获取明细

3. **查看订单记录**：查看所有充值订单（已支付 / 未支付）

4. **修改基础信息**：修改昵称、头像

5. **修改密码**

    - 正常修改：输入原密码 \+ 新密码，新密码需符合规则且与原密码不同

    - 找回密码：忘记原密码可通过手机号验证码修改

    - 规则：修改后强制重新登录，返回标准化错误提示

6. **修改绑定手机号**

    - 流程：验证原手机号→输入新手机号→双重验证码校验

    - 规则：手机号 11 位格式校验、唯一性校验，验证码 5 分钟有效、60 秒内仅可发送 1 次

    - 异常：返回验证码错误、过期、手机号已占用等提示

## 九、异常处理与提示规范

所有功能异常返回统一提示语：

1. 原密码错误：原密码错误，请重新输入

2. 新密码重复：新密码不能与原密码相同

3. 验证码错误：验证码错误，请重新输入

4. 验证码过期：验证码已过期，请重新获取

5. 手机号已占用：该手机号已被其他账号使用

6. 操作失败：修改失败，请稍后重试

7. 越权访问：无权限访问该数据，请核对账号信息

## 十、研发强制红线

1. **权限双重校验**：前端展示 \+ 后端接口双重校验账户状态与权限，禁止越权

2. **数据隔离**：用户数据严格按 ID 隔离，token 校验不通过直接拒绝请求

3. **操作留痕**：课程 / 作业 / 考试 / 考勤 / 充值操作全量日志留存≥1 年，不可篡改

4. **流程不可逆**：院校绑定、注册登录、作业考试发布流程严格按文档执行，禁止绕过规则

---

要不要我把这份需求**按研发视角拆分为接口清单 \+ 页面原型说明**，直接交付开发团队使用？

当前文件内容过长，豆包只阅读了前 63%。

> （注：文档部分内容可能由 AI 生成）