feat(live-room): 채팅창 얼리기 기능을 추가한다

채팅 입력 제어와 룸 상태 동기화를 통합해 지연 입장자도 동일 상태를 적용한다.

app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt

@@ -10,6 +10,7 @@ import kr.co.vividnext.sodalive.live.reservation_status.GetLiveReservationRespon
 import kr.co.vividnext.sodalive.live.room.CancelLiveRequest
 import kr.co.vividnext.sodalive.live.room.EnterOrQuitLiveRoomRequest
 import kr.co.vividnext.sodalive.live.room.LiveRoomStatus
+import kr.co.vividnext.sodalive.live.room.SetChatFreezeRequest
 import kr.co.vividnext.sodalive.live.room.SetManagerOrSpeakerOrAudienceRequest
 import kr.co.vividnext.sodalive.live.room.StartLiveRequest
 import kr.co.vividnext.sodalive.live.room.create.CreateLiveRoomResponse
@@ -186,6 +187,12 @@ interface LiveApi {
         @Header("Authorization") authHeader: String
     ): Single<ApiResponse<Any>>
 
+    @PUT("/live/room/info/set/chat-freeze")
+    fun setChatFreeze(
+        @Body request: SetChatFreezeRequest,
+        @Header("Authorization") authHeader: String
+    ): Single<ApiResponse<Any>>
+
     @GET("/live/room/{id}/donation-list")
     fun donationStatus(
         @Path("id") id: Long,

app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt

@@ -9,6 +9,7 @@ import kr.co.vividnext.sodalive.live.reservation_status.CancelLiveReservationReq
 import kr.co.vividnext.sodalive.live.room.CancelLiveRequest
 import kr.co.vividnext.sodalive.live.room.EnterOrQuitLiveRoomRequest
 import kr.co.vividnext.sodalive.live.room.LiveRoomStatus
+import kr.co.vividnext.sodalive.live.room.SetChatFreezeRequest
 import kr.co.vividnext.sodalive.live.room.SetManagerOrSpeakerOrAudienceRequest
 import kr.co.vividnext.sodalive.live.room.StartLiveRequest
 import kr.co.vividnext.sodalive.live.room.create.CreateLiveRoomResponse
@@ -112,6 +113,18 @@ class LiveRepository(
         authHeader = token
     )
 
+    fun setChatFreeze(
+        roomId: Long,
+        isChatFrozen: Boolean,
+        token: String
+    ) = api.setChatFreeze(
+        request = SetChatFreezeRequest(
+            roomId = roomId,
+            isChatFrozen = isChatFrozen
+        ),
+        authHeader = token
+    )
+
     fun getRoomInfo(roomId: Long, token: String) = api.getRoomInfo(roomId, authHeader = token)
 
     fun getDonationMessageList(
@@ -195,7 +208,7 @@ class LiveRepository(
 
     fun setManager(roomId: Long, userId: Long, token: String) = api.setManager(
         request = SetManagerOrSpeakerOrAudienceRequest(roomId, memberId = userId),
-        authHeader = token,
+        authHeader = token
     )
 
     fun creatorFollow(

app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt

@@ -100,6 +100,7 @@ import kr.co.vividnext.sodalive.live.room.chat.LiveRoomDonationChat
 import kr.co.vividnext.sodalive.live.room.chat.LiveRoomJoinChat
 import kr.co.vividnext.sodalive.live.room.chat.LiveRoomNormalChat
 import kr.co.vividnext.sodalive.live.room.chat.LiveRoomRouletteDonationChat
+import kr.co.vividnext.sodalive.live.room.chat.LiveRoomSystemNoticeChat
 import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationDialog
 import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationMessageDialog
 import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationMessageViewModel
@@ -190,6 +191,8 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
 
     // region 채팅 금지
     private var isNoChatting = false
+    private var isChatFrozen = false
+    private var hasShownInitialChatFreezeNotice = false
     private var remainingNoChattingTime = NO_CHATTING_TIME
     private val countDownTimer = object : CountDownTimer(remainingNoChattingTime * 1000, 1000) {
         override fun onTick(millisUntilFinished: Long) {
@@ -241,6 +244,110 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
         val noChatRoomList = SharedPreferenceManager.noChatRoomList
         return noChatRoomList.contains(roomId)
     }
+
+    private fun setChatFrozenState(isFrozen: Boolean) {
+        isChatFrozen = isFrozen
+        updateChatFreezeToggleUi()
+        updateChatInputState()
+    }
+
+    private fun updateChatInputState() {
+        val canInputChat = isHost || !isChatFrozen
+        binding.etChat.isEnabled = canInputChat
+        binding.ivSend.isEnabled = canInputChat
+        binding.ivSend.alpha = if (canInputChat) {
+            1f
+        } else {
+            0.4f
+        }
+
+        if (!canInputChat) {
+            binding.etChat.clearFocus()
+        }
+    }
+
+    private fun updateChatFreezeToggleUi() {
+        if (isChatFrozen) {
+            binding.tvChatFreezeSwitch.text = getString(R.string.screen_live_room_chat_freeze_on_label)
+            binding.tvChatFreezeSwitch.setTextColor(
+                ContextCompat.getColor(
+                    applicationContext,
+                    R.color.color_3bb9f1
+                )
+            )
+            binding.tvChatFreezeSwitch
+                .setBackgroundResource(R.drawable.bg_round_corner_5_3_transparent_3bb9f1)
+        } else {
+            binding.tvChatFreezeSwitch.text = getString(R.string.screen_live_room_chat_freeze_off_label)
+            binding.tvChatFreezeSwitch.setTextColor(
+                ContextCompat.getColor(
+                    applicationContext,
+                    R.color.color_eeeeee
+                )
+            )
+            binding.tvChatFreezeSwitch
+                .setBackgroundResource(R.drawable.bg_round_corner_5_3_transparent_bbbbbb)
+        }
+    }
+
+    private fun showChatFreezeWarning() {
+        Toast.makeText(
+            applicationContext,
+            getString(R.string.screen_live_room_chat_freeze_warning),
+            Toast.LENGTH_SHORT
+        ).show()
+    }
+
+    private fun buildChatFreezeStatusMessage(isFrozen: Boolean, actorNickname: String): String {
+        return getString(
+            if (isFrozen) {
+                R.string.screen_live_room_chat_freeze_started
+            } else {
+                R.string.screen_live_room_chat_freeze_ended
+            },
+            actorNickname
+        )
+    }
+
+    private fun addChatFreezeStatusMessage(message: String) {
+        if (message.isBlank()) {
+            return
+        }
+        chatAdapter.items.add(
+            LiveRoomSystemNoticeChat(message = message)
+        )
+        invalidateChat()
+    }
+
+    private fun toggleChatFreeze() {
+        if (!isHost) {
+            return
+        }
+
+        val nextChatFrozen = !isChatFrozen
+        viewModel.setChatFreeze(roomId = roomId, isChatFrozen = nextChatFrozen) {
+            setChatFrozenState(nextChatFrozen)
+
+            val noticeMessage = buildChatFreezeStatusMessage(
+                isFrozen = nextChatFrozen,
+                actorNickname = SharedPreferenceManager.nickname
+            )
+
+            addChatFreezeStatusMessage(noticeMessage)
+
+            agora.sendRawMessageToGroup(
+                rawMessage = Gson().toJson(
+                    LiveRoomChatRawMessage(
+                        type = LiveRoomChatRawMessageType.TOGGLE_CHAT_FREEZE,
+                        message = noticeMessage,
+                        can = 0,
+                        donationMessage = "",
+                        isChatFrozen = nextChatFrozen
+                    )
+                ).toByteArray()
+            )
+        }
+    }
     // endregion
 
     private val onBackPressedCallback = object : OnBackPressedCallback(true) {
@@ -509,7 +616,10 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
         )
 
         binding.etChat.setOnFocusChangeListener { view, hasFocus ->
-            if (isNoChatting && hasFocus) {
+            if (isChatFrozen && !isHost && hasFocus) {
+                showChatFreezeWarning()
+                view.clearFocus()
+            } else if (isNoChatting && hasFocus) {
                 Toast.makeText(
                     applicationContext,
                     getString(
@@ -576,6 +686,7 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
 
         binding.tvBgSwitch.setOnClickListener { viewModel.toggleBackgroundImage() }
         binding.tvSignatureSwitch.setOnClickListener { viewModel.toggleSignatureImage() }
+        binding.tvChatFreezeSwitch.setOnClickListener { toggleChatFreeze() }
         binding.tvV2vSignatureSwitch.setOnClickListener { toggleV2vCaption() }
         binding.llDonation.setOnClickListener {
             LiveRoomDonationRankingDialog(
@@ -1105,6 +1216,20 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
             }
 
             isHost = response.creatorId == SharedPreferenceManager.userId
+            binding.tvChatFreezeSwitch.visibility = if (isHost) {
+                View.VISIBLE
+            } else {
+                View.GONE
+            }
+            setChatFrozenState(response.isChatFrozen)
+
+            if (!isHost && response.isChatFrozen && !hasShownInitialChatFreezeNotice) {
+                addChatFreezeStatusMessage(
+                    getString(R.string.screen_live_room_chat_freeze_started)
+                )
+                hasShownInitialChatFreezeNotice = true
+            }
+
             initLikeHeartButton()
             initRouletteSettingButton()
             activatingRouletteButton(isActiveRoulette = response.isActiveRoulette)
@@ -1572,7 +1697,9 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
         val profileUrl = viewModel.getUserProfileUrl(SharedPreferenceManager.userId.toInt())
         val rank = viewModel.getUserRank(SharedPreferenceManager.userId)
 
-        if (isNoChatting) {
+        if (isChatFrozen && !isHost) {
+            showChatFreezeWarning()
+        } else if (isNoChatting) {
             Toast.makeText(
                 applicationContext,
                 getString(
@@ -1981,6 +2108,28 @@ class LiveRoomActivity : BaseActivity<ActivityLiveRoomBinding>(ActivityLiveRoomB
                         )
                     }
 
+                    LiveRoomChatRawMessageType.TOGGLE_CHAT_FREEZE -> {
+                        if (memberId.toLong() != SharedPreferenceManager.userId) {
+                            handler.post {
+                                val frozen = message.isChatFrozen ?: false
+                                setChatFrozenState(frozen)
+
+                                val statusMessage = if (message.message.isNotBlank()) {
+                                    message.message
+                                } else {
+                                    buildChatFreezeStatusMessage(
+                                        isFrozen = frozen,
+                                        actorNickname = nickname.ifBlank {
+                                            viewModel.getManagerNickname()
+                                        }
+                                    )
+                                }
+
+                                addChatFreezeStatusMessage(statusMessage)
+                            }
+                        }
+                    }
+
                     LiveRoomChatRawMessageType.ROULETTE_DONATION -> {
                         handler.post {
                             chatAdapter.items.add(

app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt

@@ -543,6 +543,50 @@ class LiveRoomViewModel(
         _isSignatureOn.value = !isSignatureOn.value!!
     }
 
+    fun setChatFreeze(roomId: Long, isChatFrozen: Boolean, onSuccess: () -> Unit) {
+        _isLoading.value = true
+
+        compositeDisposable.add(
+            repository.setChatFreeze(
+                roomId = roomId,
+                isChatFrozen = isChatFrozen,
+                token = "Bearer ${SharedPreferenceManager.token}"
+            )
+                .subscribeOn(Schedulers.io())
+                .observeOn(AndroidSchedulers.mainThread())
+                .subscribe(
+                    {
+                        _isLoading.value = false
+                        if (it.success) {
+                            if (isRoomInfoInitialized()) {
+                                roomInfoResponse = roomInfoResponse.copy(isChatFrozen = isChatFrozen)
+                                _roomInfoLiveData.postValue(roomInfoResponse)
+                            }
+                            onSuccess()
+                            getRoomInfo(roomId)
+                        } else {
+                            if (it.message != null) {
+                                _toastLiveData.postValue(it.message)
+                            } else {
+                                _toastLiveData.postValue(
+                                    SodaLiveApplicationHolder.get()
+                                        .getString(R.string.msg_live_room_edit_update_failed)
+                                )
+                            }
+                        }
+                    },
+                    {
+                        _isLoading.value = false
+                        it.message?.let { message -> Logger.e(message) }
+                        _toastLiveData.postValue(
+                            SodaLiveApplicationHolder.get()
+                                .getString(R.string.msg_live_room_edit_update_failed)
+                        )
+                    }
+                )
+        )
+    }
+
     fun editLiveRoomInfo(
         roomId: Long,
         newTitle: String,

app/src/main/java/kr/co/vividnext/sodalive/live/room/SetChatFreezeRequest.kt

@@ -0,0 +1,10 @@
+package kr.co.vividnext.sodalive.live.room
+
+import androidx.annotation.Keep
+import com.google.gson.annotations.SerializedName
+
+@Keep
+data class SetChatFreezeRequest(
+    @SerializedName("roomId") val roomId: Long,
+    @SerializedName("isChatFrozen") val isChatFrozen: Boolean
+)

app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt

@@ -83,13 +83,28 @@ data class LiveRoomJoinChat(
     }
 }
 
+@Keep
+data class LiveRoomSystemNoticeChat(
+    val message: String
+) : LiveRoomChat() {
+    override var type = LiveRoomChatType.JOIN
+    override fun bind(context: Context, binding: ViewBinding, onClickProfile: ((Long) -> Unit)?) {
+        val itemBinding = binding as ItemLiveRoomJoinChatBinding
+        itemBinding.tvJoin.setTextColor(
+            ContextCompat.getColor(context, R.color.color_eeeeee)
+        )
+        itemBinding.tvJoin.text = message
+        itemBinding.root.setBackgroundResource(R.drawable.bg_round_corner_4_7_cc004462)
+    }
+}
+
 @Keep
 data class LiveRoomNormalChat(
     @SerializedName("userId") val userId: Long,
     @SerializedName("profileUrl") val profileUrl: String,
     @SerializedName("nickname") val nickname: String,
     @SerializedName("rank") val rank: Int,
-    @SerializedName("chat") val chat: String,
+    @SerializedName("chat") val chat: String
 ) : LiveRoomChat() {
     override fun bind(context: Context, binding: ViewBinding, onClickProfile: ((Long) -> Unit)?) {
         val itemBinding = binding as ItemLiveRoomChatBinding

app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt

@@ -12,7 +12,8 @@ data class LiveRoomChatRawMessage(
     @SerializedName("signature") val signature: LiveRoomDonationResponse? = null,
     @SerializedName("signatureImageUrl") val signatureImageUrl: String? = null,
     @SerializedName("donationMessage") val donationMessage: String?,
-    @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean? = null
+    @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean? = null,
+    @SerializedName("isChatFrozen") val isChatFrozen: Boolean? = null
 )
 
 enum class LiveRoomChatRawMessageType {
@@ -31,6 +32,9 @@ enum class LiveRoomChatRawMessageType {
     @SerializedName("TOGGLE_ROULETTE")
     TOGGLE_ROULETTE,
 
+    @SerializedName("TOGGLE_CHAT_FREEZE")
+    TOGGLE_CHAT_FREEZE,
+
     @SerializedName("ROULETTE_DONATION")
     ROULETTE_DONATION,
 

app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt

@@ -27,6 +27,7 @@ data class GetRoomInfoResponse(
     @SerializedName("menuPan") val menuPan: String,
     @SerializedName("creatorLanguageCode") val creatorLanguageCode: String?,
     @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean,
+    @SerializedName("isChatFrozen") val isChatFrozen: Boolean = false,
     @SerializedName("isPrivateRoom") val isPrivateRoom: Boolean,
     @SerializedName("password") val password: String? = null
 )

app/src/main/res/layout/activity_live_room.xml

@@ -268,6 +268,22 @@
                         android:visibility="gone"
                         tools:ignore="SmallSp" />
 
+                    <TextView
+                        android:id="@+id/tv_chat_freeze_switch"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginEnd="8dp"
+                        android:background="@drawable/bg_round_corner_5_3_transparent_bbbbbb"
+                        android:fontFamily="@font/medium"
+                        android:gravity="center"
+                        android:paddingHorizontal="8dp"
+                        android:paddingVertical="4.7dp"
+                        android:text="@string/screen_live_room_chat_freeze_off_label"
+                        android:textColor="@color/color_eeeeee"
+                        android:textSize="12sp"
+                        android:visibility="gone"
+                        tools:ignore="SmallSp" />
+
                     <TextView
                         android:id="@+id/tv_signature_switch"
                         android:layout_width="wrap_content"

app/src/main/res/values-en/strings.xml

@@ -462,6 +462,11 @@
     <string name="screen_live_room_menu_prefix">[Menu] </string>
     <string name="screen_live_room_leave">Leave</string>
     <string name="screen_live_room_change_listener">Change to listener</string>
+    <string name="screen_live_room_chat_freeze_off_label">Freeze OFF</string>
+    <string name="screen_live_room_chat_freeze_on_label">Freeze ON</string>
+    <string name="screen_live_room_chat_freeze_warning">Chat is frozen. You cannot type right now.</string>
+    <string name="screen_live_room_chat_freeze_started">Chat has been frozen.</string>
+    <string name="screen_live_room_chat_freeze_ended">Chat freeze has been disabled.</string>
     <string name="screen_live_room_signature_off_label">Sign OFF</string>
     <string name="screen_live_room_v2v_signature_off_label">Caption OFF</string>
     <string name="screen_live_room_v2v_signature_on_label">Caption ON</string>

app/src/main/res/values-ja/strings.xml

@@ -461,6 +461,11 @@
     <string name="screen_live_room_menu_prefix">[メニュー] </string>
     <string name="screen_live_room_leave">退出</string>
     <string name="screen_live_room_change_listener">リスナー変更</string>
+    <string name="screen_live_room_chat_freeze_off_label">凍結 OFF</string>
+    <string name="screen_live_room_chat_freeze_on_label">凍結 ON</string>
+    <string name="screen_live_room_chat_freeze_warning">チャットが凍結中のため入力できません。</string>
+    <string name="screen_live_room_chat_freeze_started">チャットを凍結しました。</string>
+    <string name="screen_live_room_chat_freeze_ended">チャット凍結を解除しました。</string>
     <string name="screen_live_room_signature_off_label">シグ OFF</string>
     <string name="screen_live_room_v2v_signature_off_label">字幕 OFF</string>
     <string name="screen_live_room_v2v_signature_on_label">字幕 ON</string>

app/src/main/res/values/strings.xml

@@ -461,6 +461,11 @@
     <string name="screen_live_room_menu_prefix">[메뉴판] </string>
     <string name="screen_live_room_leave">나가기</string>
     <string name="screen_live_room_change_listener">리스너 변경</string>
+    <string name="screen_live_room_chat_freeze_off_label">얼림 OFF</string>
+    <string name="screen_live_room_chat_freeze_on_label">얼림 ON</string>
+    <string name="screen_live_room_chat_freeze_warning">채팅창이 얼려져 있어 입력할 수 없습니다.</string>
+    <string name="screen_live_room_chat_freeze_started">채팅창을 얼렸습니다.</string>
+    <string name="screen_live_room_chat_freeze_ended">채팅창 얼리기를 해제했습니다</string>
     <string name="screen_live_room_signature_off_label">시그 OFF</string>
     <string name="screen_live_room_v2v_signature_off_label">자막 OFF</string>
     <string name="screen_live_room_v2v_signature_on_label">자막 ON</string>

docs/20260319_라이브룸채팅창얼리기기능구현계획.md

@@ -0,0 +1,181 @@
+# 20260319_라이브룸채팅창얼리기기능구현계획.md
+
+## 개요
+- `LiveRoomActivity`에 채팅창 얼리기(Freeze) 토글을 추가한다.
+- 채팅창 얼리기 상태에서는 방장을 제외한 모든 사용자가 채팅 입력/전송을 할 수 없어야 한다.
+- 본 문서는 계획과 구현/검증 결과를 함께 관리한다.
+
+## 요구사항 요약
+- 토글 버튼 위치: `activity_live_room.xml`의 `tv_signature_switch` 왼쪽.
+- 얼림(ON): 방장 제외 전체 유저 채팅 입력 불가(포커스/입력/전송 모두 차단).
+- 녹임(OFF): 기존 채팅금지 해제와 동일하게 채팅 가능 상태로 복귀.
+- 상태 메시지: 얼림/녹임 시 모든 유저 채팅 리스트에 시스템 메시지 노출.
+- 상태 메시지 UI: 사용자 입장 알림(`LiveRoomJoinChat`)과 동일한 UI 사용.
+- 지연 입장: 채팅창이 얼려진 상태로 입장한 사용자도 즉시 상태를 받아 입력 불가여야 함.
+- 상태 변경 패턴: 룰렛과 동일하게 방장 ON/OFF 시 서버 API로 상태를 먼저 반영하고, 성공 시 RTM으로 실시간 전파.
+
+## 상태 저장 전략 판단 (ROOM_INFO vs 별도 상태)
+### 결론
+- **ROOM_INFO에 `isChatFrozen` 상태를 저장**하고, RTM 이벤트는 즉시 반영용으로 병행하는 전략을 채택한다.
+
+### 판단 근거
+- ROOM_INFO 기반 초기 동기화 경로가 이미 존재한다.
+  - `LiveRoomViewModel.getRoomInfo` -> `roomInfoResponse`/`roomInfoLiveData` 갱신.
+  - `LiveRoomActivity`는 `onCreate`, `onPresenceEvent(REMOTE_JOIN)` 등에서 `getRoomInfo`를 재호출한다.
+- 룸 전역 상태 선례가 존재한다.
+  - `GetRoomInfoResponse.isActiveRoulette` + `LiveRoomChatRawMessageType.TOGGLE_ROULETTE` 조합으로 운용 중이다.
+- 별도 로컬 상태(예: SharedPreferences)는 디바이스 단위라 전역 정합성에 취약하다.
+  - 현재 `noChatRoomList`는 로컬 단말 재진입 보조 용도이며, 전 유저 상태의 단일 진실원천(SSOT)으로는 부적합하다.
+- 외부 근거(Agora Signaling)상 메시지 채널은 pub/sub 모델이므로, 지연 입장자 상태 보장은 저장소(메타데이터/룸 정보) 병행이 유리하다.
+
+### 외부 레퍼런스(요약)
+- Agora Signaling 문서: channel metadata는 room attributes 저장/변경 알림/지속성을 제공하므로 지연 입장 정합성 확보에 적합.
+  - https://github.com/AgoraIO/Docs-Source/blob/b0d41f805f49a43c041453ce3ca73db2b8292b2f/shared/signaling/store-channel-metadata/index.mdx
+- Stream Chat Android: `Channel.frozen` 권위 상태 + 이벤트 병합(`mergeChannelFromEvent`) 패턴으로 freeze 상태를 모델에 유지.
+  - https://github.com/GetStream/stream-chat-android/blob/40119da704abfd56334db18c0f9fbb29f103f216/stream-chat-android-core/src/main/java/io/getstream/chat/android/models/Channel.kt
+- Matrix SDK: `m.room.power_levels` 기반 `maySendMessage` 권한 판별로 room-wide 전송 제한을 구현.
+  - https://github.com/matrix-org/matrix-js-sdk/blob/028357f15f173770f2dc695e7b2e20d3120bf71a/src/models/room-state.ts
+- LiveKit Android: participant metadata/attributes를 서버 권위 상태로 동기화하고 변경 이벤트를 분리 처리.
+  - https://github.com/livekit/client-sdk-android/blob/c91c476a5d6a674f4ff7f40f5b8326592754dabf/livekit-android-sdk/src/main/java/io/livekit/android/room/participant/Participant.kt
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: 방장이 얼림 ON 시, 방장을 제외한 사용자는 `et_chat`에 포커스/입력/전송이 모두 불가능하다.
+- [x] AC2: 방장이 얼림 OFF 시, 방장을 제외한 사용자의 채팅 입력/전송이 즉시 복구된다.
+- [x] AC3: 얼림/녹임 이벤트마다 모든 사용자 채팅 리스트에 시스템 상태 메시지가 1회씩 노출된다.
+- [x] AC4: 얼림 상태에서 새로 입장한 사용자는 입장 직후 입력 불가 상태를 즉시 적용받는다.
+- [x] AC5: 얼리기 토글 버튼은 `tv_signature_switch`의 왼쪽에 배치된다.
+- [x] AC6: 방장 얼림 ON/OFF 시 서버 API가 선행 호출되고, 성공한 경우에만 RTM 상태 브로드캐스트가 전송된다.
+
+## 구현 체크리스트
+### 1) UI/입력 제어
+- [x] `app/src/main/res/layout/activity_live_room.xml` 상단 토글 영역에 `tv_chat_freeze_switch` 추가 (`tv_signature_switch` 왼쪽).
+- [x] `LiveRoomActivity`에 전역 상태 변수(`isChatFrozen`) 및 UI 바인딩 로직 추가.
+- [x] `etChat` 포커스/입력/전송 경로(`setOnFocusChangeListener`, `inputChat`)를 통합 가드로 정리하여 Freeze 상태에서 완전 차단.
+
+### 2) 상태 전파/수신
+- [x] 서버 API 경로 반영: 전용 endpoint `PUT /live/room/info/set/chat-freeze` + `SetChatFreezeRequest(roomId, isChatFrozen)`로 ON/OFF를 서버 선반영.
+- [x] 저장소/뷰모델 경로 추가: `LiveRepository`/`LiveRoomViewModel`에 chat freeze ON/OFF API 호출 메서드 추가.
+- [x] 방장 토글 액션은 API 성공 콜백에서만 RTM 브로드캐스트를 전송하도록 순서 보장(룰렛과 동일).
+- [x] API 실패 시 RTM 미전송 + 오류 토스트 처리 시나리오 포함.
+- [x] `LiveRoomChatRawMessageType`에 Freeze 이벤트 타입 추가(예: `TOGGLE_CHAT_FREEZE`).
+- [x] `LiveRoomChatRawMessage`에 Freeze 상태 전달 필드 추가(예: `isChatFrozen`).
+- [x] 방장 토글 시 RTM 그룹 브로드캐스트 전송 + 수신 분기 처리(`rtmEventListener.onMessageEvent`) 구현.
+
+### 3) 지연 입장 동기화
+- [x] `GetRoomInfoResponse`에 `isChatFrozen` 필드 추가.
+- [x] `roomInfoLiveData.observe`에서 `isChatFrozen`을 입력 제어 상태에 반영.
+- [x] 입장/재연결/REMOTE_JOIN 시점에서 ROOM_INFO 재조회 흐름으로 상태 재적용이 가능하도록 적용.
+
+### 4) 시스템 메시지(UI 동일성)
+- [x] 입장 알림과 동일한 UI(`item_live_room_join_chat.xml`)를 재사용할 수 있도록 시스템 메시지 모델 경로 확장.
+- [x] 얼림/녹임 메시지를 `chatAdapter.items.add(...)` + `invalidateChat()` 경로로 주입.
+
+### 5) 문자열/국제화
+- [x] `values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`에 Freeze ON/OFF 라벨/상태 메시지 문구 추가.
+
+### 6) 검증
+- [x] 정적 진단: 수정 파일 대상 `lsp_diagnostics` 확인.
+- [x] 빌드/테스트: `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug` 실행.
+- [x] 수동 QA: 연결 단말 설치/실행 경로 확인 및 Activity 진입 시도 결과 기록.
+
+## 영향 파일(예상)
+- `app/src/main/res/layout/activity_live_room.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt`
+- `app/src/main/res/values/strings.xml`
+- `app/src/main/res/values-en/strings.xml`
+- `app/src/main/res/values-ja/strings.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt`
+
+## 리스크 및 의존성
+- 서버 ROOM_INFO에 `isChatFrozen` 필드가 제공되지 않으면 지연 입장 정합성 보장이 어렵다.
+- RTM 메시지만으로 구현하면 pub/sub 특성상 지연 입장 사용자에게 과거 상태 스냅샷이 누락될 수 있다.
+- API 성공 이전 RTM을 먼저 전송하면 서버 상태와 클라이언트 UI가 불일치할 수 있으므로, 전송 순서를 API 성공 이후로 강제해야 한다.
+- UI 차단을 포커스 차단만으로 처리하면 키보드/입력 우회가 가능하므로 `EditText` 자체 비활성 포함이 필요하다.
+
+## 검증 기록
+- 2026-03-19
+  - 무엇/왜/어떻게: 채팅창 얼리기 기능의 저장 전략 판단을 위해 LiveRoom 내부 구현 패턴, RTM 메시지 경로, ROOM_INFO 동기화 지점을 조사하고 계획 문서로 정리했다.
+  - 실행 명령/도구:
+    - `task(subagent_type="explore")` x3 (no-chat 흐름, room state sync, system UI 패턴)
+    - `task(subagent_type="librarian")` x2 (Agora 상태 전파 문서/실사례)
+    - `grep("isNoChatting|NO_CHATTING|...")`, `grep("LiveRoomChatRawMessageType|ROOM_INFO|...")`
+    - `ast_grep_search("LiveRoomChatRawMessage($$$)")`
+    - `read(LiveRoomActivity.kt, LiveRoomViewModel.kt, Agora.kt, GetRoomInfoResponse.kt, activity_live_room.xml, strings.xml 등)`
+    - `bash("rg -n ...")` 시도
+  - 결과:
+    - no-chat 기존 구현(로컬 저장 + peer 명령 + 타이머)과 ROOM_INFO 기반 전역 상태 동기화 패턴을 분리 확인.
+    - `isActiveRoulette` 선례를 통해 ROOM_INFO + RTM 병행 전략이 지연 입장 정합성에 유리함을 확인.
+    - 시스템 메시지 UI는 `LiveRoomJoinChat`/`item_live_room_join_chat.xml` 재사용이 가장 요구사항에 부합함을 확인.
+    - 환경에서 `rg` 명령은 미설치(`command not found`)로 확인되어, 동일 탐색은 `grep`/`ast_grep_search`/에이전트 결과로 보완.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 계획 문서 기준으로 채팅창 얼리기 기능을 구현하고, 룰렛과 동일하게 서버 API 성공 후 RTM 브로드캐스트 순서를 적용했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`, `LiveRoomViewModel.kt`, `LiveRepository.kt`, `LiveRoomChat.kt`, `LiveRoomChatRawMessage.kt`, `GetRoomInfoResponse.kt`, `EditLiveRoomInfoRequest.kt`, `activity_live_room.xml`, `strings*.xml`)
+    - 정적 진단: `lsp_diagnostics` (현재 환경 `.kt`, `.xml` 서버 미설정)
+    - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 스타일 검증: `./gradlew :app:ktlintCheck`
+    - 디바이스 수동 확인: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -W -n ...LiveRoomActivity --el roomId 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n ...LiveRoomActivity --el roomId 1`
+  - 결과:
+    - 초기 빌드에서 `values-en/strings.xml` 신규 문구 1건(`screen_live_room_chat_freeze_warning`) 리소스 컴파일 오류를 확인하고 문구를 수정했다.
+    - 재실행 결과 `./gradlew :app:testDebugUnitTest :app:assembleDebug` 성공.
+    - `./gradlew :app:ktlintCheck` 성공.
+    - `./gradlew :app:installDebug` 성공(연결 단말 1대 설치 확인).
+    - 셸 직접 실행은 non-exported Activity 제약으로 일반 `am start`가 차단되었고, `run-as` 기반 실행은 가능했으나 디버그 앱 사용자 데이터(`shared_prefs/kr.co.vividnext.sodalive.debug_preferences.xml`)가 비어 있어 실제 라이브룸 시나리오(방장/일반유저 2계정)까지는 환경 제약으로 진행하지 못했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 사용자 요청에 따라 채팅 얼리기 API를 `editLiveRoomInfo`에서 완전히 분리해 전용 URL(`/live/room/info/set/chat-freeze`)로 교체했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveApi.kt`, `LiveRepository.kt`, `LiveRoomViewModel.kt`, `SetChatFreezeRequest.kt`, `EditLiveRoomInfoRequest.kt`)
+    - 확인: `grep("setChatFreeze|editLiveRoomInfo|/live/room/info/set/chat-freeze")`, `git diff -- LiveApi.kt LiveRepository.kt LiveRoomViewModel.kt SetChatFreezeRequest.kt`
+  - 결과:
+    - `setChatFreeze` 호출은 전용 endpoint로 분리되었고 `api.editLiveRoomInfo(...)` 재사용이 제거되었다.
+    - `EditLiveRoomInfoRequest`의 `isChatFrozen` 필드는 제거되어 채팅 얼리기와 라이브 정보 수정 API 계약이 분리되었다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 전용 API 분리 이후 실제 단말 실행 가능 여부를 확인해 수동 QA 착수 가능 상태를 점검했다.
+  - 실행 명령/도구:
+    - `adb devices`
+    - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+  - 결과:
+    - 연결 단말 1대(`2cec640c34017ece`)가 확인되었고, debug 앱 런처 실행 이벤트 주입이 성공했다.
+    - 채팅 얼리기 엔드투엔드 검증(방장/일반 유저 2계정, 동일 룸 입장, ON/OFF 동기화)은 로그인 세션/테스트 계정/실제 룸 시나리오 준비가 필요해 후속 수동 QA 항목으로 유지한다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: TODO 잔여 항목(회귀 검증)을 완료하기 위해 테스트/빌드/코드스타일 검증을 단일 Gradle 실행으로 재확인했다.
+  - 실행 명령/도구:
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`
+  - 결과:
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:ktlintCheck` 모두 `UP-TO-DATE` 상태로 성공했고 전체 `BUILD SUCCESSFUL`을 확인했다.
+    - 추가 회귀 및 스타일 위반은 재현되지 않았다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 사용자 요청에 따라 채팅창 얼림/해제 시스템 메시지에서 크리에이터 닉네임 노출을 제거하고 고정 문구만 표시되도록 문자열 리소스를 수정했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`)
+    - 수동 확인: `read(.../values*/strings.xml)`로 `screen_live_room_chat_freeze_started/ended` 값에서 `%1$s` 제거 확인
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`, `lsp_diagnostics(strings.xml)` (환경상 `.kt`/`.xml` LSP 미구성)
+    - 회귀 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`
+  - 결과:
+    - 한국어 메시지는 요청대로 `채팅창을 얼렸습니다.`, `채팅창 얼리기를 해제했습니다`로 고정되어 닉네임이 표시되지 않는다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다.
+    - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 본 요청에서 수정한 문자열 리소스 3개 파일에서는 신규 위반이 관찰되지 않았다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 지연 입장 사용자가 얼림 상태를 인지하지 못하는 문제를 해결하기 위해 `isChatFrozen == true` 초기 동기화 시 시스템 메시지를 1회 노출하고, 채팅 입력 영역 터치 시 얼림 토스트를 표시하도록 `LiveRoomActivity`를 수정했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`)
+    - 정적 확인: `read(LiveRoomActivity.kt)`로 `hasShownInitialChatFreezeNotice`, `rlInputChat.setOnTouchListener`, `roomInfoLiveData.observe` 분기 추가 확인
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)` (환경상 `.kt` LSP 미구성)
+    - 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 스모크: `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+  - 결과:
+    - 지연 입장 초기 동기화에서 non-host + `isChatFrozen=true`일 때 채팅 리스트에 얼림 메시지가 1회 표시되도록 반영했다.
+    - non-host가 채팅 입력 영역(`rl_input_chat`)을 터치하면 `screen_live_room_chat_freeze_warning` 토스트가 노출되도록 반영했다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다.
+    - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 이번 수정 라인에서 신규 위반은 확인되지 않았다.