feat: Mock API

app/api/build.gradle

@@ -1,7 +1,7 @@
-bootJar.enabled = false
-jar.enabled = true
-
 allprojects {
+    bootJar.enabled = false
+    jar.enabled = true
+
     dependencies {
         implementation project(":app:domain:common-domain")
 
@@ -17,5 +17,7 @@ allprojects {
 }
 
 dependencies {
+    // for config registry
     implementation project(":app:api:user-api")
+    implementation project(":app:api:show-api")
 }

app/api/common-api/build.gradle

@@ -1,6 +1,3 @@
-bootJar.enabled = false
-jar.enabled = true
-
 dependencies {
     implementation project(":app:domain:user-domain")
 

app/api/common-api/src/main/java/org/example/config/SecurityConfig.java

@@ -6,6 +6,7 @@
 import org.example.filter.JWTFilter;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.http.HttpMethod;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
 import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
 import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer;
@@ -31,11 +32,37 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Excepti
                 corsConfigurationSource()))
             .formLogin(AbstractHttpConfigurer::disable)
             .httpBasic(AbstractHttpConfigurer::disable)
-            .sessionManagement(configurer -> configurer.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
+            .sessionManagement(
+                configurer -> configurer.sessionCreationPolicy(SessionCreationPolicy.STATELESS)
+            )
             .authorizeHttpRequests(registry ->
                 registry
-                    .requestMatchers("swagger-ui/**", "/v3/api-docs/**").permitAll()
-                    .anyRequest().permitAll()
+                    .requestMatchers(
+                        "swagger-ui/**", "/v3/api-docs/**",
+                        "api/v1/users/login"
+                    ).permitAll()
+                    .requestMatchers(
+                        HttpMethod.GET,
+                        "api/v1/artists",
+                        "api/v1/genres",
+                        "api/v1/shows"
+                    ).permitAll()
+                    .requestMatchers(
+                        HttpMethod.GET,
+                        "api/v1/shows/interests"
+                    ).hasAnyRole("USER", "ADMIN")
+                    .requestMatchers(
+                        HttpMethod.POST,
+                        "api/v1/users/logout",
+                        "api/v1/shows/**/interest",
+                        "api/v1/shows/**/alert"
+                    ).hasAnyRole("USER", "ADMIN")
+                    .requestMatchers(
+                        HttpMethod.POST,
+                        "api/v1/artists",
+                        "api/v1/genres",
+                        "api/v1/shows"
+                    ).hasRole("ADMIN")
             )
             .addFilterBefore(jwtFilter, UsernamePasswordAuthenticationFilter.class)
             .addFilterBefore(exceptionHandlerFilter, JWTFilter.class)

app/api/common-api/src/main/java/org/example/config/SwaggerConfig.java

@@ -5,17 +5,27 @@
 import io.swagger.v3.oas.models.OpenAPI;
 import io.swagger.v3.oas.models.info.Info;
 import io.swagger.v3.oas.models.info.License;
+import io.swagger.v3.oas.models.security.SecurityRequirement;
+import io.swagger.v3.oas.models.security.SecurityScheme;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 
 @Configuration
 public class SwaggerConfig {
 
+    private final String securitySchemeName = "JWT Authorization";
+
     @Bean
     public OpenAPI openAPI() {
         return new OpenAPI()
-            .components(new Components())
-            .info(getInfo());
+            .info(getInfo())
+            .addSecurityItem(getSecurityRequirement())
+            .components(
+                new Components().addSecuritySchemes(
+                    securitySchemeName,
+                    getSecurityScheme()
+                )
+            );
     }
 
     private Info getInfo() {
@@ -25,6 +35,19 @@ private Info getInfo() {
             .license(getLicense());
     }
 
+    private SecurityRequirement getSecurityRequirement() {
+        return new SecurityRequirement().addList(securitySchemeName);
+    }
+
+    private SecurityScheme getSecurityScheme() {
+        return new SecurityScheme()
+            .name(securitySchemeName)
+            .type(SecurityScheme.Type.HTTP)
+            .in(SecurityScheme.In.HEADER)
+            .scheme("Bearer")
+            .bearerFormat("JWT");
+    }
+
     private License getLicense() {
         return new License()
             .name("Apache 2.0")

app/api/show-api/build.gradle

@@ -0,0 +1,3 @@
+dependencies {
+    implementation project(':app:api:common-api')
+}

app/api/show-api/src/main/java/com/example/artist/controller/ArtistAdminController.java

@@ -0,0 +1,12 @@
+package com.example.artist.controller;
+
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@Tag(name = "어드민")
+public class ArtistAdminController {
+
+}

app/api/show-api/src/main/java/com/example/artist/controller/ArtistController.java

@@ -0,0 +1,64 @@
+package com.example.artist.controller;
+
+import com.example.artist.controller.dto.request.ArtistPaginationApiRequest;
+import com.example.artist.controller.dto.request.ArtistSubscriptionApiRequest;
+import com.example.artist.controller.dto.request.ArtistUnsubscriptionApiRequest;
+import com.example.artist.controller.dto.response.ArtistPaginationApiResponse;
+import com.example.artist.controller.dto.response.ArtistSimpleApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import java.util.List;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/artists")
+@Tag(name = "아티스트")
+public class ArtistController {
+
+    private String image = "https://thumb.mtstarnews.com/06/2023/06/2023062914274537673_1.jpg";
+
+    @GetMapping
+    @Operation(summary = "아티스트 목록 조회")
+    public ResponseEntity<ArtistPaginationApiResponse> getArtists(
+        @RequestParam(required = false) ArtistPaginationApiRequest param
+    ) {
+        return ResponseEntity.ok(
+            new ArtistPaginationApiResponse(
+                List.of(
+                    new ArtistSimpleApiResponse(
+                        UUID.randomUUID(),
+                        "윈터",
+                        image
+                    )
+                ),
+                false
+            )
+        );
+    }
+
+    @PostMapping("/subscribe")
+    @Operation(summary = "구독하기")
+    public ResponseEntity<Void> bulkSubscribe(
+        @Valid @RequestBody ArtistSubscriptionApiRequest request
+    ) {
+        return ResponseEntity.noContent().build();
+    }
+
+    @PostMapping("/unsubscribe")
+    @Operation(summary = "구독 취소하기")
+    public ResponseEntity<Void> unsubscribe(
+        @Valid @RequestBody ArtistUnsubscriptionApiRequest request
+    ) {
+        return ResponseEntity.noContent().build();
+    }
+}

app/api/show-api/src/main/java/com/example/artist/controller/dto/request/ArtistPaginationApiRequest.java

@@ -0,0 +1,26 @@
+package com.example.artist.controller.dto.request;
+
+import io.swagger.v3.oas.annotations.Parameter;
+import java.util.UUID;
+import org.example.pagination.vo.SortDirection;
+import org.springdoc.core.annotations.ParameterObject;
+
+@ParameterObject
+public record ArtistPaginationApiRequest(
+
+    @Parameter(description = "검색어")
+    String search,
+
+    @Parameter(description = "정렬 방향")
+    SortDirection sortDirection,
+
+    @Parameter(description = "이전 페이지네이션 마지막 데이터의 ID / 최초 조회라면 null")
+    UUID cursor
+) {
+
+    public ArtistPaginationApiRequest {
+        if (sortDirection == null) {
+            sortDirection = SortDirection.DESC;
+        }
+    }
+}

app/api/show-api/src/main/java/com/example/artist/controller/dto/request/ArtistSubscriptionApiRequest.java

@@ -0,0 +1,14 @@
+package com.example.artist.controller.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import java.util.List;
+import java.util.UUID;
+
+public record ArtistSubscriptionApiRequest(
+    @Schema(description = "아티스트 ID 목록")
+    @NotEmpty(message = "아티스트 ID는 최소 하나 이상 입력해야합니다.")
+    List<UUID> artistIds
+) {
+
+}

app/api/show-api/src/main/java/com/example/artist/controller/dto/request/ArtistUnsubscriptionApiRequest.java

@@ -0,0 +1,15 @@
+package com.example.artist.controller.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import java.util.List;
+import java.util.UUID;
+
+public record ArtistUnsubscriptionApiRequest(
+
+    @Schema(description = "아티스트 ID 목록")
+    @NotEmpty(message = "아티스트 ID는 최소 하나 이상 입력해야합니다.")
+    List<UUID> artistIds
+) {
+
+}

app/api/show-api/src/main/java/com/example/artist/controller/dto/response/ArtistPaginationApiResponse.java

@@ -0,0 +1,15 @@
+package com.example.artist.controller.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+
+public record ArtistPaginationApiResponse(
+
+    @Schema(description = "아티스트 목록")
+    List<ArtistSimpleApiResponse> artists,
+
+    @Schema(description = "다음 페이지 존재 여부")
+    boolean hasNext
+) {
+
+}

app/api/show-api/src/main/java/com/example/artist/controller/dto/response/ArtistSimpleApiResponse.java

@@ -0,0 +1,18 @@
+package com.example.artist.controller.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.UUID;
+
+public record ArtistSimpleApiResponse(
+
+    @Schema(description = "아티스트 ID")
+    UUID id,
+
+    @Schema(description = "아티스트 이름")
+    String name,
+
+    @Schema(description = "아티스트 이미지 주소")
+    String image
+) {
+
+}

app/api/show-api/src/main/java/com/example/config/ShowApiConfig.java

@@ -0,0 +1,10 @@
+package com.example.config;
+
+import org.springframework.context.annotation.ComponentScan;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+@ComponentScan(basePackages = "com.example")
+public class ShowApiConfig {
+
+}

app/api/show-api/src/main/java/com/example/genre/controller/GenreAdminController.java

@@ -0,0 +1,8 @@
+package com.example.genre.controller;
+
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class GenreAdminController {
+
+}

app/api/show-api/src/main/java/com/example/genre/controller/GenreController.java

@@ -0,0 +1,73 @@
+package com.example.genre.controller;
+
+import com.example.genre.controller.dto.request.GenrePaginationApiRequest;
+import com.example.genre.controller.dto.request.GenreSubscriptionApiRequest;
+import com.example.genre.controller.dto.request.GenreUnsubscriptionApiRequest;
+import com.example.genre.controller.dto.response.GenrePaginationApiResponse;
+import com.example.genre.controller.dto.response.GenreSimpleApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import java.util.List;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/genres")
+@Tag(name = "장르")
+public class GenreController {
+
+    @GetMapping
+    @Operation(summary = "장르 목록 조회")
+    public ResponseEntity<GenrePaginationApiResponse> getGenres(
+        @RequestParam(required = false) GenrePaginationApiRequest param
+    ) {
+        String image = "https://thumb.mtstarnews.com/06/2023/06/2023062914274537673_1.jpg";
+        return ResponseEntity.ok(
+            new GenrePaginationApiResponse(
+                List.of(
+                    new GenreSimpleApiResponse(
+                        UUID.randomUUID(),
+                        "힙합",
+                        image
+                    ),
+                    new GenreSimpleApiResponse(
+                        UUID.randomUUID(),
+                        "발라드",
+                        image
+                    ),
+                    new GenreSimpleApiResponse(
+                        UUID.randomUUID(),
+                        "시티팝",
+                        image
+                    )
+                ),
+                false
+            )
+        );
+    }
+
+    @PostMapping("/subscribe")
+    @Operation(summary = "구독하기")
+    public ResponseEntity<Void> subscribe(
+        @Valid @RequestBody GenreSubscriptionApiRequest request
+    ) {
+        return ResponseEntity.noContent().build();
+    }
+
+    @PostMapping("/unsubscribe")
+    @Operation(summary = "구독 취소하기")
+    public ResponseEntity<Void> unsubscribe(
+        @Valid @RequestBody GenreUnsubscriptionApiRequest request
+    ) {
+        return ResponseEntity.noContent().build();
+    }
+}