matchday-server/src/main/java/com/example/moim/match/controller/MatchControllerDocs.java at d4beca7b20fef5c1bc4a21cdae452598594ce8c7 · S-nect1/matchday-server · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
package com.example.moim.match.controller;

import com.example.moim.global.exception.BaseResponse;
import com.example.moim.match.dto.*;
import com.example.moim.user.dto.UserDetailsImpl;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;

@Tag(name = "매치 api", description = "매치 관련 api")
public interface MatchControllerDocs {
    @Operation(summary = "매치 생성")
    BaseResponse<MatchOutput> matchSave(@RequestBody @Valid MatchInput matchInput, @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 등록")
    BaseResponse<MatchRegOutput> matchRegister(@RequestBody @Valid MatchRegInput matchRegInput,
                                               @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 생성 취소")
    BaseResponse<String> matchCreationCancel(@RequestParam Long matchId,
                                             @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 신청 생성")
    BaseResponse<MatchApplyOutput> matchApplySave(@RequestParam Long matchId,
                                                  @RequestParam Long clubId,
                                                  @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 신청 취소")
    BaseResponse<String> matchApplyCancel(@RequestParam Long matchId,
                                          @RequestParam Long clubId,
                                          @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 신청 완료")
    BaseResponse<MatchApplyOutput> matchApply(@RequestBody @Valid MatchApplyInput matchApplyInput,
                                              @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);


    @Operation(summary = "매치 초청")
    BaseResponse<String> matchInvite(@RequestParam Long matchId,
                                     @RequestParam Long clubId,
                                     @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 확정")
    BaseResponse<MatchConfirmOutput> matchConfirm(@RequestParam Long matchId,
                                                  @RequestParam Long clubId,
                                                  @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 확정 취소")
    BaseResponse<String> cancelConfirmedMatch(@RequestParam Long matchId,
                                              @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "등록된 매치 검색")
    BaseResponse<List<MatchSearchOutput>> findMatches(@AuthenticationPrincipal UserDetailsImpl userDetailsImpl,
                                                      @ModelAttribute MatchSearchCond matchSearchCond);

    @Operation(summary = "확정된(매치성사된) 매치 리스트")
    BaseResponse<List<ConfirmedMatchOutput>> findConfirmedMatches(@AuthenticationPrincipal UserDetailsImpl userDetailsImpl,
                                                                  @PathVariable Long clubId);

    @Operation(summary = "활동 지역 소재 모임 리스트")
    BaseResponse<List<MatchClubOutput>> findMatchClubs(@AuthenticationPrincipal UserDetailsImpl userDetailsImpl,
                                                       @ModelAttribute MatchClubSearchCond matchClubSearchCond,
                                                       @PathVariable Long clubId);

    @Operation(summary = "매치 등록/신청 현황")
    BaseResponse<List<MatchStatusOutput>> getMatchStatus(@PathVariable Long clubId);


    @Operation(summary = "매치 결과 기록")
    BaseResponse<MatchRecordOutput> matchRecordSave(@PathVariable Long matchId,
                                                    @RequestBody @Valid MatchRecordInput matchRecordInput,
                                                    @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);

    @Operation(summary = "매치 메인 페이지(대시보드)")
    BaseResponse<MatchMainOutput> findMatchMain(@PathVariable Long clubId, @AuthenticationPrincipal UserDetailsImpl userDetailsImpl);
}