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

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/JoinRoomResponse.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/JoinRoomWithAvatarResult.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/RoomMemberResponse.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())