✨ [Feature/room] implement create room

kok-api/build.gradle

@@ -27,6 +27,7 @@ dependencies {
 	implementation project(':kok-core')
 	implementation 'org.springframework.boot:spring-boot-starter-data-redis'
 	implementation 'org.springframework.boot:spring-boot-starter-web'
+	implementation 'org.springframework.boot:spring-boot-starter-validation'
 	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.3'
 
 	compileOnly 'org.projectlombok:lombok'

kok-api/src/main/java/com/kok/kokapi/adapter/in/web/HealthCheckController.java

@@ -1,6 +1,6 @@
 package com.kok.kokapi.adapter.in.web;
 
-import com.kok.kokapi.application.usecase.HealthCheckUseCase;
+import com.kok.kokapi.application.service.HealthCheckService;
 import com.kok.kokapi.common.response.ApiResponseDto;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -10,10 +10,10 @@
 @RequiredArgsConstructor
 public class HealthCheckController extends BaseController {
 
-    private final HealthCheckUseCase healthCheckUseCase;
+    private final HealthCheckService healthCheckService;
 
     @GetMapping("/health")
     public ApiResponseDto<String> checkHealth() {
-        return ApiResponseDto.success(healthCheckUseCase.checkHealth());
+        return ApiResponseDto.success(healthCheckService.checkHealth());
     }
 }

kok-api/src/main/java/com/kok/kokapi/application/service/HealthCheckService.java

@@ -1,12 +1,10 @@
 package com.kok.kokapi.application.service;
 
-import com.kok.kokapi.application.usecase.HealthCheckUseCase;
 import org.springframework.stereotype.Service;
 
 @Service
-public class HealthCheckService implements HealthCheckUseCase {
+public class HealthCheckService {
 
-    @Override
     public String checkHealth() {
         return "OK";
     }

kok-api/src/main/java/com/kok/kokapi/common/exception/GlobalExceptionHandler.java

@@ -2,13 +2,37 @@
 
 import com.kok.kokapi.common.response.ApiResponseDto;
 import com.kok.kokapi.common.error.ErrorCode;
+import jakarta.validation.ConstraintViolationException;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
+import java.util.stream.Collectors;
+
 @RestControllerAdvice
 public class GlobalExceptionHandler {
 
+    @ExceptionHandler(ConstraintViolationException.class)
+    public ResponseEntity<ApiResponseDto<Void>> handleConstraintViolationException(ConstraintViolationException ex) {
+        String message = ex.getConstraintViolations()
+                .stream()
+                .map(cv -> cv.getPropertyPath() + " " + cv.getMessage())
+                .collect(Collectors.joining(", "));
+        return ResponseEntity.badRequest()
+                .body(ApiResponseDto.error(ErrorCode.INVALID_INPUT, message));
+    }
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<ApiResponseDto<Void>> handleMethodArgumentNotValidException(MethodArgumentNotValidException ex) {
+        String message = ex.getBindingResult().getFieldErrors()
+                .stream()
+                .map(fe -> fe.getField() + " " + fe.getDefaultMessage())
+                .collect(Collectors.joining(", "));
+        return ResponseEntity.badRequest()
+                .body(ApiResponseDto.error(ErrorCode.INVALID_INPUT, message));
+    }
+
     @ExceptionHandler(IllegalArgumentException.class)
     public ResponseEntity<ApiResponseDto<Void>> handleBadRequestException(IllegalArgumentException ex) {
         return ResponseEntity.badRequest()

kok-api/src/main/java/com/kok/kokapi/config/redis/RedisConfig.java

@@ -0,0 +1,28 @@
+package com.kok.kokapi.config.redis;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.redis.connection.RedisConnectionFactory;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
+import org.springframework.data.redis.serializer.StringRedisSerializer;
+
+@Configuration
+@RequiredArgsConstructor
+public class RedisConfig {
+
+    // 추후 ConnectionFactory설정 변경을 고려. (Sentinel, Cluster, etc...)
+    @Bean
+    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
+        RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
+        redisTemplate.setConnectionFactory(redisConnectionFactory);
+
+        // Key Serializer 설정 (UUID -> String 변환)
+        redisTemplate.setKeySerializer(new StringRedisSerializer());
+
+        // Value Serializer 설정 (객체 -> JSON 변환)
+        redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());
+        return redisTemplate;
+    }
+}

kok-api/src/main/java/com/kok/kokapi/config/usecase/UseCaseConfig.java

@@ -0,0 +1,15 @@
+package com.kok.kokapi.config.usecase;
+
+import com.kok.kokapi.room.application.service.RoomService;
+import com.kok.kokcore.application.port.out.SaveRoomPort;
+import com.kok.kokcore.usecase.CreateRoomUseCase;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class UseCaseConfig {
+    @Bean
+    public CreateRoomUseCase createRoomUseCase(SaveRoomPort saveRoomPort) {
+        return new RoomService(saveRoomPort);
+    }
+}

kok-api/src/main/java/com/kok/kokapi/room/adapter/in/dto/request/CreateRoomRequest.java

@@ -0,0 +1,20 @@
+package com.kok.kokapi.room.adapter.in.dto.request;
+
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record CreateRoomRequest(
+        @NotBlank(message = "방 이름은 필수 입력값입니다.")
+        @Size(max = 30, message = "방 이름은 최대 30자까지 가능합니다.")
+        String roomName,
+
+        @Min(value = 2, message = "참여 인원 수는 최소 2명 이상이어야 합니다.")
+        Integer capacity,
+
+        String hostProfile,
+
+        @NotBlank(message = "비밀번호는 필수 입력값입니다.")
+        String password
+) {}

kok-api/src/main/java/com/kok/kokapi/room/adapter/in/dto/response/RoomResponse.java

@@ -0,0 +1,21 @@
+package com.kok.kokapi.room.adapter.in.dto.response;
+
+import com.kok.kokcore.domain.Room;
+
+public record RoomResponse(
+        String id,
+        String roomName,
+        int capacity,
+        String hostProfile,
+        String roomLinkUrl
+) {
+    public static RoomResponse from(Room room) {
+        return new RoomResponse(
+                room.getId(),
+                room.getRoomName(),
+                room.getCapacity(),
+                room.getHostProfile(),
+                room.getRoomLinkUrl()
+        );
+    }
+}

kok-api/src/main/java/com/kok/kokapi/room/adapter/in/web/RoomController.java

@@ -0,0 +1,35 @@
+package com.kok.kokapi.room.adapter.in.web;
+
+import com.kok.kokapi.common.response.ApiResponseDto;
+import com.kok.kokapi.room.adapter.in.dto.request.CreateRoomRequest;
+import com.kok.kokapi.room.adapter.in.dto.response.RoomResponse;
+import com.kok.kokcore.domain.Room;
+import com.kok.kokcore.usecase.CreateRoomUseCase;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+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.RestController;
+
+@RestController
+@RequestMapping("/rooms")
+@RequiredArgsConstructor
+public class RoomController {
+
+    private final CreateRoomUseCase createRoomUseCase;
+
+    @PostMapping("/create")
+    public ResponseEntity<ApiResponseDto<RoomResponse>> createRoom(@Valid @RequestBody CreateRoomRequest request) {
+        Room room = createRoomUseCase.createRoom(
+                request.roomName(),
+                request.capacity(),
+                request.hostProfile(),
+                request.password()
+        );
+
+        var response = RoomResponse.from(room);
+        return ResponseEntity.ok(ApiResponseDto.success(response));
+    }
+}

kok-api/src/main/java/com/kok/kokapi/room/adapter/out/persistence/RedisSaveRoomPersistenceAdapter.java

@@ -0,0 +1,31 @@
+package com.kok.kokapi.room.adapter.out.persistence;
+
+import com.kok.kokcore.application.port.out.SaveRoomPort;
+import com.kok.kokcore.domain.Room;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.stereotype.Repository;
+
+import java.time.Duration;
+
+@Repository
+public class RedisSaveRoomPersistenceAdapter implements SaveRoomPort {
+
+    private static final String ROOM_KEY_PREFIX = "room";
+    private static final Duration ROOM_TTL = Duration.ofDays(3);
+    private final RedisTemplate<String, Object> redisTemplate;
+
+    public RedisSaveRoomPersistenceAdapter(RedisTemplate<String, Object> redisTemplate) {
+        this.redisTemplate = redisTemplate;
+    }
+
+    @Override
+    public Room save(Room room) {
+        String key = buildKey(room.getId());
+        redisTemplate.opsForValue().set(key, room, ROOM_TTL);
+        return room;
+    }
+
+    private String buildKey(String roomId) {
+        return ROOM_KEY_PREFIX + ":" + roomId;
+    }
+}

kok-api/src/main/java/com/kok/kokapi/room/application/service/RoomService.java

@@ -0,0 +1,20 @@
+package com.kok.kokapi.room.application.service;
+
+import com.kok.kokcore.application.port.out.SaveRoomPort;
+import com.kok.kokcore.domain.Room;
+import com.kok.kokcore.usecase.CreateRoomUseCase;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class RoomService implements CreateRoomUseCase {
+
+    private final SaveRoomPort saveRoomPort;
+
+    @Override
+    public Room createRoom(String roomName, int capacity, String hostProfile, String password) {
+        Room room = Room.create(roomName, capacity, hostProfile, password);
+        return saveRoomPort.save(room);
+    }
+}

kok-api/src/main/resources/application-prod.yml

@@ -16,6 +16,13 @@ spring:
     redis:
       host: ${REDIS_HOST}
       port: ${REDIS_PORT}
+#      sentinel:
+#        master: ${REDIS_SENTINEL_MASTER}
+#        nodes:
+#          - ${REDIS_SENTINEL_HOST1}:${REDIS_SENTINEL_PORT1}
+#          - ${REDIS_SENTINEL_HOST2}:${REDIS_SENTINEL_PORT2}
+#          - ${REDIS_SENTINEL_HOST3}:${REDIS_SENTINEL_PORT3}
+
 springdoc:
   default-consumes-media-type: application/json;charset=UTF-8
   default-produces-media-type: application/json;charset=UTF-8

kok-core/build.gradle

@@ -19,6 +19,8 @@ repositories {
 
 dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter'
+	implementation 'org.springframework.boot:spring-boot-starter-data-redis'
+	implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.18.2'
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 }

kok-core/src/main/java/com/kok/kokcore/application/port/out/SaveRoomPort.java

@@ -0,0 +1,7 @@
+package com.kok.kokcore.application.port.out;
+
+import com.kok.kokcore.domain.Room;
+
+public interface SaveRoomPort {
+    Room save(Room room);
+}

kok-core/src/main/java/com/kok/kokcore/domain/Room.java

@@ -0,0 +1,49 @@
+package com.kok.kokcore.domain;
+
+import lombok.*;
+
+import java.io.Serializable;
+import java.util.UUID;
+
+@Getter
+@ToString
+@EqualsAndHashCode
+public class Room implements Serializable {
+
+    public static final int REQUIRED_CAPACITY = 2;
+    public static final String ROOM_LINK_URL = "kakao://app/room?roomId=";
+
+    private final String id;               // 약속방 ID (UUID)
+    private final String roomName;         // 약속방 이름
+    private final int capacity;            // 참여인원 수 (최소 2명 이상)
+    private final String hostProfile;      // 방장 프로필 정보
+    private final String password;         // 방 비밀번호 (옵션)
+    private final String roomLinkUrl;      // 생성된 약속방 입장 링크
+
+    public Room(String id, String roomName, int capacity, String hostProfile,
+                String password, String roomLinkUrl) {
+        this.id = id;
+        this.roomName = roomName;
+        this.capacity = capacity;
+        this.hostProfile = hostProfile;
+        this.password = password;
+        this.roomLinkUrl = roomLinkUrl;
+    }
+
+    public static Room create(String roomName, int capacity, String hostProfile, String password) {
+        if (roomName == null || roomName.trim().isEmpty()) {
+            throw new IllegalArgumentException("Room name is required");
+        }
+        if (capacity < REQUIRED_CAPACITY) {
+            throw new IllegalArgumentException("At least 2 participants are required");
+        }
+        if (hostProfile == null || hostProfile.trim().isEmpty()) {
+            throw new IllegalArgumentException("Host profile is required");
+        }
+
+        String roomId = UUID.randomUUID().toString();
+        String roomLinkUrl = ROOM_LINK_URL + roomId;
+
+        return new Room(roomId, roomName, capacity, hostProfile, password, roomLinkUrl);
+    }
+}

kok-core/src/main/java/com/kok/kokcore/usecase/CreateRoomUseCase.java

@@ -0,0 +1,7 @@
+package com.kok.kokcore.usecase;
+
+import com.kok.kokcore.domain.Room;
+
+public interface CreateRoomUseCase {
+    Room createRoom(String roomName, int capacity, String hostProfile, String password);
+}