Fix: 인프라 환경설정에 맞춰 파일업로드 매핑 수정 (#279) (#284)

loseminho · namgigun · web-flow · commit 8f50a7ee5afc · 2025-10-14T16:59:31.000+09:00
* refactor: 스더티룸 권한에 대한 로직 개선

* fix: ci에서 통과 못한 테스트코드 수정

* fix:rest api와 웹소켓 중간 경로 통합

* fix:rest api와 웹소켓 중간 경로 통합

* fix: 에러 확인을 위한 통합테스트 추가, Room.create()메서드 수정

* refactor, feat
: 조회 분할

* refactor: redis 로직 최적화 및 중복 검증 로직 제거

* fix: 에러 번호 수정

* feat: 스터디룸 방 비밀번호 변경 및 삭제 기능 구현

* fix:app-dev 제거

* feat: 웹소켓 기반 소극적 하트비트

* feat: 스터디룸 썸네일 기능 추가 및 webrtc 설정 변경에서 주석처리

* fix:소극적 하트비트 사용 주석처리

* Feat: 스터디 룸 내에 고양이 아바타 시스템과 프로필 이미지 url 연동

* fix: 기존 작성되어있던 test 코드 수정

* test: 아바타 테스트 코드 완료

* refactor: 프론트엔드 요청 사항에 따른 스터디룸 조회 마스킹 제거

* feat: 스터디룸 방 초대 코드 시스템

* Infra: main branch 로컬 환경과 운영 환경 동기화

* Infra: docker-compose 파일 수정

- Redis 버전 업그레이드
기존: 6.2 -&gt; 변경: 7.0

* Fix: 백엔드 CD 파일 수정

- 자동화 시, 잘못된 도메인으로 호스트 ID 검증하는 오류 해결

* Infra: EC2 환경변수 수정

- 잘못 표기한 도메인 네임 변경

* Chore: CD 파일 수정

- Github Actions commandLine 인식 문제로 인해 set -Eeuo pipefail 줄바꿈

* Chore: 백엔드 CD 파일 수정

- 인스턴스 ID 체크 삭제

* Infra: 백엔드 CD 파일 수정

- .env 파일 추가시, $DOT_ENV_PROD -&gt; $DOT_ENV 로 변경

* Infra: 도커 컴포즈 수정

- mysql 사용자 정보 변경

* Infra: 운영환경 설정

- application-prod.yml 과 application.yml 동기화

* Fix: SecurityConfig 수정

- H2 DB 허용 X

* test,fix: 방 초대에 대한 테스트 코드 작성 및 에러 수정

* fix: 스터디룸 파일 업로드 맵핑 형식으로 변환

* fix: 병합충돌 제어 수정

* fix: 병합충돌 제어

---------

Co-authored-by: namgigun &lt;namgigun@gmail.com&gt;
diff --git a/src/main/java/com/back/domain/studyroom/controller/RoomController.java b/src/main/java/com/back/domain/studyroom/controller/RoomController.java
@@ -65,7 +65,7 @@ public ResponseEntity<RsData<RoomResponse>> createRoom(
                 request.getMaxParticipants() != null ? request.getMaxParticipants() : 10,
                 currentUserId,
                 request.getUseWebRTC() != null ? request.getUseWebRTC() : true,  // 디폴트: true
-                request.getThumbnailUrl()  // 썸네일 URL
+                request.getThumbnailAttachmentId()  // 썸네일 Attachment ID
         );
         
         RoomResponse response = roomService.toRoomResponse(room);
@@ -336,7 +336,7 @@ public ResponseEntity<RsData<List<MyRoomResponse>>> getMyRooms() {
     @PutMapping("/{roomId}")
     @Operation(
         summary = "방 설정 수정", 
-        description = "방의 제목, 설명, 정원, 썸네일을 수정합니다. 방장만 수정 가능합니다. WebRTC 설정은 현재 수정 불가합니다."
+        description = "방의 제목, 설명, 정원, 썸네일을 수정합니다.thumbnailAttachmentId가 null이면 썸네일 변경 없이 기존 유지됩니다. 방장만 수정 가능합니다. WebRTC 설정은 현재 수정 불가합니다."
     )
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "수정 성공"),
@@ -356,7 +356,7 @@ public ResponseEntity<RsData<Void>> updateRoom(
                 request.getTitle(),
                 request.getDescription(),
                 request.getMaxParticipants(),
-                request.getThumbnailUrl(),
+                request.getThumbnailAttachmentId(),  // 썸네일 Attachment ID
                 currentUserId
         );
 
diff --git a/src/main/java/com/back/domain/studyroom/dto/CreateRoomRequest.java b/src/main/java/com/back/domain/studyroom/dto/CreateRoomRequest.java
@@ -16,9 +16,12 @@ public class CreateRoomRequest {
     @Size(max = 500, message = "방 설명은 500자를 초과할 수 없습니다")
     private String description;
     
-    // 방 썸네일 이미지 URL (선택)
-    @Size(max = 500, message = "썸네일 URL은 500자를 초과할 수 없습니다")
-    private String thumbnailUrl;
+    // 방 썸네일 FileAttachment ID (선택)
+    // 사용 방법:
+    // 1. POST /api/files/upload로 파일 업로드
+    // 2. 받은 fileId를 여기에 설정
+    // 3. 방 생성 시 AttachmentMapping 자동 생성
+    private Long thumbnailAttachmentId;
     
     private Boolean isPrivate = false;
     
diff --git a/src/main/java/com/back/domain/studyroom/dto/UpdateRoomSettingsRequest.java b/src/main/java/com/back/domain/studyroom/dto/UpdateRoomSettingsRequest.java
@@ -20,9 +20,13 @@ public class UpdateRoomSettingsRequest {
     @Max(value = 100, message = "최대 100명까지 가능합니다")
     private Integer maxParticipants;
     
-    // 방 썸네일 이미지 URL (선택)
-    @Size(max = 500, message = "썸네일 URL은 500자를 초과할 수 없습니다")
-    private String thumbnailUrl;
+    // 방 썸네일 FileAttachment ID (선택)
+    // 사용 방법:
+    // 1. POST /api/files/upload로 새 파일 업로드
+    // 2. 받은 fileId를 여기에 설정
+    // 3. 방 수정 시 기존 매핑 삭제 + 새 매핑 생성
+    // null인 경우: 썸네일 변경 없음 (기존 유지)
+    private Long thumbnailAttachmentId;
     
     // ===== WebRTC 설정 (추후 팀원 구현 시 주석 해제) =====
     // WebRTC 기능은 방 생성 이후 별도 API로 관리 예정
diff --git a/src/main/java/com/back/domain/studyroom/service/RoomService.java b/src/main/java/com/back/domain/studyroom/service/RoomService.java
@@ -52,6 +52,7 @@ public class RoomService {
     private final SimpMessagingTemplate messagingTemplate;
     private final ApplicationEventPublisher eventPublisher;
     private final AvatarService avatarService;
+    private final RoomThumbnailService roomThumbnailService;
 
     /**
      * 방 생성 메서드
@@ -68,21 +69,32 @@ public class RoomService {
      */
     @Transactional
     public Room createRoom(String title, String description, boolean isPrivate, 
-                          String password, int maxParticipants, Long creatorId, boolean useWebRTC, String thumbnailUrl) {
+                          String password, int maxParticipants, Long creatorId, boolean useWebRTC, Long thumbnailAttachmentId) {
         
         User creator = userRepository.findById(creatorId)
                 .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
 
-        Room room = Room.create(title, description, isPrivate, password, maxParticipants, creator, null, useWebRTC, thumbnailUrl);
+        // 방 생성 (썸네일 URL은 null로 시작)
+        Room room = Room.create(title, description, isPrivate, password, 
+                maxParticipants, creator, null, useWebRTC, null);
         Room savedRoom = roomRepository.save(room);
 
+        // 썸네일 매핑 생성 및 URL 업데이트
+        if (thumbnailAttachmentId != null) {
+            String thumbnailUrl = roomThumbnailService.createThumbnailMapping(
+                    savedRoom.getId(), thumbnailAttachmentId);
+            savedRoom.updateSettings(title, description, maxParticipants, thumbnailUrl);
+        }
+
+        // 방장 등록
         RoomMember hostMember = RoomMember.createHost(savedRoom, creator);
         roomMemberRepository.save(hostMember);
 
         // savedRoom.incrementParticipant();  // Redis로 이관 - DB 업데이트 제거
         
-        log.info("방 생성 완료 - RoomId: {}, Title: {}, CreatorId: {}, WebRTC: {}, Thumbnail: {}", 
-                savedRoom.getId(), title, creatorId, useWebRTC, thumbnailUrl != null ? "설정됨" : "없음");
+        log.info("방 생성 완료 - RoomId: {}, Title: {}, CreatorId: {}, WebRTC: {}, ThumbnailId: {}", 
+                savedRoom.getId(), title, creatorId, useWebRTC, 
+                thumbnailAttachmentId != null ? thumbnailAttachmentId : "없음");
         
         return savedRoom;
     }
@@ -257,9 +269,6 @@ public Room getRoomDetail(Long roomId, Long userId) {
         Room room = roomRepository.findById(roomId)
                 .orElseThrow(() -> new CustomException(ErrorCode.ROOM_NOT_FOUND));
 
-        // ⭐ 비공개 방 접근 제한 제거 - 모든 사용자가 조회 가능
-        // (프론트엔드에서 입장 시 로그인 체크)
-
         return room;
     }
 
@@ -269,7 +278,7 @@ public List<Room> getUserRooms(Long userId) {
 
     @Transactional
     public void updateRoomSettings(Long roomId, String title, String description, 
-                                  int maxParticipants, String thumbnailUrl, Long userId) {
+                                  int maxParticipants, Long thumbnailAttachmentId, Long userId) {
         
         Room room = roomRepository.findById(roomId)
                 .orElseThrow(() -> new CustomException(ErrorCode.ROOM_NOT_FOUND));
@@ -285,10 +294,18 @@ public void updateRoomSettings(Long roomId, String title, String description,
             throw new CustomException(ErrorCode.BAD_REQUEST);
         }
 
+        // 썸네일 변경 처리
+        String thumbnailUrl = room.getRawThumbnailUrl();  // 기존 URL 유지
+        if (thumbnailAttachmentId != null) {
+            // 기존 매핑 삭제 + 새 매핑 생성
+            thumbnailUrl = roomThumbnailService.updateThumbnailMapping(
+                    roomId, thumbnailAttachmentId);
+        }
+
         room.updateSettings(title, description, maxParticipants, thumbnailUrl);
         
-        log.info("방 설정 변경 완료 - RoomId: {}, UserId: {}, Thumbnail: {}", 
-                roomId, userId, thumbnailUrl != null ? "변경됨" : "없음");
+        log.info("방 설정 변경 완료 - RoomId: {}, UserId: {}, ThumbnailId: {}", 
+                roomId, userId, thumbnailAttachmentId != null ? thumbnailAttachmentId : "변경 없음");
     }
 
     /**
@@ -353,6 +370,9 @@ public void terminateRoom(Long roomId, Long userId) {
             throw new CustomException(ErrorCode.NOT_ROOM_MANAGER);
         }
 
+        // 썸네일 매핑 삭제
+        roomThumbnailService.deleteThumbnailMapping(roomId);
+
         room.terminate();
         
         // Redis에서 모든 온라인 사용자 제거
@@ -530,8 +550,6 @@ public List<RoomMember> getRoomMembers(Long roomId, Long userId) {
         Room room = roomRepository.findById(roomId)
                 .orElseThrow(() -> new CustomException(ErrorCode.ROOM_NOT_FOUND));
 
-        // ⭐ 비공개 방 접근 제한 제거 - 모든 사용자가 조회 가능
-
         // 1. Redis에서 온라인 사용자 ID 조회
         Set<Long> onlineUserIds = roomParticipantService.getParticipants(roomId);
         
diff --git a/src/main/java/com/back/domain/studyroom/service/RoomThumbnailService.java b/src/main/java/com/back/domain/studyroom/service/RoomThumbnailService.java
@@ -0,0 +1,138 @@
+package com.back.domain.studyroom.service;
+
+import com.back.domain.file.entity.AttachmentMapping;
+import com.back.domain.file.entity.EntityType;
+import com.back.domain.file.entity.FileAttachment;
+import com.back.domain.file.repository.AttachmentMappingRepository;
+import com.back.domain.file.repository.FileAttachmentRepository;
+import com.back.global.exception.CustomException;
+import com.back.global.exception.ErrorCode;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+/**
+ * 스터디룸 썸네일 전용 서비스
+ * 매핑 전략에 따라 AttachmentMapping을 통해 관리
+ */
+@Service
+@RequiredArgsConstructor
+@Slf4j
+public class RoomThumbnailService {
+
+    private final FileAttachmentRepository fileAttachmentRepository;
+    private final AttachmentMappingRepository attachmentMappingRepository;
+
+    /**
+     * 방 생성 시 썸네일 매핑 생성
+     * 
+     * @param roomId 방 ID
+     * @param thumbnailAttachmentId 썸네일 파일 ID
+     * @return 썸네일 URL
+     */
+    @Transactional
+    public String createThumbnailMapping(Long roomId, Long thumbnailAttachmentId) {
+        if (thumbnailAttachmentId == null) {
+            return null;
+        }
+
+        // FileAttachment 조회
+        FileAttachment fileAttachment = fileAttachmentRepository.findById(thumbnailAttachmentId)
+                .orElseThrow(() -> new CustomException(ErrorCode.FILE_NOT_FOUND));
+
+        // AttachmentMapping 생성
+        AttachmentMapping mapping = new AttachmentMapping(
+                fileAttachment,
+                EntityType.STUDY_ROOM,
+                roomId
+        );
+        
+        attachmentMappingRepository.save(mapping);
+        
+        log.info("썸네일 매핑 생성 - RoomId: {}, AttachmentId: {}, URL: {}", 
+                roomId, thumbnailAttachmentId, fileAttachment.getPublicURL());
+        
+        return fileAttachment.getPublicURL();
+    }
+
+    /**
+     * 방 수정 시 썸네일 변경
+     * 1. 기존 매핑 삭제
+     * 2. 새 매핑 생성
+     * 
+     * @param roomId 방 ID
+     * @param newThumbnailAttachmentId 새 썸네일 파일 ID (null이면 변경 없음)
+     * @return 새 썸네일 URL (null이면 변경 없음)
+     */
+    @Transactional
+    public String updateThumbnailMapping(Long roomId, Long newThumbnailAttachmentId) {
+        if (newThumbnailAttachmentId == null) {
+            // null이면 썸네일 변경 없음
+            return null;
+        }
+
+        // 기존 매핑 모두 삭제
+        attachmentMappingRepository.deleteAllByEntityTypeAndEntityId(
+                EntityType.STUDY_ROOM, roomId);
+        
+        log.info("기존 썸네일 매핑 삭제 - RoomId: {}", roomId);
+
+        // 새 매핑 생성
+        return createThumbnailMapping(roomId, newThumbnailAttachmentId);
+    }
+
+    /**
+     * 방 삭제 시 썸네일 매핑 삭제
+     * 
+     * @param roomId 방 ID
+     */
+    @Transactional
+    public void deleteThumbnailMapping(Long roomId) {
+        // 연결된 파일 매핑 모두 삭제
+        attachmentMappingRepository.deleteAllByEntityTypeAndEntityId(
+                EntityType.STUDY_ROOM, roomId);
+        
+        log.info("방 삭제 - 썸네일 매핑 삭제 완료 - RoomId: {}", roomId);
+    }
+
+    /**
+     * 방의 썸네일 URL 조회
+     * 
+     * @param roomId 방 ID
+     * @return 썸네일 URL (없으면 null)
+     */
+    @Transactional(readOnly = true)
+    public String getThumbnailUrl(Long roomId) {
+        List<AttachmentMapping> mappings = attachmentMappingRepository
+                .findAllByEntityTypeAndEntityId(EntityType.STUDY_ROOM, roomId);
+        
+        if (mappings.isEmpty()) {
+            return null;
+        }
+        
+        // 첫 번째 매핑의 URL 반환 (썸네일은 단일 파일)
+        return mappings.get(0).getFileAttachment().getPublicURL();
+    }
+
+    /**
+     * 방의 썸네일 FileAttachment 조회
+     * 
+     * @param roomId 방 ID
+     * @return FileAttachment (없으면 null)
+     */
+    @Transactional(readOnly = true)
+    public FileAttachment getThumbnailAttachment(Long roomId) {
+        List<AttachmentMapping> mappings = attachmentMappingRepository
+                .findAllByEntityTypeAndEntityId(EntityType.STUDY_ROOM, roomId);
+        
+        if (mappings.isEmpty()) {
+            return null;
+        }
+        
+        // 첫 번째 매핑의 FileAttachment 반환 (썸네일은 단일 파일)
+        return mappings.get(0).getFileAttachment();
+    }
+}
diff --git a/src/main/resources/application-prod.yml b/src/main/resources/application-prod.yml
@@ -73,7 +73,6 @@ spring:
             token-uri: https://github.com/login/oauth/access_token
             user-info-uri: https://api.github.com/user
             user-name-attribute: id
-
   servlet:
     multipart:
       max-file-size: 10MB # 업로드할 수 있는 개별 파일의 최대 크기
diff --git a/src/test/java/com/back/domain/studyroom/controller/RoomControllerTest.java b/src/test/java/com/back/domain/studyroom/controller/RoomControllerTest.java
diff --git a/src/test/java/com/back/domain/studyroom/service/RoomServiceTest.java b/src/test/java/com/back/domain/studyroom/service/RoomServiceTest.java
