feat: 실시간 협업 다중 세션 기능 구현(#34)

Author: 1anminJ

src/main/java/com/dmu/debug_visual/collab/domain/entity/CodeSession.java

@@ -0,0 +1,35 @@
+package com.dmu.debug_visual.collab.domain.entity;
+
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import java.util.UUID;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class CodeSession {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, unique = true)
+    private String sessionId; // 웹소켓 통신 등에 사용할 고유 ID
+
+    @Column(nullable = false)
+    private String sessionName; // 사용자에게 보여질 세션 이름 (예: "main.java", "알고리즘 문제풀이")
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "room_id", nullable = false)
+    private Room room; // 이 세션이 속한 방
+
+    @Builder
+    public CodeSession(String sessionName, Room room) {
+        this.sessionId = UUID.randomUUID().toString();
+        this.sessionName = sessionName;
+        this.room = room;
+    }
+}

src/main/java/com/dmu/debug_visual/collab/domain/entity/Room.java

@@ -0,0 +1,48 @@
+package com.dmu.debug_visual.collab.domain.entity;
+
+import com.dmu.debug_visual.user.User;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Table(name = "collab_room") // DB 테이블 이름을 명확히 지정
+public class Room {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, unique = true)
+    private String roomId; // 기존 DTO의 roomId와 동일한 역할 (외부용 ID)
+
+    @Column(nullable = false)
+    private String name; // 방 이름 (예: "알고리즘 스터디")
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "owner_id", nullable = false)
+    private User owner; // 방을 생성한 방장
+
+    // 1:N 관계 - 이 방에 속한 코드 세션 목록
+    @OneToMany(mappedBy = "room", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<CodeSession> codeSessions = new ArrayList<>();
+
+    // 1:N 관계 - 이 방에 참여한 참여자 목록
+    @OneToMany(mappedBy = "room", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<RoomParticipant> participants = new ArrayList<>();
+
+    @Builder
+    public Room(String name, User owner) {
+        this.roomId = UUID.randomUUID().toString();
+        this.name = name;
+        this.owner = owner;
+    }
+}

src/main/java/com/dmu/debug_visual/collab/domain/entity/RoomParticipant.java

@@ -0,0 +1,42 @@
+package com.dmu.debug_visual.collab.domain.entity;
+
+import com.dmu.debug_visual.user.User;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class RoomParticipant {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "room_id", nullable = false)
+    private Room room;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User user;
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false)
+    private Permission permission;
+
+    public enum Permission {
+        READ_ONLY,
+        READ_WRITE
+    }
+
+    @Builder
+    public RoomParticipant(Room room, User user, Permission permission) {
+        this.room = room;
+        this.user = user;
+        this.permission = permission;
+    }
+}

src/main/java/com/dmu/debug_visual/collab/domain/repository/CodeSessionRepository.java

@@ -0,0 +1,7 @@
+package com.dmu.debug_visual.collab.domain.repository;
+
+import com.dmu.debug_visual.collab.domain.entity.CodeSession;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface CodeSessionRepository extends JpaRepository<CodeSession, Long> {
+}

src/main/java/com/dmu/debug_visual/collab/domain/repository/RoomParticipantRepository.java

@@ -0,0 +1,11 @@
+package com.dmu.debug_visual.collab.domain.repository;
+
+import com.dmu.debug_visual.collab.domain.entity.Room;
+import com.dmu.debug_visual.collab.domain.entity.RoomParticipant;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Optional;
+
+public interface RoomParticipantRepository extends JpaRepository<RoomParticipant, Long> {
+    Optional<RoomParticipant> findByRoomAndUser_UserId(Room room, String userId);
+}

src/main/java/com/dmu/debug_visual/collab/domain/repository/RoomRepository.java

@@ -0,0 +1,11 @@
+package com.dmu.debug_visual.collab.domain.repository;
+
+import com.dmu.debug_visual.collab.domain.entity.Room;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Optional;
+
+public interface RoomRepository extends JpaRepository<Room, Long> {
+    // roomId (String)를 이용해 Room 엔티티를 조회하는 메소드
+    Optional<Room> findByRoomId(String roomId);
+}

src/main/java/com/dmu/debug_visual/collab/rest/RoomController.java

