diff --git a/.dockerignore b/.dockerignore index 4465ed7c..85f20fce 100644 --- a/.dockerignore +++ b/.dockerignore @@ -2,4 +2,18 @@ build/ **/build/ out/ -!api/build/libs/ \ No newline at end of file +!api/build/libs/ + +# Gradle +.gradle + +# IDE +.idea +*.iml + +# OS +.DS_Store + +# Git +.git +.gitignore diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b88a8d76..c6f7f32a 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -21,10 +21,10 @@ jobs: java-version: '21' distribution: 'temurin' - - name: Set up Gradle with cache + - name: Set up Gradle cache uses: gradle/actions/setup-gradle@v4 - - name: Build bootJar without tests + - name: Build without tests run: ./gradlew bootJar -x test dependency-submission: diff --git a/Dockerfile b/Dockerfile index 2c70912e..e3cb257c 100644 --- a/Dockerfile +++ b/Dockerfile @@ -18,8 +18,9 @@ RUN ls -la /app FROM openjdk:21-jdk WORKDIR /app +COPY ./motimo-api/build/libs/motimo-api-*.jar app.jar -COPY --from=builder /app/motimo-api/build/libs/motimo-api-*.jar app.jar +#COPY --from=builder /app/motimo-api/build/libs/motimo-api-*.jar app.jar EXPOSE 8080 diff --git a/motimo-api/gradle/wrapper/gradle-wrapper.jar b/motimo-api/gradle/wrapper/gradle-wrapper.jar deleted file mode 100644 index 9bbc975c..00000000 Binary files a/motimo-api/gradle/wrapper/gradle-wrapper.jar and /dev/null differ diff --git a/motimo-api/gradle/wrapper/gradle-wrapper.properties b/motimo-api/gradle/wrapper/gradle-wrapper.properties deleted file mode 100644 index 37f853b1..00000000 --- a/motimo-api/gradle/wrapper/gradle-wrapper.properties +++ /dev/null @@ -1,7 +0,0 @@ -distributionBase=GRADLE_USER_HOME -distributionPath=wrapper/dists -distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip -networkTimeout=10000 -validateDistributionUrl=true -zipStoreBase=GRADLE_USER_HOME -zipStorePath=wrapper/dists diff --git a/motimo-api/src/main/java/kr/co/api/cheer/CheerController.java b/motimo-api/src/main/java/kr/co/api/cheer/CheerController.java new file mode 100644 index 00000000..cdd0b814 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/cheer/CheerController.java @@ -0,0 +1,17 @@ +package kr.co.api.cheer; + +import kr.co.api.cheer.docs.CheerControllerSwagger; +import kr.co.api.cheer.rqrs.CheerPhraseRs; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/v1/cheers") +public class CheerController implements CheerControllerSwagger { + + @GetMapping + public CheerPhraseRs getCheerPhrase() { + return new CheerPhraseRs("오늘도 파이팅이에요!"); + } +} diff --git a/motimo-api/src/main/java/kr/co/api/cheer/docs/CheerControllerSwagger.java b/motimo-api/src/main/java/kr/co/api/cheer/docs/CheerControllerSwagger.java new file mode 100644 index 00000000..96aa79c4 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/cheer/docs/CheerControllerSwagger.java @@ -0,0 +1,11 @@ +package kr.co.api.cheer.docs; + +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import kr.co.api.cheer.rqrs.CheerPhraseRs; + +@Tag(name = "응원 API", description = "응원 관련 API 목록입니다") +public interface CheerControllerSwagger { + @Operation(summary = "응원 문구 조회 API", description = "응원 문구를 랜덤 조회합니다.") + CheerPhraseRs getCheerPhrase(); +} diff --git a/motimo-api/src/main/java/kr/co/api/cheer/rqrs/CheerPhraseRs.java b/motimo-api/src/main/java/kr/co/api/cheer/rqrs/CheerPhraseRs.java new file mode 100644 index 00000000..36395f67 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/cheer/rqrs/CheerPhraseRs.java @@ -0,0 +1,9 @@ +package kr.co.api.cheer.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; + +public record CheerPhraseRs( + @Schema(description = "응원 문구", example = "목표는 멀어도 나는 계속 가는중") + String cheerPhrase +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/config/SwaggerConfig.java b/motimo-api/src/main/java/kr/co/api/config/SwaggerConfig.java index 2073ece0..d37a5dbc 100644 --- a/motimo-api/src/main/java/kr/co/api/config/SwaggerConfig.java +++ b/motimo-api/src/main/java/kr/co/api/config/SwaggerConfig.java @@ -1,6 +1,9 @@ package kr.co.api.config; +import io.swagger.v3.oas.models.OpenAPI; import io.swagger.v3.oas.models.info.Info; +import io.swagger.v3.oas.models.security.SecurityRequirement; +import io.swagger.v3.oas.models.security.SecurityScheme; import org.springdoc.core.models.GroupedOpenApi; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -11,39 +14,51 @@ public class SwaggerConfig { @Bean public GroupedOpenApi motimoAPI() { return GroupedOpenApi - .builder() - .group("Motimo API List") - .addOpenApiCustomizer( - openApi -> - openApi - .setInfo( - new Info() - .title("Motimo API List") // API 제목 - .description("모티모 API 목록입니다.") // API 설명 - .version("1.0.0") // API 버전 - ) - ) - .build(); + .builder() + .group("Motimo API List") + .addOpenApiCustomizer(openApi -> { + jwtSecuritySetting(openApi); + openApi.setInfo( + new Info() + .title("Motimo API List") + .description("모티모 API 목록입니다.") + .version("1.0.0") + ); + }) + .build(); } + + @Bean public GroupedOpenApi version1() { return GroupedOpenApi - .builder() - .group("Motimo V1 API List") - .pathsToMatch("/v1/**") - .addOpenApiCustomizer( - openApi -> - openApi - .setInfo( - new Info() - .title("Motimo Version1 API List") - .description("모티모 버전 1 API 목록입니다.") - .version("1.0.0") - ) - ) - .build(); + .builder() + .group("Motimo V1 API List") + .pathsToMatch("/v1/**") + .addOpenApiCustomizer(openApi -> { + jwtSecuritySetting(openApi); + openApi.setInfo( + new Info() + .title("Motimo Version1 API List") + .description("모티모 버전 1 API 목록입니다.") + .version("1.0.0") + ); + }) + .build(); } + private void jwtSecuritySetting(OpenAPI openApi) { + openApi.getComponents().addSecuritySchemes("BearerAuth", + new SecurityScheme() + .type(SecurityScheme.Type.HTTP) + .scheme("bearer") + .bearerFormat("JWT") + .in(SecurityScheme.In.HEADER) + ); + + openApi.addSecurityItem(new SecurityRequirement().addList("BearerAuth")); + } + } \ No newline at end of file diff --git a/motimo-api/src/main/java/kr/co/api/goal/GoalController.java b/motimo-api/src/main/java/kr/co/api/goal/GoalController.java new file mode 100644 index 00000000..eaa5cfcc --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/GoalController.java @@ -0,0 +1,38 @@ +package kr.co.api.goal; + +import kr.co.api.goal.docs.GoalControllerSwagger; +import kr.co.api.goal.rqrs.*; +import kr.co.api.security.annotation.AuthUser; +import org.springframework.http.HttpStatus; +import org.springframework.web.bind.annotation.*; + +import java.time.LocalDate; +import java.util.ArrayList; +import java.util.List; +import java.util.UUID; + +@RestController +@RequestMapping("/v1/goals") +public class GoalController implements GoalControllerSwagger { + + @ResponseStatus(HttpStatus.CREATED) + @PostMapping + public GoalIdRs createGoal(@RequestBody GoalCreateRq rq) { + return new GoalIdRs(UUID.randomUUID().toString()); + } + + @PutMapping("/{id}") + public void updateGoal(@PathVariable String id, GoalUpdateRq rq) { + } + + @GetMapping + public GoalListRs getGoalList(@AuthUser UUID userId) { + List items = new ArrayList<>(); + items.add(new GoalItemRs("첫번째 목표", LocalDate.now(), 50)); + items.add(new GoalItemRs("자격증 따기", LocalDate.of(2026, 2, 10), 20)); + items.add(new GoalItemRs("노래 만들기", LocalDate.now(), 100)); + return new GoalListRs( + items + ); + } +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/docs/GoalControllerSwagger.java b/motimo-api/src/main/java/kr/co/api/goal/docs/GoalControllerSwagger.java new file mode 100644 index 00000000..4aa81923 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/docs/GoalControllerSwagger.java @@ -0,0 +1,22 @@ +package kr.co.api.goal.docs; + +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import kr.co.api.goal.rqrs.GoalCreateRq; +import kr.co.api.goal.rqrs.GoalIdRs; +import kr.co.api.goal.rqrs.GoalListRs; +import kr.co.api.goal.rqrs.GoalUpdateRq; + +import java.util.UUID; + +@Tag(name = "목표 API", description = "목표 관련 API 목록입니다") +public interface GoalControllerSwagger { + @Operation(summary = "목표 생성 API", description = "목표를 생성합니다.") + GoalIdRs createGoal(GoalCreateRq rq); + + @Operation(summary = "목표 수정 API", description = "목표를 수정합니다.") + void updateGoal(String id, GoalUpdateRq rq); + + @Operation(summary = "목표 목록 API", description = "목표 목록을 조회합니다.") + GoalListRs getGoalList(UUID userId); +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalCreateRq.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalCreateRq.java new file mode 100644 index 00000000..1803f71a --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalCreateRq.java @@ -0,0 +1,33 @@ +package kr.co.api.goal.rqrs; + +import com.fasterxml.jackson.annotation.JsonSetter; +import com.fasterxml.jackson.annotation.Nulls; +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +import java.time.LocalDate; +import java.util.List; + +public record GoalCreateRq( + @NotNull + @Size(min = 1, max = 20) + @Schema(description = "목표 이름", example = "자격증 따기") + String title, + + @NotNull + @Schema(description = "개월 수로 기간 설정 여부") + boolean isPeriodByMonth, + + @Size(min = 1, max = 12) + @Schema(description = "목표 개월 수") + Integer month, + + @Schema(description = "목표 완료 날짜", format = "date") + LocalDate dueDate, + + @Schema(description = "세부 목표 목록") + @JsonSetter(nulls = Nulls.AS_EMPTY) + List subGoals +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalIdRs.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalIdRs.java new file mode 100644 index 00000000..d0a9d18f --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalIdRs.java @@ -0,0 +1,9 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; + +public record GoalIdRs( + @Schema(description = "생성된 아이디") + String id +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalItemRs.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalItemRs.java new file mode 100644 index 00000000..e3d2c430 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalItemRs.java @@ -0,0 +1,17 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; + +import java.time.LocalDate; + +public record GoalItemRs( + @Schema(description = "목표 이름", example = "자격증 따기") + String title, + + @Schema(description = "목표 완료 날짜", type = "date") + LocalDate dueDate, + + @Schema(description = "목표 달성률 (%)", example = "24.5") + float progress +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalListRs.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalListRs.java new file mode 100644 index 00000000..d7082863 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalListRs.java @@ -0,0 +1,11 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; + +import java.util.List; + +public record GoalListRs( + @Schema(description = "목표 목록") + List goals +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalUpdateRq.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalUpdateRq.java new file mode 100644 index 00000000..a8b94aeb --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/GoalUpdateRq.java @@ -0,0 +1,30 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +import java.time.LocalDate; +import java.util.ArrayList; +import java.util.List; +import java.util.Objects; + +public record GoalUpdateRq( + @NotNull + @Size(min = 1, max = 20) + @Schema(description = "목표 이름", example = "자격증 따기") + String title, + + @NotNull + @Schema(description = "목표 완료 날짜", format = "date") + LocalDate dueDate, + + @Schema(description = "세부 목표 목록") + List subGoals +) { + public GoalUpdateRq { + if (Objects.isNull(subGoals)) { + subGoals = new ArrayList<>(); + } + } +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalCreateRq.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalCreateRq.java new file mode 100644 index 00000000..698279b3 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalCreateRq.java @@ -0,0 +1,17 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +public record SubGoalCreateRq( + @NotNull + @Size(min = 1, max = 20) + @Schema(description = "세부 목표 이름", example = "책 한 권 읽기") + String title, + + @Size(min = 1, max = 3) + @Schema(description = "세부 목표 중요도 (상: 1, 하:3)") + int importance +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalUpdateRq.java b/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalUpdateRq.java new file mode 100644 index 00000000..c8e67077 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/goal/rqrs/SubGoalUpdateRq.java @@ -0,0 +1,20 @@ +package kr.co.api.goal.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +public record SubGoalUpdateRq( + @Schema(description = "수정할 세부 목표 아이디") + String id, + + @NotNull + @Size(min = 1, max = 20) + @Schema(description = "세부 목표 이름", example = "책 한 권 읽기") + String title, + + @Size(min = 1, max = 3) + @Schema(description = "세부 목표 중요도 (상: 1, 하:3)") + int importance +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/point/PointController.java b/motimo-api/src/main/java/kr/co/api/point/PointController.java new file mode 100644 index 00000000..a9c4da90 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/point/PointController.java @@ -0,0 +1,20 @@ +package kr.co.api.point; + +import kr.co.api.point.docs.PointControllerSwagger; +import kr.co.api.point.rqrs.PointRs; +import kr.co.api.security.annotation.AuthUser; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.util.UUID; + +@RestController +@RequestMapping("/v1/points") +public class PointController implements PointControllerSwagger { + + @GetMapping + public PointRs getPoint(@AuthUser UUID userId) { + return new PointRs(3000); + } +} diff --git a/motimo-api/src/main/java/kr/co/api/point/docs/PointControllerSwagger.java b/motimo-api/src/main/java/kr/co/api/point/docs/PointControllerSwagger.java new file mode 100644 index 00000000..736a6d98 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/point/docs/PointControllerSwagger.java @@ -0,0 +1,15 @@ +package kr.co.api.point.docs; + +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import kr.co.api.point.rqrs.PointRs; +import kr.co.api.security.annotation.AuthUser; + +import java.util.UUID; + +@Tag(name = "포인트 API", description = "포인트 관련 API 목록입니다") +public interface PointControllerSwagger { + + @Operation(summary = "현재 획득한 포인트 조회 API", description = "사용자가 획득한 포인트를 조회합니다.") + PointRs getPoint(@AuthUser UUID userId); +} diff --git a/motimo-api/src/main/java/kr/co/api/point/rqrs/PointRs.java b/motimo-api/src/main/java/kr/co/api/point/rqrs/PointRs.java new file mode 100644 index 00000000..93355ef3 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/point/rqrs/PointRs.java @@ -0,0 +1,9 @@ +package kr.co.api.point.rqrs; + +import io.swagger.v3.oas.annotations.media.Schema; + +public record PointRs( + @Schema(description = "사용자가 현재 획득한 포인트", example = "1000") + int point +) { +} diff --git a/motimo-api/src/main/java/kr/co/api/security/annotation/AuthToken.java b/motimo-api/src/main/java/kr/co/api/security/annotation/AuthToken.java index 33999af6..b7b04484 100644 --- a/motimo-api/src/main/java/kr/co/api/security/annotation/AuthToken.java +++ b/motimo-api/src/main/java/kr/co/api/security/annotation/AuthToken.java @@ -1,9 +1,12 @@ package kr.co.api.security.annotation; +import io.swagger.v3.oas.annotations.Parameter; + import java.lang.annotation.*; @Target({ElementType.METHOD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Documented +@Parameter(hidden = true) public @interface AuthToken { } diff --git a/motimo-api/src/main/java/kr/co/api/security/annotation/AuthUser.java b/motimo-api/src/main/java/kr/co/api/security/annotation/AuthUser.java index 49fdd87a..99fc96f4 100644 --- a/motimo-api/src/main/java/kr/co/api/security/annotation/AuthUser.java +++ b/motimo-api/src/main/java/kr/co/api/security/annotation/AuthUser.java @@ -1,9 +1,12 @@ package kr.co.api.security.annotation; +import io.swagger.v3.oas.annotations.Parameter; + import java.lang.annotation.*; @Target({ElementType.METHOD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Documented +@Parameter(hidden = true) public @interface AuthUser { } diff --git a/motimo-api/src/main/java/kr/co/api/security/resolver/AuthTokenArgumentResolver.java b/motimo-api/src/main/java/kr/co/api/security/resolver/AuthTokenArgumentResolver.java index a7f0b163..175b8ea6 100644 --- a/motimo-api/src/main/java/kr/co/api/security/resolver/AuthTokenArgumentResolver.java +++ b/motimo-api/src/main/java/kr/co/api/security/resolver/AuthTokenArgumentResolver.java @@ -11,6 +11,8 @@ import org.springframework.web.method.support.HandlerMethodArgumentResolver; import org.springframework.web.method.support.ModelAndViewContainer; +import java.util.UUID; + @Component public class AuthTokenArgumentResolver implements HandlerMethodArgumentResolver { @@ -26,10 +28,10 @@ public boolean supportsParameter(MethodParameter parameter) { } @Override - public Object resolveArgument(MethodParameter parameter, - ModelAndViewContainer mavContainer, - NativeWebRequest webRequest, - WebDataBinderFactory binderFactory) throws Exception { + public UUID resolveArgument(MethodParameter parameter, + ModelAndViewContainer mavContainer, + NativeWebRequest webRequest, + WebDataBinderFactory binderFactory) throws Exception { HttpServletRequest request = (HttpServletRequest) webRequest.getNativeRequest(); String header = request.getHeader(HttpHeaders.AUTHORIZATION); diff --git a/motimo-api/src/main/java/kr/co/api/security/resolver/AuthUserArgumentResolver.java b/motimo-api/src/main/java/kr/co/api/security/resolver/AuthUserArgumentResolver.java index cb999a16..1d547386 100644 --- a/motimo-api/src/main/java/kr/co/api/security/resolver/AuthUserArgumentResolver.java +++ b/motimo-api/src/main/java/kr/co/api/security/resolver/AuthUserArgumentResolver.java @@ -11,6 +11,8 @@ import org.springframework.web.method.support.HandlerMethodArgumentResolver; import org.springframework.web.method.support.ModelAndViewContainer; +import java.util.UUID; + @Component public class AuthUserArgumentResolver implements HandlerMethodArgumentResolver { @@ -26,10 +28,10 @@ public boolean supportsParameter(MethodParameter parameter) { } @Override - public Object resolveArgument(MethodParameter parameter, - ModelAndViewContainer mavContainer, - NativeWebRequest webRequest, - WebDataBinderFactory binderFactory) throws Exception { + public UUID resolveArgument(MethodParameter parameter, + ModelAndViewContainer mavContainer, + NativeWebRequest webRequest, + WebDataBinderFactory binderFactory) throws Exception { HttpServletRequest request = (HttpServletRequest) webRequest.getNativeRequest(); String header = request.getHeader(HttpHeaders.AUTHORIZATION); diff --git a/motimo-api/src/main/java/kr/co/api/user/controller/UserController.java b/motimo-api/src/main/java/kr/co/api/user/controller/UserController.java new file mode 100644 index 00000000..c148ae88 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/user/controller/UserController.java @@ -0,0 +1,11 @@ +package kr.co.api.user.controller; + +import kr.co.api.user.docs.UserControllerSwagger; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/v1/users") +public class UserController implements UserControllerSwagger { + +} diff --git a/motimo-api/src/main/java/kr/co/api/user/docs/UserControllerSwagger.java b/motimo-api/src/main/java/kr/co/api/user/docs/UserControllerSwagger.java new file mode 100644 index 00000000..64565a17 --- /dev/null +++ b/motimo-api/src/main/java/kr/co/api/user/docs/UserControllerSwagger.java @@ -0,0 +1,7 @@ +package kr.co.api.user.docs; + +import io.swagger.v3.oas.annotations.tags.Tag; + +@Tag(name = "사용자 API", description = "사용자 관련 API 목록입니다") +public interface UserControllerSwagger { +}