314 lines
11 KiB
Markdown
314 lines
11 KiB
Markdown
```
|
||
CREATE TABLE departments
|
||
(
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
name VARCHAR(100) NOT NULL COMMENT '部门名称',
|
||
description TEXT DEFAULT NULL COMMENT '部门描述',
|
||
created_at BIGINT NOT NULL COMMENT '创建时间（时间戳）',
|
||
updated_at BIGINT NOT NULL COMMENT '更新时间（时间戳）'
|
||
) ENGINE = InnoDB
|
||
DEFAULT CHARSET = utf8mb4 COMMENT ='部门表';
|
||
CREATE TABLE users
|
||
(
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
username VARCHAR(50) NOT NULL UNIQUE COMMENT '用户名',
|
||
email VARCHAR(100) NOT NULL UNIQUE COMMENT '邮箱',
|
||
password VARCHAR(100) NOT NULL COMMENT '密码',
|
||
department_id BIGINT NOT NULL COMMENT '所属部门',
|
||
roles INT NOT NULL COMMENT '角色: 1-教师, 2-普通管理员, 3-沟通联络人, 4-系统管理员',
|
||
jobs INT NOT NULL COMMENT '岗位: 1-课程制作教师, 2-课程购买方项目负责人, 3-课程制作方沟通联络人, 4-系统制作方项目负责人',
|
||
avatar VARCHAR(255) DEFAULT NULL COMMENT '头像',
|
||
creator_id BIGINT NOT NULL DEFAULT 1 COMMENT '创建用户的管理员ID',
|
||
status INT NOT NULL DEFAULT 1 COMMENT '用户状态: 1-正常, 2-禁用',
|
||
created_at BIGINT NOT NULL COMMENT '创建时间（时间戳）',
|
||
updated_at BIGINT NOT NULL COMMENT '更新时间（时间戳）',
|
||
FOREIGN KEY (department_id) REFERENCES departments (id) ON DELETE RESTRICT,
|
||
INDEX idx_users_department_id (department_id)
|
||
) ENGINE = InnoDB
|
||
DEFAULT CHARSET = utf8mb4 COMMENT ='用户表';
|
||
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 ='课程任务表';
|
||
|
||
INSERT INTO departments (name, description, created_at, updated_at)
|
||
VALUES ('重庆眨生花科技有限公司', '重庆眨生花科技有限公司', NOW(), NOW()),
|
||
('重庆电子科技职业大学', '重庆电子科技职业大学', NOW(), NOW());
|
||
```
|
||
|
||
我修改了 我的表结构
|
||
|
||
接下来我将给你描述我的接口需求
|
||
|
||
**请求失败：**
|
||
|
||
返回错误状态码以：`10XX`开头。
|
||
|
||
错误代码`code`返回为 100XX。`message`为错误描述。
|
||
|
||
```json
|
||
{
|
||
"code": 10005,
|
||
"message": "邮箱已存在"
|
||
}
|
||
```
|
||
|
||
**请求成功：**
|
||
|
||
比失败请求会增加`data`字段。或直接返回最终结果。
|
||
|
||
1、登陆接口
|
||
|
||
## 用户管理
|
||
|
||
### 1.登录
|
||
|
||
接口描述： 使用密码登录
|
||
|
||
接口地址：http://127.0.0.1:8000/api/login
|
||
|
||
请求方式：POST
|
||
|
||
接口参数：
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| :------- | :----- | :------- | :----- | :--- | :---------------------------- |
|
||
| email | 整型 | 是 | | | 用户邮箱 |
|
||
| password | 字符串 | 是 | | | 密码 |
|
||
| remember | 布尔型 | 是 | false | | 会话 token 有效期，记住则更长 |
|
||
|
||
**返回结果**
|
||
|
||
成功示例：
|
||
|
||
| 参数名字 | 类型 | 说明 |
|
||
| -------- | ------ | ---- |
|
||
| token | 字符串 | |
|
||
|
||
```json
|
||
{
|
||
"token": ""
|
||
}
|
||
```
|
||
|
||
失败示例：
|
||
|
||
```json
|
||
{
|
||
"code": 10005,
|
||
"message": "登录失败！请检查邮箱或者密码"
|
||
}
|
||
```
|
||
|
||
### 2.添加用户
|
||
|
||
接口描述： 手动添加用户
|
||
|
||
接口地址：http://127.0.0.1:8000/api/users
|
||
|
||
请求方式：POST
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| ------------- | ------ | -------- | ------ | ---- | ------ |
|
||
| username | 字符串 | 是 | | | 用户名 |
|
||
| email | 字符串 | 是 | | | 邮箱 |
|
||
| password | 字符串 | 是 | | | 密码 |
|
||
| roles | 整型 | 是 | | | 角色 |
|
||
| department_id | 整型 | 是 | | | 部门 |
|
||
| jobs | 整型 | 是 | | | 岗位 |
|
||
|
||
```json
|
||
{
|
||
"username": "test2",
|
||
"email": "root2@cyqsd.cn",
|
||
"password": "Abc123456",
|
||
"roles": 4,
|
||
"jobs": 4,
|
||
"department_id": 1
|
||
}
|
||
```
|
||
|
||
**返回结果**
|
||
|
||
| 参数名字 | 类型 | 说明 |
|
||
| -------- | ------ | ------------------ |
|
||
| code | 整型 | 提示码 |
|
||
| message | 字符串 | 是否成功的提示信息 |
|
||
| data | 字符串 | 数据 ID |
|
||
|
||
```json
|
||
{
|
||
"code": 10000,
|
||
"message": "操作成功",
|
||
"data": "3"
|
||
}
|
||
```
|
||
|
||
### 3.查看用户列表
|
||
|
||
接口描述： 查看用户列表
|
||
|
||
接口地址：http://127.0.0.1:8000/api/users?page=1&limit=10
|
||
|
||
请求方式：GET
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| -------- | ---- | -------- | ------ | ---- | ---- |
|
||
| page | 整型 | 是 | 1 | | |
|
||
| limit | 整型 | 是 | 10 | | |
|
||
|
||
### 4、查看单个用户
|
||
|
||
接口描述： 查看用户列表
|
||
|
||
接口地址：http://127.0.0.1:8000/api/users
|
||
|
||
请求方式：GET
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| -------- | ---- | -------- | ------ | ---- | ------- |
|
||
| id | 整型 | 是 | | | 用户 id |
|
||
|
||
### 5、删除用户
|
||
|
||
通过改变用户状态的方式 来将这个账户停止使用
|
||
|
||
将用户表的用户状态改变
|
||
|
||
### 6、更新账户
|
||
|
||
填了什么字段 就修改什么字段 没填写的字段 还是保留之前的数据
|
||
|
||
## 课程管理
|
||
|
||
### 1.查询列表
|
||
|
||
接口地址：http://127.0.0.1:8000/api/lesson/task?page=1&limit=1
|
||
|
||
接口描述： 查询课程管理列表。
|
||
|
||
请求方式：GET
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| -------- | ---- | -------- | ------ | ----------------- | -------- |
|
||
| page | 整型 | 可选 | 1 | 最小：1 | 第几页 |
|
||
| perpage | 整型 | 可选 | 10 | 最小：1；最大：20 | 分页数量 |
|
||
| user_id | 整型 | 可选 | | | 用户 ID |
|
||
|
||
**返回结果**
|
||
|
||
| 参数名字 | 类型 | 说明 |
|
||
| ------------------- | ------ | -------- |
|
||
| course_name | 字符串 | 见下表 |
|
||
| m_lesson_name | 字符串 | |
|
||
| user_id | 整型 | |
|
||
| schedule_status | 整型 | |
|
||
| script_confirm_time | 整型 | |
|
||
| video_confirm_time | 整型 | |
|
||
| finish_time | 整型 | |
|
||
| script_upload_time | 整型 | |
|
||
| video_capture_time | 整型 | |
|
||
| script_file | 字符串 | |
|
||
| material_file | 字符串 | |
|
||
| capture_file | 字符串 | |
|
||
| advise | 字符串 | |
|
||
| created_at | 整型 | 创建时间 |
|
||
|
||
### 2.新增数据
|
||
|
||
接口地址：http://127.0.0.1:8000/api/lesson/task
|
||
|
||
接口描述： 新增一条课程记录
|
||
|
||
请求方式：POST
|
||
|
||
Content-Type：application/json
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| ------------------- | ------ | -------- | --------- | ---- | ------------------------------ |
|
||
| course_name | 字符串 | 是 | 最大：25 | | 课程名 |
|
||
| m_lesson_name | 字符串 | 是 | 最大：25 | | 微课名 |
|
||
| user_id | 整型 | 是 | 最大：10 | | 用户 ID |
|
||
| schedule_status | 整型 | 否 | 最大：10 | | 当前进度 ID |
|
||
| script_confirm_time | 整型 | 否 | 最大：10 | | 脚本确认时间 |
|
||
| video_confirm_time | 整型 | 否 | 最大：10 | | 视频确认时间 |
|
||
| finish_time | 整型 | 否 | 最大：10 | | 任务完成时间 |
|
||
| script_upload_time | 整型 | 否 | 最大：10 | | 脚本上传时间 |
|
||
| video_capture_time | 整型 | 否 | 最大：10 | | 视频拍摄时间 |
|
||
| script_file | 字符串 | 否 | 最大：255 | | 脚本文件地址 |
|
||
| material_file | 字符串 | 否 | 最大：255 | | 素材文件地址 |
|
||
| capture_file | 字符串 | 否 | 最大：255 | | 拍摄结果文件地址 |
|
||
| advise | 字符串 | 否 | 最大：255 | | 沟通建议列表，自行构建保存格式 |
|
||
|
||
**返回结果**
|
||
|
||
| 参数名字 | 类型 | 说明 |
|
||
| -------- | ---- | ---- |
|
||
| | 整型 | ID |
|
||
|
||
### [#](https://aigc-doc.cqrthny.com/pages/ppmp/#_3-修改数据)3.修改数据
|
||
|
||
接口地址：http://127.0.0.1:8000/api/lesson/task/2
|
||
|
||
接口描述： 修改一条课程记录
|
||
|
||
请求方式：PUT
|
||
|
||
Content-Type：application/json
|
||
|
||
**接口参数**
|
||
|
||
其他需要修改的字段，按`新增数据`小节中的内容修改。
|
||
|
||
### [#](https://aigc-doc.cqrthny.com/pages/ppmp/#_4-删除数据)4.删除数据
|
||
|
||
接口地址：http://127.0.0.1:8000/api/lesson/task/1
|
||
|
||
接口描述： 删除一条课程记录
|
||
|
||
请求方式：DELETE
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| -------- | ---- | -------- | ------ | ---- | ------------------- |
|
||
| 无 | 整型 | 是 | 否 | | 待删除的课程记录 ID |
|
||
|
||
### 5.查询单条数据
|
||
|
||
接口地址：http://127.0.0.1:8000/api/lesson/task/1
|
||
|
||
接口描述： 查询单条课程记录
|
||
|
||
请求方式：GET
|
||
|
||
**接口参数**
|
||
|
||
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|
||
| -------- | ---- | -------- | ------ | ---- | ---- |
|
||
| 无 | | | | | |
|