[DOCS] 대학교 목록 조회 API 스웨거 추가

src/main/java/synk/meeteam/domain/common/university/api/UniversityApi.java

@@ -0,0 +1,22 @@
+package synk.meeteam.domain.common.university.api;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.ResponseEntity;
+import synk.meeteam.domain.common.university.dto.response.GetUniversityListDto;
+
+@Tag(name = "university", description = "대학교 관련 API")
+public interface UniversityApi {
+
+    @ApiResponses(
+            value = {
+                    @ApiResponse(responseCode = "200", description = "대학교 목록 조회에 성공했습니다."),
+                    @ApiResponse(responseCode = "500", description = "서버 에러입니다.", content = @Content)
+            }
+    )
+    @Operation(summary = "대학교 목록 조회", description = "대학교 목록이 조회된다.")
+    ResponseEntity<GetUniversityListDto> getUniversities();
+}

src/main/java/synk/meeteam/domain/common/university/api/UniversityController.java

@@ -0,0 +1,20 @@
+package synk.meeteam.domain.common.university.api;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import synk.meeteam.domain.common.university.dto.response.GetUniversityListDto;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/university")
+public class UniversityController implements UniversityApi {
+
+    @Override
+    @GetMapping
+    public ResponseEntity<GetUniversityListDto> getUniversities() {
+        return null;
+    }
+}

src/main/java/synk/meeteam/domain/common/university/dto/response/GetUniversityDto.java

@@ -0,0 +1,13 @@
+package synk.meeteam.domain.common.university.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+
+public record GetUniversityDto(
+        @Schema(description = "대학교 id", example = "1")
+        Long universityId,
+        @Schema(description = "대학교 이름", example = "광운대학교")
+        String universityName,
+        @Schema(description = "대학교 이메일 도메인", example = "kw.ac.kr")
+        String universityRegex
+) {
+}

src/main/java/synk/meeteam/domain/common/university/dto/response/GetUniversityListDto.java

@@ -0,0 +1,11 @@
+package synk.meeteam.domain.common.university.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+
+@Schema(name = "GetUniversityListDto", description = "대학교 목록 조회 응답 Dto")
+public record GetUniversityListDto(
+        @Schema(description = "대학교 목록", example = "")
+        List<GetUniversityDto> universityList
+) {
+}