@@ -0,0 +1,65 @@
+package com.dmu.debug_visual.collab.rest;
+
+import com.dmu.debug_visual.security.CustomUserDetails;
+import com.dmu.debug_visual.collab.rest.dto.CreateRoomRequest;
+import com.dmu.debug_visual.collab.rest.dto.CreateSessionRequest;
+import com.dmu.debug_visual.collab.rest.dto.RoomResponse;
+import com.dmu.debug_visual.collab.rest.dto.SessionResponse;
+import com.dmu.debug_visual.collab.service.RoomService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+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.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+@Tag(name = "협업 방 및 세션 관리 API", description = "실시간 협업을 위한 방과 코드 세션을 생성하고 관리합니다.")
+@RestController
+@RequestMapping("/api/collab-rooms")
+@RequiredArgsConstructor
+public class RoomController {
+
+    private final RoomService roomService; // DB 관련 서비스
+
+    @Operation(summary = "새로운 협업 방 생성", description = "DB에 새로운 협업 방을 생성하고, 방장(owner)을 첫 참여자로 자동 등록합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "방 생성 성공",
+                    content = @Content(mediaType = "application/json", schema = @Schema(implementation = RoomResponse.class))),
+            @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content)
+    })
+    @PostMapping
+    public ResponseEntity<RoomResponse> createRoom(
+            @RequestBody CreateRoomRequest request,
+            @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        String ownerUserId = userDetails.getUsername();
+        RoomResponse response = roomService.createRoom(request, ownerUserId);
+        return ResponseEntity.ok(response);
+    }
+
+    @Operation(summary = "방 안에 새 코드 세션 생성", description = "기존에 생성된 협업 방 안에 독립적인 새 코드 편집 세션을 생성합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "세션 생성 성공",
+                    content = @Content(mediaType = "application/json", schema = @Schema(implementation = SessionResponse.class))),
+            @ApiResponse(responseCode = "401", description = "인증 실패", content = @Content),
+            @ApiResponse(responseCode = "403", description = "해당 방의 참여자가 아님", content = @Content),
+            @ApiResponse(responseCode = "404", description = "존재하지 않는 방", content = @Content)
+    })
+    @PostMapping("/{roomId}/sessions")
+    public ResponseEntity<SessionResponse> createSession(
+            @Parameter(description = "세션을 생성할 방의 고유 ID (UUID)", required = true)
+            @PathVariable String roomId,
+
+            @RequestBody CreateSessionRequest request,
+            @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        String creatorUserId = userDetails.getUsername();
+        SessionResponse response = roomService.createCodeSessionInRoom(roomId, request, creatorUserId);
+        return ResponseEntity.ok(response);
+    }
+}

src/main/java/com/dmu/debug_visual/collab/rest/dto/CreateRoomRequest.java

@@ -0,0 +1,11 @@
+package com.dmu.debug_visual.collab.rest.dto;
+
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+// 방 생성 요청 시 받을 데이터
+@Getter
+@NoArgsConstructor
+public class CreateRoomRequest {
+    private String roomName;
+}

src/main/java/com/dmu/debug_visual/collab/rest/dto/CreateSessionRequest.java

@@ -0,0 +1,11 @@
+package com.dmu.debug_visual.collab.rest.dto;
+
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class CreateSessionRequest {
+    // 사용자가 입력할 세션의 이름 (예: "main.java", "Test Case 1")
+    private String sessionName;
+}

…bsocket/dto/PermissionChangeMessage.java …ab/rest/dto/PermissionChangeMessage.javasrc/main/java/com/dmu/debug_visual/websocket/dto/PermissionChangeMessage.java renamed to src/main/java/com/dmu/debug_visual/collab/rest/dto/PermissionChangeMessage.java src/main/java/com/dmu/debug_visual/websocket/dto/PermissionChangeMessage.java renamed to src/main/java/com/dmu/debug_visual/collab/rest/dto/PermissionChangeMessage.java

@@ -1,4 +1,4 @@
-package com.dmu.debug_visual.websocket.dto;
+package com.dmu.debug_visual.collab.rest.dto;
 
 import lombok.Getter;
 import lombok.Setter;