diff --git a/api.md b/api.md index d089a4b..298da74 100644 --- a/api.md +++ b/api.md @@ -5,11 +5,379 @@ ```json { "code": 200, // 状态码 - "msg": "", // 错误信息 + "msg": "", // 错误信息 "data": {} // 具体响应数据 } ``` +## 成员管理 +基础路径: `/api/members` + +### 1. 创建成员 +- 请求方式: `POST` +- 请求路径: `/api/members` +- 请求体: `Member`对象 +```json +{ + "userName": "用户名", + "avatar": "头像URL", + "password": "密码", + "salt": "密码盐值", + "name": "姓名", + "address": "地址", + "postcode": "邮编", + "sruNumber": "SRU编号", + "dateOfBirth": "1990-01-01", + "telNumber": "固定电话", + "mobileNumber": "手机号码", + "email": "电子邮箱" +} +``` +- 响应: 成功返回空数据 + +### 2. 删除成员 +- 请求方式: `DELETE` +- 请求路径: `/api/members/{id}` +- 路径参数: `id` - 成员ID +- 响应: 成功返回空数据 + +### 3. 更新成员 +- 请求方式: `PUT` +- 请求路径: `/api/members` +- 请求体: `Member`对象 +- 响应: 成功返回空数据 + +### 4. 获取单个成员 +- 请求方式: `GET` +- 请求路径: `/api/members/{id}` +- 路径参数: `id` - 成员ID +- 响应: 返回成员详细信息 + +### 5. 分页获取成员列表 +- 请求方式: `GET` +- 请求路径: `/api/members/page` +- 请求参数: + - `pageNum`: 页码（默认1） + - `pageSize`: 每页大小（默认10） +- 响应: 返回分页数据 + +### 6. 获取随机成员 +- 请求方式: `GET` +- 请求路径: `/api/members/random` +- 响应: 返回4个随机成员的详细信息 +```json +{ + "code": 200, + "msg": "", + "data": [ + { + "avatar": "头像URL", + "name": "成员姓名", + "dateOfBirth": "1990-01-01", + "role": "角色名称", + "sruNumber": "SRU编号", + "email": "电子邮箱" + } + ] +} +``` + +## 球员管理 +基础路径: `/api/players` + +### 1. 创建球员 +- 请求方式: `POST` +- 请求路径: `/api/players` +- 请求体: `Player`对象 +```json +{ + "memberId": "成员ID", + "teamId": "团队ID", + "position": "位置", + "teamNumber": "队内编号", + "height": 180, + "weight": 75, + "guardian1Name": "监护人1姓名", + "guardian1Relationship": "与监护人1关系", + "guardian1Address": "监护人1地址", + "guardian1Tel": "监护人1电话", + "guardian2Name": "监护人2姓名", + "guardian2Relationship": "与监护人2关系", + "guardian2Address": "监护人2地址", + "guardian2Tel": "监护人2电话", + "doctorName": "医生姓名", + "doctorTel": "医生电话", + "doctorAddress": "医生地址", + "knownHealthIssues": "已知健康问题" +} +``` +- 响应: 成功返回空数据 + +### 2. 删除球员 +- 请求方式: `DELETE` +- 请求路径: `/api/players/{id}` +- 路径参数: `id` - 球员ID +- 响应: 成功返回空数据 + +### 3. 更新球员 +- 请求方式: `PUT` +- 请求路径: `/api/players` +- 请求体: `Player`对象 +- 响应: 成功返回空数据 + +### 4. 获取单个球员 +- 请求方式: `GET` +- 请求路径: `/api/players/{id}` +- 路径参数: `id` - 球员ID +- 响应: 返回球员详细信息 + +### 5. 分页获取球员列表 +- 请求方式: `GET` +- 请求路径: `/api/players/page` +- 请求参数: + - `pageNum`: 页码（默认1） + - `pageSize`: 每页大小（默认10） +- 响应: 返回分页数据，包含以下字段： +```json +{ + "code": 200, + "msg": "", + "data": { + "records": [ + { + "id": "球员ID", + "position": "位置", + "teamNumber": "队内编号", + "height": 180, + "weight": 75, + "createTime": "2024-04-10T16:30:00", + "name": "姓名", + "avatar": "头像URL", + "sruNumber": "SRU编号", + "dateOfBirth": "1990-01-01", + "email": "电子邮箱", + "telNumber": "固定电话", + "mobileNumber": "手机号码", + "guardian1Name": "监护人1姓名", + "guardian1Tel": "监护人1电话", + "guardian2Name": "监护人2姓名", + "guardian2Tel": "监护人2电话", + "doctorName": "医生姓名", + "doctorTel": "医生电话", + "knownHealthIssues": "已知健康问题", + "teamName": "队伍名称" + } + ], + "total": 100, + "size": 10, + "current": 1 + } +} +``` + +### 6. 按团队分页获取球员列表 +- 请求方式: `GET` +- 请求路径: `/api/players/page/team/{teamId}` +- 路径参数: `teamId` - 团队ID +- 请求参数: + - `pageNum`: 页码（默认1） + - `pageSize`: 每页大小（默认10） +- 响应: 返回分页数据 + +### 7. 获取随机球员 +- 请求方式: `GET` +- 请求路径: `/api/players/random` +- 响应: 返回3个随机球员的详细信息 +```json +{ + "code": 200, + "msg": "", + "data": [ + { + "name": "球员姓名", + "avatar": "头像URL", + "teamName": "队伍名称", + "position": "位置", + "teamNumber": "队内编号", + "height": 180, + "weight": 75, + "createTime": "2024-04-10T16:30:00", + "passingStandard": 5, + "passingSpin": 5, + "passingPop": 5, + "tacklingFront": 5, + "tacklingRear": 5, + "tacklingSide": 5, + "tacklingScrabble": 5, + "kickingDrop": 5, + "kickingPunt": 5, + "kickingGrubber": 5, + "kickingGoal": 5 + } + ] +} +``` + +## 球员技能档案管理 +基础路径: `/api/player-skills` + +### 1. 创建技能档案 +- 请求方式: `POST` +- 请求路径: `/api/player-skills` +- 请求体: `PlayerSkillProfile`对象 +```json +{ + "playerId": "球员ID", + "passingStandard": 5, + "passingStandardComment": "标准传球评价", + "passingSpin": 5, + "passingSpinComment": "旋转传球评价", + "passingPop": 5, + "passingPopComment": "快速传球评价", + "tacklingFront": 5, + "tacklingFrontComment": "正面铲球评价", + "tacklingRear": 5, + "tacklingRearComment": "背后铲球评价", + "tacklingSide": 5, + "tacklingSideComment": "侧面铲球评价", + "tacklingScrabble": 5, + "tacklingScrabbleComment": "争抢铲球评价", + "kickingDrop": 5, + "kickingDropComment": "落地踢球评价", + "kickingPunt": 5, + "kickingPuntComment": "踢远球评价", + "kickingGrubber": 5, + "kickingGrubberComment": "滚地踢球评价", + "kickingGoal": 5, + "kickingGoalComment": "射门评价" +} +``` +- 响应: 成功返回空数据 + +### 2. 删除技能档案 +- 请求方式: `DELETE` +- 请求路径: `/api/player-skills/{id}` +- 路径参数: `id` - 技能档案ID +- 响应: 成功返回空数据 + +### 3. 更新技能档案 +- 请求方式: `PUT` +- 请求路径: `/api/player-skills` +- 请求体: `PlayerSkillProfile`对象 +- 响应: 成功返回空数据 + +### 4. 获取单个技能档案 +- 请求方式: `GET` +- 请求路径: `/api/player-skills/{id}` +- 路径参数: `id` - 技能档案ID +- 响应: 返回技能档案详细信息 + +### 5. 获取球员的技能档案 +- 请求方式: `GET` +- 请求路径: `/api/player-skills/player/{playerId}` +- 路径参数: `playerId` - 球员ID +- 响应: 返回技能档案详细信息 + +### 6. 分页获取技能档案列表 +- 请求方式: `GET` +- 请求路径: `/api/player-skills/page` +- 请求参数: + - `pageNum`: 页码（默认1） + - `pageSize`: 每页大小（默认10） +- 响应: 返回分页数据 + +## 公告管理 +基础路径: `/api/announcements` + +### 1. 创建公告 +- 请求方式: `POST` +- 请求路径: `/api/announcements` +- 请求体: `Announcement`对象 +```json +{ + "title": "公告标题", + "content": "公告内容", + "time": "2024-03-21T10:00:00" +} +``` +- 响应: +```json +{ + "code": 200, + "msg": "", + "data": null +} +``` + +### 2. 删除公告 +- 请求方式: `DELETE` +- 请求路径: `/api/announcements/{id}` +- 路径参数: `id` - 公告ID +- 响应: +```json +{ + "code": 200, + "msg": "", + "data": null +} +``` + +### 3. 更新公告 +- 请求方式: `PUT` +- 请求路径: `/api/announcements` +- 请求体: `Announcement`对象 +```json +{ + "id": "公告ID", + "title": "公告标题", + "content": "公告内容", + "time": "2024-03-21T10:00:00" +} +``` +- 响应: +```json +{ + "code": 200, + "msg": "", + "data": null +} +``` + +### 4. 获取单个公告 +- 请求方式: `GET` +- 请求路径: `/api/announcements/{id}` +- 路径参数: `id` - 公告ID +- 响应: +```json +{ + "code": 200, + "msg": "", + "data": { + "id": "公告ID", + "title": "公告标题", + "content": "公告内容", + "time": "2024-03-21T10:00:00" + } +} +``` + +### 5. 获取最新公告 +- 请求方式: `GET` +- 请求路径: `/api/announcements/latest` +- 响应: +```json +{ + "code": 200, + "msg": "", + "data": { + "id": "公告ID", + "title": "公告标题", + "content": "公告内容", + "time": "2024-03-21T10:00:00" + } +} +``` + ## 广告模块 ### 1. 创建广告 diff --git a/src/main/java/org/sqa/simply_rugby/SimpleRugbyApplication.java b/src/main/java/org/sqa/simply_rugby/SimpleRugbyApplication.java index 7f37d2e..b2fad68 100644 --- a/src/main/java/org/sqa/simply_rugby/SimpleRugbyApplication.java +++ b/src/main/java/org/sqa/simply_rugby/SimpleRugbyApplication.java @@ -3,7 +3,7 @@ package org.sqa.simply_rugby; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; -@SpringBootApplication +@SpringBootApplication(scanBasePackages = "org.sqa.simply_rugby") public class SimpleRugbyApplication { public static void main(String[] args) { diff --git a/src/main/java/org/sqa/simply_rugby/common/Result.java b/src/main/java/org/sqa/simply_rugby/common/Result.java index c9d8eb2..9372990 100644 --- a/src/main/java/org/sqa/simply_rugby/common/Result.java +++ b/src/main/java/org/sqa/simply_rugby/common/Result.java @@ -5,35 +5,33 @@ import lombok.Data; @Data public class Result { private Integer code; - private String message; + private String msg; private T data; public static Result success() { Result result = new Result<>(); - result.setCode(ResultCode.SUCCESS.getCode()); - result.setMessage(ResultCode.SUCCESS.getMessage()); + result.setCode(200); return result; } public static Result success(T data) { Result result = new Result<>(); - result.setCode(ResultCode.SUCCESS.getCode()); - result.setMessage(ResultCode.SUCCESS.getMessage()); + result.setCode(200); result.setData(data); return result; } - public static Result error(String message) { + public static Result error(String msg) { Result result = new Result<>(); - result.setCode(ResultCode.INTERNAL_ERROR.getCode()); - result.setMessage(message); + result.setCode(500); + result.setMsg(msg); return result; } - public static Result error(Integer code, String message) { + public static Result error(Integer code, String msg) { Result result = new Result<>(); result.setCode(code); - result.setMessage(message); + result.setMsg(msg); return result; } diff --git a/src/main/java/org/sqa/simply_rugby/config/MybatisPlusConfig.java b/src/main/java/org/sqa/simply_rugby/config/MybatisPlusConfig.java index 623ed59..bb1563d 100644 --- a/src/main/java/org/sqa/simply_rugby/config/MybatisPlusConfig.java +++ b/src/main/java/org/sqa/simply_rugby/config/MybatisPlusConfig.java @@ -3,10 +3,12 @@ package org.sqa.simply_rugby.config; import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; +import org.mybatis.spring.annotation.MapperScan; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration +@MapperScan("org.sqa.simply_rugby.mapper") public class MybatisPlusConfig { /** diff --git a/src/main/java/org/sqa/simply_rugby/controller/AdController.java b/src/main/java/org/sqa/simply_rugby/controller/AdController.java index 1b7a99b..4428508 100644 --- a/src/main/java/org/sqa/simply_rugby/controller/AdController.java +++ b/src/main/java/org/sqa/simply_rugby/controller/AdController.java @@ -8,6 +8,9 @@ import org.sqa.simply_rugby.service.AdService; import jakarta.annotation.Resource; import java.util.List; +/** + * 广告管理控制器 + */ @RestController @RequestMapping("/ad") public class AdController { diff --git a/src/main/java/org/sqa/simply_rugby/controller/MatchController.java b/src/main/java/org/sqa/simply_rugby/controller/MatchController.java index b011a3d..c830d4f 100644 --- a/src/main/java/org/sqa/simply_rugby/controller/MatchController.java +++ b/src/main/java/org/sqa/simply_rugby/controller/MatchController.java @@ -9,6 +9,9 @@ import org.sqa.simply_rugby.domain.entity.Match; import org.sqa.simply_rugby.service.TeamService; import org.sqa.simply_rugby.service.MatchService; +/** + * 比赛管理控制器 + */ @RestController @RequestMapping("/api/matches") public class MatchController { @@ -52,6 +55,9 @@ public class MatchController { .or() .eq(Match::getOpponentTeamId, teamId); } + // 按比赛日期倒序排序 + wrapper.orderByDesc(Match::getDateOfMatch); + Page page = matchService.page(new Page<>(pageNum, pageSize), wrapper); // 为每个比赛添加队伍信息 page.getRecords().forEach(match -> { diff --git a/src/main/java/org/sqa/simply_rugby/controller/TeamController.java b/src/main/java/org/sqa/simply_rugby/controller/TeamController.java index 85211f0..d7d2e5e 100644 --- a/src/main/java/org/sqa/simply_rugby/controller/TeamController.java +++ b/src/main/java/org/sqa/simply_rugby/controller/TeamController.java @@ -8,6 +8,9 @@ import org.sqa.simply_rugby.common.Result; import org.sqa.simply_rugby.domain.entity.Team; import org.sqa.simply_rugby.service.TeamService; +/** + * 队伍管理控制器 + */ @RestController @RequestMapping("/api/teams") public class TeamController { diff --git a/src/main/java/org/sqa/simply_rugby/domain/entity/Match.java b/src/main/java/org/sqa/simply_rugby/domain/entity/Match.java index 1328999..7293c64 100644 --- a/src/main/java/org/sqa/simply_rugby/domain/entity/Match.java +++ b/src/main/java/org/sqa/simply_rugby/domain/entity/Match.java @@ -21,6 +21,8 @@ public class Match { private String location; + private String venue; + private LocalDate dateOfMatch; private LocalTime koTime; diff --git a/src/main/java/org/sqa/simply_rugby/domain/entity/Team.java b/src/main/java/org/sqa/simply_rugby/domain/entity/Team.java index d85fe7d..5435be2 100644 --- a/src/main/java/org/sqa/simply_rugby/domain/entity/Team.java +++ b/src/main/java/org/sqa/simply_rugby/domain/entity/Team.java @@ -1,6 +1,5 @@ package org.sqa.simply_rugby.domain.entity; -import com.baomidou.mybatisplus.annotation.IdType; import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; @@ -8,12 +7,9 @@ import lombok.Data; @Data @TableName("team") public class Team { - @TableId(type = IdType.ASSIGN_ID) + @TableId private String id; - private String coachId; - private String logo; - private String teamName; } \ No newline at end of file diff --git a/src/main/java/org/sqa/simply_rugby/service/TeamService.java b/src/main/java/org/sqa/simply_rugby/service/TeamService.java index 60d61b6..dcd6d4d 100644 --- a/src/main/java/org/sqa/simply_rugby/service/TeamService.java +++ b/src/main/java/org/sqa/simply_rugby/service/TeamService.java @@ -1,5 +1,6 @@ package org.sqa.simply_rugby.service; +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.baomidou.mybatisplus.extension.service.IService; import org.sqa.simply_rugby.domain.entity.Team; @@ -10,4 +11,6 @@ public interface TeamService extends IService { * @return 球队信息 */ Team getTeamById(String id); + + Page page(Integer pageNum, Integer pageSize); } \ No newline at end of file diff --git a/src/main/java/org/sqa/simply_rugby/service/impl/TeamServiceImpl.java b/src/main/java/org/sqa/simply_rugby/service/impl/TeamServiceImpl.java index 2e17004..c45778a 100644 --- a/src/main/java/org/sqa/simply_rugby/service/impl/TeamServiceImpl.java +++ b/src/main/java/org/sqa/simply_rugby/service/impl/TeamServiceImpl.java @@ -1,5 +1,6 @@ package org.sqa.simply_rugby.service.impl; +import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; import org.springframework.stereotype.Service; import org.sqa.simply_rugby.domain.entity.Team; @@ -13,4 +14,9 @@ public class TeamServiceImpl extends ServiceImpl implements Te public Team getTeamById(String id) { return this.getById(id); } + + @Override + public Page page(Integer pageNum, Integer pageSize) { + return page(new Page<>(pageNum, pageSize)); + } } \ No newline at end of file