diff --git a/src/main/java/com/soptie/server/auth/controller/AuthController.java b/src/main/java/com/soptie/server/auth/controller/AuthController.java index 09d33820..de648edc 100644 --- a/src/main/java/com/soptie/server/auth/controller/AuthController.java +++ b/src/main/java/com/soptie/server/auth/controller/AuthController.java @@ -13,6 +13,7 @@ import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; +import com.soptie.server.auth.controller.docs.AuthControllerDocs; import com.soptie.server.auth.controller.dto.request.SignInRequest; import com.soptie.server.auth.controller.dto.response.SignInResponse; import com.soptie.server.auth.controller.dto.response.TokenGetResponse; @@ -28,7 +29,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/auth") -public class AuthController implements AuthApi { +public class AuthController implements AuthControllerDocs { private final AuthService authService; diff --git a/src/main/java/com/soptie/server/auth/controller/AuthApi.java b/src/main/java/com/soptie/server/auth/controller/docs/AuthControllerDocs.java similarity index 98% rename from src/main/java/com/soptie/server/auth/controller/AuthApi.java rename to src/main/java/com/soptie/server/auth/controller/docs/AuthControllerDocs.java index f3c7176a..d0a3dbea 100644 --- a/src/main/java/com/soptie/server/auth/controller/AuthApi.java +++ b/src/main/java/com/soptie/server/auth/controller/docs/AuthControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.auth.controller; +package com.soptie.server.auth.controller.docs; import java.security.Principal; @@ -21,7 +21,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "auth", description = "인증 API") -public interface AuthApi { +public interface AuthControllerDocs { @Operation( summary = "소셜 로그인", diff --git a/src/main/java/com/soptie/server/doll/controller/DollController.java b/src/main/java/com/soptie/server/doll/controller/DollController.java index 7613e3b6..704d40ad 100644 --- a/src/main/java/com/soptie/server/doll/controller/DollController.java +++ b/src/main/java/com/soptie/server/doll/controller/DollController.java @@ -10,6 +10,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; +import com.soptie.server.doll.controller.docs.DollControllerDocs; import com.soptie.server.doll.dto.DollImageResponse; import com.soptie.server.doll.entity.DollType; import com.soptie.server.doll.service.DollService; @@ -20,7 +21,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/dolls") -public class DollController implements DollApi { +public class DollController implements DollControllerDocs { private final DollService dollService; diff --git a/src/main/java/com/soptie/server/doll/controller/DollApi.java b/src/main/java/com/soptie/server/doll/controller/docs/DollControllerDocs.java similarity index 95% rename from src/main/java/com/soptie/server/doll/controller/DollApi.java rename to src/main/java/com/soptie/server/doll/controller/docs/DollControllerDocs.java index 4f084ebd..254abb4a 100644 --- a/src/main/java/com/soptie/server/doll/controller/DollApi.java +++ b/src/main/java/com/soptie/server/doll/controller/docs/DollControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.doll.controller; +package com.soptie.server.doll.controller.docs; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.PathVariable; @@ -17,7 +17,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "dolls", description = "애착 인형 API") -public interface DollApi { +public interface DollControllerDocs { @Operation( summary = "인형 이미지 불러오기", diff --git a/src/main/java/com/soptie/server/member/controller/MemberController.java b/src/main/java/com/soptie/server/member/controller/MemberController.java index d1906d7a..ce57aef0 100644 --- a/src/main/java/com/soptie/server/member/controller/MemberController.java +++ b/src/main/java/com/soptie/server/member/controller/MemberController.java @@ -17,7 +17,7 @@ import com.soptie.server.common.dto.BaseResponse; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.member.controller.docs.MemberApi; +import com.soptie.server.member.controller.docs.MemberControllerDocs; import com.soptie.server.member.controller.dto.request.MemberProfileCreateRequest; import com.soptie.server.member.controller.dto.response.MemberCottonCountGetResponse; import com.soptie.server.member.controller.dto.response.MemberHomeInfoGetResponse; @@ -33,7 +33,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("api/v1/members") -public class MemberController implements MemberApi { +public class MemberController implements MemberControllerDocs { private final MemberService memberService; diff --git a/src/main/java/com/soptie/server/member/controller/docs/MemberApi.java b/src/main/java/com/soptie/server/member/controller/docs/MemberControllerDocs.java similarity index 99% rename from src/main/java/com/soptie/server/member/controller/docs/MemberApi.java rename to src/main/java/com/soptie/server/member/controller/docs/MemberControllerDocs.java index f7588049..18d94b33 100644 --- a/src/main/java/com/soptie/server/member/controller/docs/MemberApi.java +++ b/src/main/java/com/soptie/server/member/controller/docs/MemberControllerDocs.java @@ -23,7 +23,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "members", description = "회원 API") -public interface MemberApi { +public interface MemberControllerDocs { @Operation( summary = "멤버 프로필 생성", diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberDailyRoutineController.java b/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberDailyRoutineController.java index 3a163b34..fd725f7c 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberDailyRoutineController.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberDailyRoutineController.java @@ -20,7 +20,7 @@ import com.soptie.server.common.dto.BaseResponse; import com.soptie.server.common.dto.SuccessResponse; import com.soptie.server.common.support.UriGenerator; -import com.soptie.server.memberroutine.controller.v1.docs.MemberDailyRoutineApi; +import com.soptie.server.memberroutine.controller.v1.docs.MemberDailyRoutineControllerDocs; import com.soptie.server.memberroutine.controller.v1.dto.request.MemberDailyRoutineCreateRequest; import com.soptie.server.memberroutine.controller.v1.dto.response.MemberDailyRoutineAchieveResponse; import com.soptie.server.memberroutine.controller.v1.dto.response.MemberDailyRoutineCreateResponse; @@ -40,7 +40,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/daily/member") -public class MemberDailyRoutineController implements MemberDailyRoutineApi { +public class MemberDailyRoutineController implements MemberDailyRoutineControllerDocs { private final MemberRoutineCreateService memberRoutineCreateService; private final MemberRoutineReadService memberRoutineReadService; diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberHappinessRoutineController.java b/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberHappinessRoutineController.java index 4a35caf2..0624c6ae 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberHappinessRoutineController.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v1/MemberHappinessRoutineController.java @@ -18,7 +18,7 @@ import com.soptie.server.common.dto.BaseResponse; import com.soptie.server.common.dto.SuccessResponse; import com.soptie.server.common.support.UriGenerator; -import com.soptie.server.memberroutine.controller.v1.docs.MemberHappinessRoutineApi; +import com.soptie.server.memberroutine.controller.v1.docs.MemberHappinessRoutineControllerDocs; import com.soptie.server.memberroutine.controller.v1.dto.request.MemberHappinessRoutineRequest; import com.soptie.server.memberroutine.controller.v1.dto.response.MemberHappinessRoutineCreateResponse; import com.soptie.server.memberroutine.controller.v1.dto.response.MemberHappinessRoutineGetResponse; @@ -37,7 +37,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/happiness/member") -public class MemberHappinessRoutineController implements MemberHappinessRoutineApi { +public class MemberHappinessRoutineController implements MemberHappinessRoutineControllerDocs { private final MemberRoutineCreateService memberRoutineCreateService; private final MemberRoutineReadService memberRoutineReadService; diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v1/api/MemberDailyRoutineApi.java b/src/main/java/com/soptie/server/memberroutine/controller/v1/api/MemberDailyRoutineApi.java deleted file mode 100644 index 74629f28..00000000 --- a/src/main/java/com/soptie/server/memberroutine/controller/v1/api/MemberDailyRoutineApi.java +++ /dev/null @@ -1,133 +0,0 @@ -package com.soptie.server.memberroutine.controller.v1.api; - -import java.security.Principal; -import java.util.List; - -import org.springframework.http.ResponseEntity; -import org.springframework.web.bind.annotation.PathVariable; -import org.springframework.web.bind.annotation.RequestBody; -import org.springframework.web.bind.annotation.RequestParam; - -import com.soptie.server.common.dto.BaseResponse; -import com.soptie.server.common.dto.ErrorResponse; -import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.memberroutine.controller.v1.dto.request.MemberDailyRoutineCreateRequest; -import com.soptie.server.memberroutine.controller.v1.dto.response.MemberDailyRoutineAchieveResponse; -import com.soptie.server.memberroutine.controller.v1.dto.response.MemberDailyRoutineCreateResponse; -import com.soptie.server.memberroutine.controller.v1.dto.response.MemberDailyRoutineListAcquireResponse; - -import io.swagger.v3.oas.annotations.Operation; -import io.swagger.v3.oas.annotations.Parameter; -import io.swagger.v3.oas.annotations.enums.ParameterIn; -import io.swagger.v3.oas.annotations.media.Content; -import io.swagger.v3.oas.annotations.media.Schema; -import io.swagger.v3.oas.annotations.responses.ApiResponse; -import io.swagger.v3.oas.annotations.tags.Tag; - -@Tag(name = "member daily routines V1", description = "회원의 데일리 루틴 API Version1") -public interface MemberDailyRoutineApi { - - @Operation( - summary = "데일리 루틴 추가", - description = "회원의 데일리 루틴을 추가한다.", - responses = { - @ApiResponse(responseCode = "200", description = "성공"), - @ApiResponse( - responseCode = "401", - description = "유효하지 않은 토큰", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "4xx", - description = "클라이언트(요청) 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "500", - description = "서버 내부 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class)))} - ) - ResponseEntity> createMemberDailyRoutine( - @Parameter(hidden = true) Principal principal, - @RequestBody MemberDailyRoutineCreateRequest request - ); - - @Operation( - summary = "데일리 루틴 삭제", - description = "회원의 데일리 루틴을 삭제한다.", - responses = { - @ApiResponse( - responseCode = "200", - description = "성공", - content = @Content(schema = @Schema(implementation = SuccessResponse.class))), - @ApiResponse( - responseCode = "401", - description = "유효하지 않은 토큰", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "4xx", - description = "클라이언트(요청) 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "500", - description = "서버 내부 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class)))} - ) - ResponseEntity deleteMemberDailyRoutines( - @Parameter(hidden = true) Principal principal, - @Parameter( - name = "routines", - description = "삭제할 회원의 데일리 루틴 id 목록", - in = ParameterIn.QUERY, - example = "1,2,3" - ) @RequestParam List routines - ); - - @Operation( - summary = "데일리 루틴 달성", - description = "회원의 데일리 루틴을 달성한다.", - responses = { - @ApiResponse(responseCode = "200", description = "성공"), - @ApiResponse( - responseCode = "401", - description = "유효하지 않은 토큰", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "4xx", - description = "클라이언트(요청) 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "500", - description = "서버 내부 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class)))} - ) - ResponseEntity> achieveMemberDailyRoutine( - @Parameter(hidden = true) Principal principal, - @Parameter( - name = "routineId", - description = "달성한 회원의 데일리 루틴 id", - in = ParameterIn.PATH, - example = "1" - ) @PathVariable long routineId - ); - - @Operation( - summary = "회원의 데일리 루틴 목록 조회", - description = "회원의 데일리 루틴을 달성 여부, 달성 횟수, 루틴 이름 순으로 정렬된 목록으로 조회한다.", - responses = { - @ApiResponse(responseCode = "200", description = "성공"), - @ApiResponse( - responseCode = "401", - description = "유효하지 않은 토큰", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "4xx", - description = "클라이언트(요청) 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class))), - @ApiResponse( - responseCode = "500", - description = "서버 내부 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class)))} - ) - ResponseEntity> getMemberDailyRoutines( - @Parameter(hidden = true) Principal principal - ); -} diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineApi.java b/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineControllerDocs.java similarity index 99% rename from src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineApi.java rename to src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineControllerDocs.java index e2a1db5a..1dc6f973 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineApi.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberDailyRoutineControllerDocs.java @@ -25,7 +25,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "member daily routines V1", description = "회원의 데일리 루틴 API Version1") -public interface MemberDailyRoutineApi { +public interface MemberDailyRoutineControllerDocs { @Operation( summary = "데일리 루틴 추가", diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineApi.java b/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineControllerDocs.java similarity index 98% rename from src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineApi.java rename to src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineControllerDocs.java index a567e0d6..bbd26a2a 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineApi.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v1/docs/MemberHappinessRoutineControllerDocs.java @@ -21,7 +21,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "member happiness routines V1", description = "회원의 행복 루틴 API Version1") -public interface MemberHappinessRoutineApi { +public interface MemberHappinessRoutineControllerDocs { @Operation( summary = "행복 루틴 추가", diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v2/MemberDailyRoutineControllerV2.java b/src/main/java/com/soptie/server/memberroutine/controller/v2/MemberDailyRoutineControllerV2.java index c3ac39f7..3c0c5886 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v2/MemberDailyRoutineControllerV2.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v2/MemberDailyRoutineControllerV2.java @@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.memberroutine.controller.v2.docs.MemberDailyRoutineApi; +import com.soptie.server.memberroutine.controller.v2.docs.MemberDailyRoutineControllerV2Docs; import com.soptie.server.memberroutine.controller.v2.dto.response.MemberDailyRoutineListAcquireResponseV2; import com.soptie.server.memberroutine.service.MemberRoutineReadService; import com.soptie.server.memberroutine.service.dto.request.MemberDailyRoutineListAcquireServiceRequest; @@ -22,7 +22,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v2/routines/daily/member") -public class MemberDailyRoutineControllerV2 implements MemberDailyRoutineApi { +public class MemberDailyRoutineControllerV2 implements MemberDailyRoutineControllerV2Docs { private final MemberRoutineReadService memberRoutineReadService; diff --git a/src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineApi.java b/src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineControllerV2Docs.java similarity index 96% rename from src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineApi.java rename to src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineControllerV2Docs.java index bfc54df4..4de0954d 100644 --- a/src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineApi.java +++ b/src/main/java/com/soptie/server/memberroutine/controller/v2/docs/MemberDailyRoutineControllerV2Docs.java @@ -16,7 +16,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "member daily routines V2", description = "회원의 데일리 루틴 API Version2") -public interface MemberDailyRoutineApi { +public interface MemberDailyRoutineControllerV2Docs { @Operation( summary = "회원의 데일리 루틴 목록 조회", diff --git a/src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineControllerV1.java b/src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineController.java similarity index 93% rename from src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineControllerV1.java rename to src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineController.java index 56722c18..6352d204 100644 --- a/src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineControllerV1.java +++ b/src/main/java/com/soptie/server/routine/controller/v1/DailyRoutineController.java @@ -14,7 +14,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.routine.controller.v1.api.DailyRoutineApiV1; +import com.soptie.server.routine.controller.v1.docs.DailyRoutineControllerDocs; import com.soptie.server.routine.controller.v1.dto.response.DailyRoutineListByThemeGetResponse; import com.soptie.server.routine.controller.v1.dto.response.DailyRoutineListByThemesGetResponse; import com.soptie.server.routine.service.RoutineService; @@ -27,7 +27,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/daily") -public class DailyRoutineControllerV1 implements DailyRoutineApiV1 { +public class DailyRoutineController implements DailyRoutineControllerDocs { private final RoutineService routineService; diff --git a/src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineControllerV1.java b/src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineController.java similarity index 92% rename from src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineControllerV1.java rename to src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineController.java index 3f6fc9c6..10eb3a3e 100644 --- a/src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineControllerV1.java +++ b/src/main/java/com/soptie/server/routine/controller/v1/HappinessRoutineController.java @@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.routine.controller.v1.api.HappinessRoutineApiV1; +import com.soptie.server.routine.controller.v1.docs.HappinessRoutineControllerDocs; import com.soptie.server.routine.controller.v1.dto.response.HappinessRoutineListGetResponse; import com.soptie.server.routine.controller.v1.dto.response.HappinessSubRoutineListGetResponse; import com.soptie.server.routine.service.RoutineService; @@ -24,7 +24,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/happiness") -public class HappinessRoutineControllerV1 implements HappinessRoutineApiV1 { +public class HappinessRoutineController implements HappinessRoutineControllerDocs { private final RoutineService routineService; diff --git a/src/main/java/com/soptie/server/routine/controller/v1/api/DailyRoutineApiV1.java b/src/main/java/com/soptie/server/routine/controller/v1/docs/DailyRoutineControllerDocs.java similarity index 96% rename from src/main/java/com/soptie/server/routine/controller/v1/api/DailyRoutineApiV1.java rename to src/main/java/com/soptie/server/routine/controller/v1/docs/DailyRoutineControllerDocs.java index a04319a0..6ee05127 100644 --- a/src/main/java/com/soptie/server/routine/controller/v1/api/DailyRoutineApiV1.java +++ b/src/main/java/com/soptie/server/routine/controller/v1/docs/DailyRoutineControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.routine.controller.v1.api; +package com.soptie.server.routine.controller.v1.docs; import java.security.Principal; import java.util.List; @@ -21,7 +21,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "daily routines V1", description = "데일리 루틴 API Version1") -public interface DailyRoutineApiV1 { +public interface DailyRoutineControllerDocs { @Operation( summary = "테마 목록별 데일리 루틴 목록 조회", diff --git a/src/main/java/com/soptie/server/routine/controller/v1/api/HappinessRoutineApiV1.java b/src/main/java/com/soptie/server/routine/controller/v1/docs/HappinessRoutineControllerDocs.java similarity index 96% rename from src/main/java/com/soptie/server/routine/controller/v1/api/HappinessRoutineApiV1.java rename to src/main/java/com/soptie/server/routine/controller/v1/docs/HappinessRoutineControllerDocs.java index a29f2e9a..8b97e1a8 100644 --- a/src/main/java/com/soptie/server/routine/controller/v1/api/HappinessRoutineApiV1.java +++ b/src/main/java/com/soptie/server/routine/controller/v1/docs/HappinessRoutineControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.routine.controller.v1.api; +package com.soptie.server.routine.controller.v1.docs; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.PathVariable; @@ -18,7 +18,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "happiness routines", description = "행복 루틴 API") -public interface HappinessRoutineApiV1 { +public interface HappinessRoutineControllerDocs { @Operation( summary = "테마 목록별 행복 루틴 목록 조회", diff --git a/src/main/java/com/soptie/server/test/TestApi.java b/src/main/java/com/soptie/server/test/TestApi.java deleted file mode 100644 index 08b46b75..00000000 --- a/src/main/java/com/soptie/server/test/TestApi.java +++ /dev/null @@ -1,32 +0,0 @@ -package com.soptie.server.test; - -import org.springframework.http.ResponseEntity; - -import com.soptie.server.common.dto.BaseResponse; -import com.soptie.server.common.dto.ErrorResponse; -import com.soptie.server.common.dto.SuccessResponse; - -import io.swagger.v3.oas.annotations.Operation; -import io.swagger.v3.oas.annotations.media.Content; -import io.swagger.v3.oas.annotations.media.Schema; -import io.swagger.v3.oas.annotations.responses.ApiResponse; -import io.swagger.v3.oas.annotations.tags.Tag; - -@Tag(name = "test", description = "테스트 API") -public interface TestApi { - - @Operation( - summary = "서버 연결", - description = "서버의 연결 여부를 테스트한다.", - responses = { - @ApiResponse( - responseCode = "200", - description = "성공", - content = @Content(schema = @Schema(implementation = SuccessResponse.class))), - @ApiResponse( - responseCode = "500", - description = "서버 내부 오류", - content = @Content(schema = @Schema(implementation = ErrorResponse.class)))} - ) - ResponseEntity test(); -} diff --git a/src/main/java/com/soptie/server/test/TestController.java b/src/main/java/com/soptie/server/test/TestController.java index f46bfbeb..06f3338d 100644 --- a/src/main/java/com/soptie/server/test/TestController.java +++ b/src/main/java/com/soptie/server/test/TestController.java @@ -11,7 +11,7 @@ @RestController @RequestMapping("/api/v1/test") -public class TestController implements TestApi { +public class TestController { @GetMapping public ResponseEntity test() { diff --git a/src/main/java/com/soptie/server/theme/controller/v1/DailyThemeControllerV1.java b/src/main/java/com/soptie/server/theme/controller/v1/DailyThemeController.java similarity index 87% rename from src/main/java/com/soptie/server/theme/controller/v1/DailyThemeControllerV1.java rename to src/main/java/com/soptie/server/theme/controller/v1/DailyThemeController.java index 25e8b254..311c3634 100644 --- a/src/main/java/com/soptie/server/theme/controller/v1/DailyThemeControllerV1.java +++ b/src/main/java/com/soptie/server/theme/controller/v1/DailyThemeController.java @@ -9,7 +9,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.theme.controller.v1.api.DailyThemeApiV1; +import com.soptie.server.theme.controller.v1.docs.DailyThemeControllerDocs; import com.soptie.server.theme.controller.v1.dto.response.DailyThemeListGetResponse; import com.soptie.server.theme.service.ThemeService; @@ -19,7 +19,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/daily/themes") -public class DailyThemeControllerV1 implements DailyThemeApiV1 { +public class DailyThemeController implements DailyThemeControllerDocs { private final ThemeService themeService; diff --git a/src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeControllerV1.java b/src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeController.java similarity index 87% rename from src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeControllerV1.java rename to src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeController.java index 2af2443f..5656504c 100644 --- a/src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeControllerV1.java +++ b/src/main/java/com/soptie/server/theme/controller/v1/HappinessThemeController.java @@ -9,7 +9,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; -import com.soptie.server.theme.controller.v1.api.HappinessThemeApiV1; +import com.soptie.server.theme.controller.v1.docs.HappinessThemeControllerDocs; import com.soptie.server.theme.controller.v1.dto.response.HappinessThemeListGetResponse; import com.soptie.server.theme.service.ThemeService; @@ -19,7 +19,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/routines/happiness/themes") -public class HappinessThemeControllerV1 implements HappinessThemeApiV1 { +public class HappinessThemeController implements HappinessThemeControllerDocs { private final ThemeService themeService; diff --git a/src/main/java/com/soptie/server/theme/controller/v1/api/DailyThemeApiV1.java b/src/main/java/com/soptie/server/theme/controller/v1/docs/DailyThemeControllerDocs.java similarity index 92% rename from src/main/java/com/soptie/server/theme/controller/v1/api/DailyThemeApiV1.java rename to src/main/java/com/soptie/server/theme/controller/v1/docs/DailyThemeControllerDocs.java index 24de8b86..e527e48e 100644 --- a/src/main/java/com/soptie/server/theme/controller/v1/api/DailyThemeApiV1.java +++ b/src/main/java/com/soptie/server/theme/controller/v1/docs/DailyThemeControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.theme.controller.v1.api; +package com.soptie.server.theme.controller.v1.docs; import org.springframework.http.ResponseEntity; @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "daily themes V1", description = "데일리 테마 API Version1") -public interface DailyThemeApiV1 { +public interface DailyThemeControllerDocs { @Operation( summary = "데일리 루틴 테마 목록 조회", diff --git a/src/main/java/com/soptie/server/theme/controller/v1/api/HappinessThemeApiV1.java b/src/main/java/com/soptie/server/theme/controller/v1/docs/HappinessThemeControllerDocs.java similarity index 91% rename from src/main/java/com/soptie/server/theme/controller/v1/api/HappinessThemeApiV1.java rename to src/main/java/com/soptie/server/theme/controller/v1/docs/HappinessThemeControllerDocs.java index 4ff326b6..5118536e 100644 --- a/src/main/java/com/soptie/server/theme/controller/v1/api/HappinessThemeApiV1.java +++ b/src/main/java/com/soptie/server/theme/controller/v1/docs/HappinessThemeControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.theme.controller.v1.api; +package com.soptie.server.theme.controller.v1.docs; import org.springframework.http.ResponseEntity; @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "happiness theme V1", description = "행복 테마 API Version1") -public interface HappinessThemeApiV1 { +public interface HappinessThemeControllerDocs { @Operation( summary = "행복 루틴 테마 목록 조회", diff --git a/src/main/java/com/soptie/server/theme/controller/v2/ThemeControllerV2.java b/src/main/java/com/soptie/server/theme/controller/v2/ThemeControllerV2.java index 2382ffbf..d1ec2128 100644 --- a/src/main/java/com/soptie/server/theme/controller/v2/ThemeControllerV2.java +++ b/src/main/java/com/soptie/server/theme/controller/v2/ThemeControllerV2.java @@ -9,6 +9,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; +import com.soptie.server.theme.controller.v2.docs.ThemeControllerV2Docs; import com.soptie.server.theme.controller.v2.dto.response.ThemeListAcquireResponse; import com.soptie.server.theme.service.ThemeService; @@ -18,7 +19,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v2/themes") -public class ThemeControllerV2 implements ThemeApi { +public class ThemeControllerV2 implements ThemeControllerV2Docs { private final ThemeService themeService; diff --git a/src/main/java/com/soptie/server/theme/controller/v2/ThemeApi.java b/src/main/java/com/soptie/server/theme/controller/v2/docs/ThemeControllerV2Docs.java similarity index 92% rename from src/main/java/com/soptie/server/theme/controller/v2/ThemeApi.java rename to src/main/java/com/soptie/server/theme/controller/v2/docs/ThemeControllerV2Docs.java index d081e38d..2ec69863 100644 --- a/src/main/java/com/soptie/server/theme/controller/v2/ThemeApi.java +++ b/src/main/java/com/soptie/server/theme/controller/v2/docs/ThemeControllerV2Docs.java @@ -1,4 +1,4 @@ -package com.soptie.server.theme.controller.v2; +package com.soptie.server.theme.controller.v2.docs; import org.springframework.http.ResponseEntity; @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "themes-v2", description = "테마 API Version2") -public interface ThemeApi { +public interface ThemeControllerV2Docs { @Operation( summary = "테마 목록 조회", diff --git a/src/main/java/com/soptie/server/version/controller/VersionController.java b/src/main/java/com/soptie/server/version/controller/VersionController.java index afd3b7e5..680ec808 100644 --- a/src/main/java/com/soptie/server/version/controller/VersionController.java +++ b/src/main/java/com/soptie/server/version/controller/VersionController.java @@ -8,6 +8,7 @@ import org.springframework.web.bind.annotation.RestController; import com.soptie.server.common.dto.SuccessResponse; +import com.soptie.server.version.controller.docs.VersionControllerDocs; import com.soptie.server.version.controller.dto.response.AppVersionGetResponse; import com.soptie.server.version.service.VersionService; @@ -17,7 +18,7 @@ @RestController @RequiredArgsConstructor @RequestMapping("/api/v1/versions") -public class VersionController implements VersionApi { +public class VersionController implements VersionControllerDocs { private final VersionService versionService; diff --git a/src/main/java/com/soptie/server/version/controller/VersionApi.java b/src/main/java/com/soptie/server/version/controller/docs/VersionControllerDocs.java similarity index 91% rename from src/main/java/com/soptie/server/version/controller/VersionApi.java rename to src/main/java/com/soptie/server/version/controller/docs/VersionControllerDocs.java index e479558b..61a2a7f2 100644 --- a/src/main/java/com/soptie/server/version/controller/VersionApi.java +++ b/src/main/java/com/soptie/server/version/controller/docs/VersionControllerDocs.java @@ -1,4 +1,4 @@ -package com.soptie.server.version.controller; +package com.soptie.server.version.controller.docs; import org.springframework.http.ResponseEntity; @@ -13,7 +13,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; @Tag(name = "versions", description = "버전 API") -public interface VersionApi { +public interface VersionControllerDocs { @Operation( summary = "모바일 앱 버전 조회",