Refactor: 아바타 시스템 DB와 완전 분리 (#302) (#304)

* 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 -> 변경: 7.0

* Fix: 백엔드 CD 파일 수정

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

* Infra: EC2 환경변수 수정

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

* Chore: CD 파일 수정

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

* Chore: 백엔드 CD 파일 수정

- 인스턴스 ID 체크 삭제

* Infra: 백엔드 CD 파일 수정

- .env 파일 추가시, $DOT_ENV_PROD -> $DOT_ENV 로 변경

* Infra: 도커 컴포즈 수정

- mysql 사용자 정보 변경

* Infra: 운영환경 설정

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

* Fix: SecurityConfig 수정

- H2 DB 허용 X

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

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

* fix: 병합충돌 제어 수정

* fix: 병합충돌 제어

* fix: 스터디 룸 내 프론트엔드 요구 사항 및 오류사항 수정

* feat: 방 즐겨찾기, 방 공지사항 구현

* fix: mockbean 수정

* fix: 테스트에서 빠진 비로그인 사용자 추가

* hotfix: 누락된 사용자 추방에 대한 컨트롤러 추가

* hotfix: VISITOR도 추방 가능하도록 수정

* fix: 누락된 테스트코드 추가 및 테스트코드 로직 수정

* refactor: 아바타 시스템 db와 분리 및 테스트 코드 수정

* fix: 턴서버 dev에 맞춤

---------

Co-authored-by: namgigun <[email protected]>

Author: loseminho

src/main/java/com/back/domain/studyroom/controller/RoomAvatarController.java

@@ -1,6 +1,5 @@
 package com.back.domain.studyroom.controller;
 
-import com.back.domain.studyroom.dto.AvatarResponse;
 import com.back.domain.studyroom.dto.UpdateAvatarRequest;
 import com.back.domain.studyroom.service.AvatarService;
 import com.back.global.common.dto.RsData;
@@ -13,16 +12,14 @@
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
-import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
-import java.util.List;
-
 /**
  * 방 아바타 관리 API 컨트롤러
  * - JWT 인증 필수
- * - MEMBER 등급 이상만 아바타 변경 가능
+ * - 아바타는 숫자(ID)로만 관리
+ * - 프론트엔드에서 숫자에 맞는 이미지 매핑
  */
 @RestController
 @RequestMapping("/api/rooms/{roomId}/avatars")
@@ -34,42 +31,19 @@ public class RoomAvatarController {
     private final AvatarService avatarService;
     private final CurrentUser currentUser;
 
-    /**
-     * 사용 가능한 아바타 목록 조회
-     */
-    @GetMapping
-    @Operation(
-        summary = "아바타 목록 조회", 
-        description = "선택 가능한 아바타 목록을 조회합니다. 고양이, 강아지 등 다양한 아바타를 제공합니다."
-    )
-    @ApiResponses({
-        @ApiResponse(responseCode = "200", description = "조회 성공"),
-        @ApiResponse(responseCode = "401", description = "인증 실패")
-    })
-    public ResponseEntity<RsData<List<AvatarResponse>>> getAvatars(
-            @Parameter(description = "방 ID", required = true) @PathVariable Long roomId) {
-        
-        List<AvatarResponse> avatars = avatarService.getAvailableAvatars();
-        
-        return ResponseEntity.ok(
-            RsData.success("아바타 목록 조회 완료", avatars)
-        );
-    }
-    
     /**
      * 내 아바타 변경 (모든 사용자 가능)
      */
     @PutMapping("/me")
     @Operation(
         summary = "아바타 변경", 
         description = "방에서 사용할 아바타를 변경합니다.\n\n" +
-                      "- VISITOR: Redis에만 저장 (퇴장 시 삭제, 재입장 시 랜덤 배정)\n" +
-                      "- MEMBER 이상: DB에 저장 (재입장 시에도 유지)"
+                      "- 프론트에서 원하는 숫자(avatarId)를 전송하면 그대로 저장됩니다.\n" +
+                      "- DB 검증 없이 Redis에만 저장됩니다.\n" +
+                      "- 모든 사용자(VISITOR 포함) 변경 가능합니다."
     )
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "변경 성공"),
-        @ApiResponse(responseCode = "400", description = "잘못된 아바타 ID"),
-        @ApiResponse(responseCode = "404", description = "존재하지 않는 방 또는 아바타"),
         @ApiResponse(responseCode = "401", description = "인증 실패")
     })
     public ResponseEntity<RsData<Void>> updateMyAvatar(

src/main/java/com/back/domain/studyroom/controller/RoomController.java

@@ -77,7 +77,7 @@ public ResponseEntity<RsData<RoomResponse>> createRoom(
     @PostMapping("/{roomId}/join")
     @Operation(
         summary = "방 입장", 
-        description = "특정 스터디 룸에 입장합니다. 공개방은 바로 입장 가능하며, 비공개방은 비밀번호가 필요합니다."
+        description = "특정 스터디 룸에 입장합니다. 공개방은 바로 입장 가능하며, 비공개방은 비밀번호가 필요합니다. 입장 시 랜덤 아바타(1~3)가 배정됩니다."
     )
     @ApiResponses({
         @ApiResponse(responseCode = "200", description = "방 입장 성공"),
@@ -96,8 +96,11 @@ public ResponseEntity<RsData<JoinRoomResponse>> joinRoom(
             password = request.getPassword();
         }
 
-        RoomMember member = roomService.joinRoom(roomId, password, currentUserId);
-        JoinRoomResponse response = JoinRoomResponse.from(member);
+        // 방 입장 + 아바타 ID 반환
+        com.back.domain.studyroom.dto.JoinRoomWithAvatarResult result = 
+                roomService.joinRoomWithAvatar(roomId, password, currentUserId);
+        
+        JoinRoomResponse response = JoinRoomResponse.of(result.getMember(), result.getAvatarId());
 
         return ResponseEntity
                 .status(HttpStatus.OK)

src/main/java/com/back/domain/studyroom/controller/RoomInvitePublicController.java

@@ -31,6 +31,7 @@ public class RoomInvitePublicController {
     private final RoomInviteService inviteService;
     private final RoomService roomService;
     private final CurrentUser currentUser;
+    private final com.back.domain.studyroom.service.AvatarService avatarService;
 
     @PostMapping("/{inviteCode}")
     @SecurityRequirement(name = "Bearer Authentication")
@@ -59,7 +60,11 @@ public ResponseEntity<RsData<JoinRoomResponse>> joinByInviteCode(
 
         // 방 입장 권한 체크 (비밀번호 무시, Redis 등록 건너뜀)
         RoomMember member = roomService.joinRoom(room.getId(), null, userId, false);
-        JoinRoomResponse response = JoinRoomResponse.from(member);
+        
+        // 랜덤 아바타 ID 생성
+        Long avatarId = avatarService.assignRandomAvatar();
+        
+        JoinRoomResponse response = JoinRoomResponse.of(member, avatarId);
 
         return ResponseEntity
                 .status(HttpStatus.OK)

src/main/java/com/back/domain/studyroom/dto/AvatarResponse.java

@@ -13,13 +13,15 @@ public class JoinRoomResponse {
     private Long roomId;
     private Long userId;
     private RoomRole role;
+    private Long avatarId;  // 부여받은 아바타 ID (숫자만)
     private LocalDateTime joinedAt;
 
-    public static JoinRoomResponse from(RoomMember member) {
+    public static JoinRoomResponse of(RoomMember member, Long avatarId) {
         return JoinRoomResponse.builder()
                 .roomId(member.getRoom().getId())
                 .userId(member.getUser().getId())
                 .role(member.getRole())
+                .avatarId(avatarId)
                 .joinedAt(member.getJoinedAt())
                 .build();
     }

src/main/java/com/back/domain/studyroom/dto/JoinRoomResponse.java

@@ -0,0 +1,16 @@
+package com.back.domain.studyroom.dto;
+
+import com.back.domain.studyroom.entity.RoomMember;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 방 입장 결과 + 아바타 ID
+ * 내부 전달용 DTO
+ */
+@Getter
+@AllArgsConstructor
+public class JoinRoomWithAvatarResult {
+    private RoomMember member;
+    private Long avatarId;
+}

src/main/java/com/back/domain/studyroom/dto/JoinRoomWithAvatarResult.java

@@ -13,8 +13,7 @@ public class RoomMemberResponse {
     private Long userId;
     private String nickname;
     private String profileImageUrl;
-    private Long avatarId;
-    private String avatarImageUrl;
+    private Long avatarId;  // 아바타 ID (숫자만, 프론트에서 매핑)
     private RoomRole role;
     private LocalDateTime joinedAt;
     private LocalDateTime promotedAt;
@@ -36,15 +35,14 @@ public static RoomMemberResponse from(RoomMember member) {
     }
 
     /**
-     * 아바타 정보를 포함된 내용으로 생성
+     * 아바타 ID 포함하여 생성
      */
-    public static RoomMemberResponse of(RoomMember member, Long avatarId, String avatarImageUrl) {
+    public static RoomMemberResponse of(RoomMember member, Long avatarId) {
         return RoomMemberResponse.builder()
                 .userId(member.getUser().getId())
                 .nickname(member.getUser().getNickname())
                 .profileImageUrl(member.getUser().getProfileImageUrl())
                 .avatarId(avatarId)
-                .avatarImageUrl(avatarImageUrl)
                 .role(member.getRole())
                 .joinedAt(member.getJoinedAt())
                 .promotedAt(member.getPromotedAt())