实现快传,完善快传和网盘的功能,实现文件的互传等一系列功能
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
|
||||
- 用户注册、登录、JWT 鉴权、用户信息接口
|
||||
- 个人网盘上传、下载、删除、目录管理、分页列表
|
||||
- CQU 课表与成绩聚合接口
|
||||
- 快传会话与浏览器间 P2P 信令接口
|
||||
- Swagger 文档、统一异常、日志输出
|
||||
|
||||
## 环境要求
|
||||
@@ -32,7 +32,6 @@ mvn spring-boot:run -Dspring-boot.run.profiles=dev
|
||||
`dev` 环境特点:
|
||||
|
||||
- 数据库使用 H2 文件库
|
||||
- CQU 接口返回 mock 数据
|
||||
- 方便和 `vue/` 前端直接联调
|
||||
|
||||
JWT 启动要求:
|
||||
@@ -54,39 +53,20 @@ JWT 启动要求:
|
||||
|
||||
## 旧库升级
|
||||
|
||||
如果服务器数据库是按旧版脚本初始化的,需要先补齐下面这些字段,否则登录后的首页接口可能在查询用户、课表或成绩时直接报 500。
|
||||
如果服务器数据库是按旧版脚本初始化的,旧教务相关字段和表可以保留但不会再被当前代码使用。新环境请直接使用最新初始化脚本,不再创建教务缓存表。
|
||||
|
||||
MySQL:
|
||||
|
||||
```sql
|
||||
ALTER TABLE portal_user
|
||||
ADD COLUMN last_school_student_id VARCHAR(64) NULL,
|
||||
ADD COLUMN last_school_semester VARCHAR(64) NULL;
|
||||
|
||||
ALTER TABLE portal_course
|
||||
ADD COLUMN semester VARCHAR(64) NULL,
|
||||
ADD COLUMN student_id VARCHAR(64) NULL;
|
||||
|
||||
ALTER TABLE portal_grade
|
||||
ADD COLUMN student_id VARCHAR(64) NULL;
|
||||
|
||||
CREATE INDEX idx_course_user_semester ON portal_course (user_id, semester, student_id);
|
||||
CREATE INDEX idx_grade_user_semester ON portal_grade (user_id, semester, student_id);
|
||||
DROP TABLE IF EXISTS portal_course;
|
||||
DROP TABLE IF EXISTS portal_grade;
|
||||
```
|
||||
|
||||
openGauss:
|
||||
|
||||
```sql
|
||||
ALTER TABLE portal_user ADD COLUMN IF NOT EXISTS last_school_student_id VARCHAR(64);
|
||||
ALTER TABLE portal_user ADD COLUMN IF NOT EXISTS last_school_semester VARCHAR(64);
|
||||
|
||||
ALTER TABLE portal_course ADD COLUMN IF NOT EXISTS semester VARCHAR(64);
|
||||
ALTER TABLE portal_course ADD COLUMN IF NOT EXISTS student_id VARCHAR(64);
|
||||
|
||||
ALTER TABLE portal_grade ADD COLUMN IF NOT EXISTS student_id VARCHAR(64);
|
||||
|
||||
CREATE INDEX IF NOT EXISTS idx_course_user_semester ON portal_course (user_id, semester, student_id);
|
||||
CREATE INDEX IF NOT EXISTS idx_grade_user_semester ON portal_grade (user_id, semester, student_id);
|
||||
DROP TABLE IF EXISTS portal_course;
|
||||
DROP TABLE IF EXISTS portal_grade;
|
||||
```
|
||||
|
||||
## 主要接口
|
||||
@@ -103,22 +83,11 @@ CREATE INDEX IF NOT EXISTS idx_grade_user_semester ON portal_grade (user_id, sem
|
||||
- `GET /api/files/download/{fileId}`
|
||||
- `GET /api/files/download/{fileId}/url`
|
||||
- `DELETE /api/files/{fileId}`
|
||||
- `GET /api/cqu/schedule`
|
||||
- `GET /api/cqu/grades`
|
||||
|
||||
## CQU 配置
|
||||
|
||||
部署到真实环境时修改:
|
||||
|
||||
```yaml
|
||||
app:
|
||||
cqu:
|
||||
base-url: https://your-cqu-api
|
||||
require-login: false
|
||||
mock-enabled: false
|
||||
```
|
||||
|
||||
当前 Java 后端保留了 HTTP 适配点;本地 `dev` 环境使用 mock 数据先把前后端链路跑通。
|
||||
- `POST /api/transfer/sessions`
|
||||
- `GET /api/transfer/sessions/lookup`
|
||||
- `POST /api/transfer/sessions/{sessionId}/join`
|
||||
- `POST /api/transfer/sessions/{sessionId}/signals`
|
||||
- `GET /api/transfer/sessions/{sessionId}/signals`
|
||||
|
||||
## OSS 直传说明
|
||||
|
||||
|
||||
Reference in New Issue
Block a user