9.8 KiB

Raw Blame History

院校模块（School）后台接口文档

适用范围：后台管理（CRUD / 导入导出 / 聚合详情）。

代码位置：jeecg-module-system/jeecg-system-biz/src/main/java/org/jeecg/modules/school/controller/*

1. 基础约定（JEECG-Boot）

1.1 基础地址

默认 server.servlet.context-path 为 /jeecg-boot
文档中接口地址以：/jeecg-boot + Controller 的 @RequestMapping 为准

示例：

GET /jeecg-boot/school/school/list

1.2 认证

需要登录后调用（通常前端会在请求头携带 token）
权限控制使用 @RequiresPermissions（文档中会标注权限码）

1.3 统一返回结构

接口统一返回：org.jeecg.common.api.vo.Result<T>。

成功示例：

{
  "success": true,
  "message": "",
  "code": 200,
  "result": {},
  "timestamp": 1700000000000
}

失败示例：

{
  "success": false,
  "message": "未找到对应数据",
  "code": 500,
  "result": null,
  "timestamp": 1700000000000
}

1.4 分页返回结构（MyBatis-Plus IPage）

分页接口 result 为 IPage<T>，常见字段示例：

{
  "success": true,
  "code": 200,
  "result": {
    "records": [],
    "total": 0,
    "size": 10,
    "current": 1,
    "pages": 0
  }
}

1.5 导入 / 导出

导出：GET /exportXls，返回 Excel 文件流
导入：POST /importExcel，multipart/form-data，上传字段名通常为 file

2. 数据表与字段说明（摘要）

下面仅列出接口当前代码中实体字段；若你按 Task2_solution.md 扩展了更多列，可继续在实体中补字段以支持后台维护。

2.1 学校主表（t_school）

字段	类型	说明
id	Long	主键ID
mainCode	String	学校编码（唯一）
mainName	String	学校主名称（官方全称）
shortName	String	学校简称
schoolIcon	String	院校图标（URL）
createBy/createTime	String/Date	创建人/创建时间
updateBy/updateTime	String/Date	更新人/更新时间

2.2 学校详情（t_school_detail）

字段	类型	说明
id	Long	主键ID
schoolId	Long	学校ID
introduction	String	学校简介（大文本）
address	String	地址
contact	String	联系电话
website	String	官网
updateTime	Date	更新时间

2.3 学校名称（t_school_name）

字段	类型	说明
id	Long	主键ID
schoolId	Long	学校ID
name	String	名称（别名/曾用名/英文名）
nameType	Integer	名称类型：1官方全称/2曾用名/3别名/4英文名称

2.4 学校标签（t_school_tag）

字段	类型	说明
id	Long	主键ID
schoolId	Long	学校ID
tagName	String	标签名（985/211/双一流/…）

2.5 学院 / 专业（Task2 扩展表）

学院：t_school_college
专业：t_school_major
专业标签：t_school_major_tag

2.6 校区 / 宿舍 / 媒体 / 招生计划（Task2 扩展表）

校区：t_school_campus
宿舍：t_school_dorm
媒体：t_school_media（biz_type + biz_id）
招生计划：t_school_enroll_plan

3. 接口清单

说明：所有 /list 接口均支持 pageNo / pageSize 分页。

对于使用 QueryGenerator 的 /list：可通过 query 参数传实体字段实现筛选（例如 schoolId=1、majorName=计算机）。

3.1 学校主表（SchoolController）

Base：/jeecg-boot/school/school

3.1.1 分页列表（通用查询）

Method: GET
Path: /list
权限：无（如需权限可自行加 @RequiresPermissions）
Query:
- pageNo：默认 1
- pageSize：默认 10
- 其他：t_school 对应字段（例如 mainName、mainCode 等）

3.1.2 关键词搜索（编码/名称/简称/别名）

Method: GET
Path: /search
权限：无
Query:
- keyword：可空
- pageNo、pageSize

3.1.3 新增

Method: POST
Path: /add
权限：school:school:add
Body(JSON)：

{
  "mainCode": "10001",
  "mainName": "示例大学",
  "shortName": "示大",
  "schoolIcon": "https://example.com/icon.png"
}

3.1.4 修改

Method: PUT or POST
Path: /edit
权限：school:school:edit
Body(JSON)：必须包含 id

3.1.5 删除

Method: DELETE
Path: /delete
权限：school:school:delete
Query：id

3.1.6 批量删除

Method: DELETE
Path: /deleteBatch
权限：school:school:deleteBatch
Query：ids（逗号分隔 Long，例如：1,2,3）

3.1.7 按ID查询

Method: GET
Path: /queryById
Query：id

3.1.8 全量聚合详情（按ID）

Method: GET
Path: /fullById
Query：id
返回：SchoolFullVO（主表 + detail + names + tags + colleges/majors/...）

3.1.9 全量聚合详情（按mainCode）

Method: GET
Path: /fullByMainCode
Query：mainCode

3.1.10 导出

Method: GET
Path: /exportXls
权限：school:school:exportXls
Query：可带筛选条件（同 /list）

3.1.11 导入

Method: POST
Path: /importExcel
权限：school:school:importExcel
Form-Data：file=@xxx.xlsx

3.2 学校详情（SchoolDetailController）

Base：/jeecg-boot/school/detail

GET /list（QueryGenerator）
POST /add（权限：school:detail:add）
PUT|POST /edit（权限：school:detail:edit）
DELETE /delete（权限：school:detail:delete）
DELETE /deleteBatch（权限：school:detail:deleteBatch）
GET /queryById
GET /exportXls（权限：school:detail:exportXls）
POST /importExcel（权限：school:detail:importExcel）

3.3 学校名称（SchoolNameController）

Base：/jeecg-boot/school/name

GET /list
POST /add（权限：school:name:add）
PUT|POST /edit（权限：school:name:edit）
DELETE /delete（权限：school:name:delete）
DELETE /deleteBatch（权限：school:name:deleteBatch）
GET /queryById
GET /exportXls（权限：school:name:exportXls）
POST /importExcel（权限：school:name:importExcel）

3.4 学校标签（SchoolTagController）

Base：/jeecg-boot/school/tag

GET /list
POST /add（权限：school:tag:add）
PUT|POST /edit（权限：school:tag:edit）
DELETE /delete（权限：school:tag:delete）
DELETE /deleteBatch（权限：school:tag:deleteBatch）
GET /queryById
GET /exportXls（权限：school:tag:exportXls）
POST /importExcel（权限：school:tag:importExcel）

3.5 学院（SchoolCollegeController）

Base：/jeecg-boot/school/college

GET /list
POST /add（权限：school:college:add）
PUT|POST /edit（权限：school:college:edit）
DELETE /delete（权限：school:college:delete）
DELETE /deleteBatch（权限：school:college:deleteBatch）
GET /queryById
GET /exportXls（权限：school:college:exportXls）
POST /importExcel（权限：school:college:importExcel）

3.6 专业（SchoolMajorController）

Base：/jeecg-boot/school/major

GET /list
POST /add（权限：school:major:add）
PUT|POST /edit（权限：school:major:edit）
DELETE /delete（权限：school:major:delete）
DELETE /deleteBatch（权限：school:major:deleteBatch）
GET /queryById
GET /exportXls（权限：school:major:exportXls）
POST /importExcel（权限：school:major:importExcel）

3.7 专业标签（SchoolMajorTagController）

Base：/jeecg-boot/school/majorTag

GET /list
POST /add（权限：school:majorTag:add）
PUT|POST /edit（权限：school:majorTag:edit）
DELETE /delete（权限：school:majorTag:delete）
DELETE /deleteBatch（权限：school:majorTag:deleteBatch）
GET /queryById
GET /exportXls（权限：school:majorTag:exportXls）
POST /importExcel（权限：school:majorTag:importExcel）

3.8 校区（SchoolCampusController）

Base：/jeecg-boot/school/campus

GET /list
POST /add（权限：school:campus:add）
PUT|POST /edit（权限：school:campus:edit）
DELETE /delete（权限：school:campus:delete）
DELETE /deleteBatch（权限：school:campus:deleteBatch）
GET /queryById
GET /exportXls（权限：school:campus:exportXls）
POST /importExcel（权限：school:campus:importExcel）

3.9 宿舍（SchoolDormController）

Base：/jeecg-boot/school/dorm

GET /list
POST /add（权限：school:dorm:add）
PUT|POST /edit（权限：school:dorm:edit）
DELETE /delete（权限：school:dorm:delete）
DELETE /deleteBatch（权限：school:dorm:deleteBatch）
GET /queryById
GET /exportXls（权限：school:dorm:exportXls）
POST /importExcel（权限：school:dorm:importExcel）

3.10 媒体（SchoolMediaController）

Base：/jeecg-boot/school/media

GET /list
POST /add（权限：school:media:add）
PUT|POST /edit（权限：school:media:edit）
DELETE /delete（权限：school:media:delete）
DELETE /deleteBatch（权限：school:media:deleteBatch）
GET /queryById
GET /exportXls（权限：school:media:exportXls）
POST /importExcel（权限：school:media:importExcel）

3.11 招生计划（SchoolEnrollPlanController）

Base：/jeecg-boot/school/enrollPlan

GET /list
POST /add（权限：school:enrollPlan:add）
PUT|POST /edit（权限：school:enrollPlan:edit）
DELETE /delete（权限：school:enrollPlan:delete）
DELETE /deleteBatch（权限：school:enrollPlan:deleteBatch）
GET /queryById
GET /exportXls（权限：school:enrollPlan:exportXls）
POST /importExcel（权限：school:enrollPlan:importExcel）

9.8 KiB Raw Blame History Unescape Escape