feat(main): 홈 대화 탭을 추가한다

docs/20260708_홈_채팅_탭/plan-task.md

@@ -0,0 +1,171 @@
+# 계획/TASK: 홈 채팅(대화) 탭
+
+관련 PRD: `docs/20260708_홈_채팅_탭/prd.md`
+
+## 구현할 UI Figma
+- 채팅 탭 전체(`177:3466`, `chat_001`): `https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab/-%EA%B3%B5%EC%9C%A0%EC%9A%A9-%EB%B3%B4%EC%9D%B4%EC%8A%A4%EC%98%A8-UI-UX-%EA%B8%B0%ED%9A%8D%EB%AC%B8%EC%84%9C?node-id=177-3466&m=dev`
+  - 구성: `StatusBar`, `title-bar`(`289:2962`), `tab-bar`(`177:3468`, capsule), `chat-list` item(`177:3469`~`177:3473`), `nav`(`177:3476`)
+  - 제외: `button-floating`(`177:3474`)은 사용자 확인에 따라 이번 범위에서 추가하지 않는다.
+
+## 재사용 위젯 vs 신규 위젯
+- 재사용:
+  - `DefaultTitleBar`(`SodaLive/Sources/V2/Component/DefaultTitleBar.swift`)
+  - `CapsuleTabBar`(`SodaLive/Sources/V2/Component/CapsuleTabBar.swift`) — filter 탭
+  - `DownsampledKFImage` + `Circle` clip — 원형 프로필
+  - `I18n.Time`(`justNow`/`minutesAgo`/`hoursAgo`/`daysAgo`) — 7일 이내 상대 시간
+  - `ApiResponse<T>` 디코딩, Moya `TargetType` + `Repository` + `ViewModel`(Combine) 패턴
+  - 라우팅: `AppStep.chatRoom(id:)` → `ChatRoomView(roomId:)`(AI 채팅방), `AppStep.canCharge(refresh:)`(충전), `AppStep.search`(기존 검색)
+- 신규:
+  - 채팅 탭 root View / ViewModel / API / Repository / Models
+  - filter enum(`MainChatFilter`: ALL/AI/DM)
+  - 채팅방 세로 리스트 아이템 컴포넌트, DM 태그(기존 `DirectTagView` 스타일 기반)
+  - 채팅 목록 전용 날짜 포맷 함수(7일 초과 시 `M월 d일` / `yyyy.MM.dd`, 다국어)
+  - I18n 문자열(탭 문구 변경, filter 문구, empty state)
+
+---
+
+### Phase 1: 다국어/문구
+
+- [x] **Task 1.1: 탭/타이틀 문구 변경**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/I18n/I18n.swift`
+  - 작업 내용:
+    - `I18n.Main.Tab.chat`을 `채팅/Chat/チャット` → `대화/Talks/トーク`로 변경한다.
+  - 검증 기준:
+    - 실행 명령: `rg "static var chat: String" SodaLive/Sources/I18n/I18n.swift`
+    - 기대 결과: `대화` / `Talks` / `トーク`로 변경된 문구가 확인된다. `MainTab.chat.title`과 `BottomTabView`에 동일 반영.
+
+- [x] **Task 1.2: 채팅 탭 전용 I18n 추가**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/I18n/I18n.swift`
+  - 작업 내용:
+    - `enum MainChat` 신설: filter 문구(`전체`/`AI 채팅`/`DM`), empty state 문구를 `pick(ko:en:ja:)`로 추가한다.
+    - 시간 포맷용 다국어 date format helper 추가(§Phase 4에서 사용): `M월 d일` / `MMM d` / `M月d日` 패턴.
+  - 검증 기준:
+    - 실행 명령: `rg "enum MainChat" SodaLive/Sources/I18n/I18n.swift`
+    - 기대 결과: filter/empty/date-format 문구가 확인된다.
+
+### Phase 2: 모델과 API 계층
+
+- [x] **Task 2.1: 응답 모델 정의**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/Models/MainChatRoomsResponse.swift`
+  - 작업 내용:
+    - `MainChatRoomsResponse`(`rooms: [MainChatRoomItem]`, `hasMore: Bool`, `nextCursor: String?`) 정의.
+    - `MainChatRoomItem`(`roomId: Int`, `chatType: String`, `targetName: String`, `targetImageUrl: String`, `lastMessage: String`, `lastMessageAt: String`) 정의(`Decodable, Identifiable`, `id = roomId`).
+  - 검증 기준:
+    - 실행 명령: `rg "struct MainChatRoomsResponse|struct MainChatRoomItem|hasMore|nextCursor" SodaLive/Sources/V2/Main/Chat/Models`
+    - 기대 결과: 래퍼/아이템 모델과 pagination 필드가 확인된다.
+
+- [x] **Task 2.2: filter enum 정의**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/MainChatFilter.swift`
+  - 작업 내용:
+    - `enum MainChatFilter: CaseIterable, Hashable { case all, ai, dm }` 정의.
+    - `queryValue`(`ALL`/`AI`/`DM`)와 `title`(I18n) 제공.
+  - 검증 기준:
+    - 실행 명령: `rg "enum MainChatFilter|queryValue|ALL|AI|DM" SodaLive/Sources/V2/Main/Chat/MainChatFilter.swift`
+    - 기대 결과: 3개 case와 query/title 매핑이 확인된다.
+
+- [x] **Task 2.3: API/Repository 추가**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/Repository/MainChatApi.swift`
+    - 생성: `SodaLive/Sources/V2/Main/Chat/Repository/MainChatRepository.swift`
+  - 작업 내용:
+    - `MainChatApi.getChatRooms(filter: String, cursor: String?)` case, path `/api/v2/chat/rooms`, method `.get`.
+    - query: `filter` 항상 전달, `cursor`는 nil이 아닐 때만 전달.
+    - `MainChatRepository.getChatRooms(filter:cursor:)` → `AnyPublisher<Response, MoyaError>`.
+  - 검증 기준:
+    - 실행 명령: `rg "getChatRooms|/api/v2/chat/rooms|filter|cursor|URLEncoding.queryString" SodaLive/Sources/V2/Main/Chat/Repository`
+    - 기대 결과: endpoint/파라미터/publisher가 확인된다.
+
+### Phase 3: ViewModel(cursor pagination + filter)
+
+- [x] **Task 3.1: 목록 조회/filter/pagination 구현**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/MainChatViewModel.swift`
+  - 작업 내용:
+    - 상태: `rooms`, `selectedFilter`, `isLoading`, `isLoadingNextPage`, `hasMore`, `nextCursor`, `hasLoaded`, `errorMessage`, `isShowPopup`.
+    - `fetchFirstPage(filter:)`: `cursor` 없이 조회, 성공 시 `rooms` 교체.
+    - `applyFilter(_:)`: 선택 filter 변경 시 기존 목록 초기화 후 첫 페이지 조회(같은 filter 재선택은 무시).
+    - `fetchNextPageIfNeeded(currentItem:)`: 마지막 아이템 노출 & `hasMore` & `nextCursor` 존재 시 다음 페이지 조회 후 append.
+    - `latestRequestId` 경합 방지, `ApiResponse<MainChatRoomsResponse>` 디코딩.
+  - 검증 기준:
+    - 실행 명령: `rg "final class MainChatViewModel|fetchFirstPage|applyFilter|fetchNextPageIfNeeded|latestRequestId|hasMore|nextCursor" SodaLive/Sources/V2/Main/Chat/MainChatViewModel.swift`
+    - 기대 결과: 첫 페이지 교체/append와 경합 방지 로직이 확인된다.
+
+### Phase 4: 시간 포맷 유틸
+
+- [x] **Task 4.1: 채팅 목록 전용 날짜 포맷 함수 추가**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/Common/DateParser.swift`
+  - 작업 내용:
+    - 신규 static 함수(예: `chatListDateText(fromUTC:now:)`) 추가. 기존 `relativeTimeText`는 변경하지 않는다.
+    - 디바이스 timezone(`Calendar.current`) 기준으로:
+      - 7일 이내: `I18n.Time` 상대 시간.
+      - 7일 초과 & 올해: 다국어 `M월 d일`(`MMM d`/`M月d日`).
+      - 과거 연도: `yyyy.MM.dd`.
+    - 파싱 실패 시 fallback 원문 반환.
+  - 검증 기준:
+    - 실행 명령: `rg "chatListDateText|M월 d일|yyyy.MM.dd" SodaLive/Sources/Common/DateParser.swift SodaLive/Sources/I18n/I18n.swift`
+    - 기대 결과: 3구간 분기와 다국어 포맷이 확인된다.
+
+### Phase 5: 컴포넌트
+
+- [x] **Task 5.1: 채팅방 리스트 아이템**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/Components/MainChatRoomListItem.swift`
+  - 작업 내용:
+    - 원형 프로필(`DownsampledKFImage`) + 이름(bold) + 마지막 메시지(1줄 tail) + 시간 텍스트(`DateParser.chatListDateText`) 레이아웃.
+    - `chatType == "DM"`이면 DM 태그 표시(soda400 배경, 흰색). unread dot 미표시.
+    - item tap closure로 `roomId`, `chatType` 전달.
+  - 검증 기준:
+    - 실행 명령: `rg "struct MainChatRoomListItem|DownsampledKFImage|chatListDateText|DM" SodaLive/Sources/V2/Main/Chat/Components/MainChatRoomListItem.swift`
+    - 기대 결과: 아이템 레이아웃과 DM 태그/시간 표시가 확인된다.
+
+### Phase 6: root View 및 탭 연결
+
+- [x] **Task 6.1: 채팅 탭 root View**
+  - 대상 파일:
+    - 생성: `SodaLive/Sources/V2/Main/Chat/MainChatView.swift`
+  - 작업 내용:
+    - `DefaultTitleBar(title: MainTab.chat.title)` + 우측 메뉴(`ic_bar_cash`, `ic_bar_search`) + `CapsuleTabBar`(filter) + 세로 목록(`ScrollView`/`LazyVStack`)을 구성한다.
+    - `ic_bar_cash` 터치 시 `onTapCanCharge`, `ic_bar_search` 터치 시 `onTapSearch` closure를 호출한다.
+    - `CapsuleTabBar` 선택 변경을 `viewModel.applyFilter(_:)`에 연결.
+    - 마지막 아이템 `onAppear`에서 `fetchNextPageIfNeeded(currentItem:)` 호출.
+    - 아이템 tap: `chatType == "AI"` → `AppState.shared.setAppStep(step: .chatRoom(id: roomId))`, `"DM"` → 다음 범위의 DM 화면 추가 전까지 미연결.
+    - 첫 진입 시 `fetchFirstPage(filter: .all)` 호출, empty state 처리.
+    - 플로팅 버튼은 추가하지 않는다.
+  - 검증 기준:
+    - 실행 명령: `rg "struct MainChatView|DefaultTitleBar|ic_bar_cash|ic_bar_search|CapsuleTabBar|applyFilter|fetchNextPageIfNeeded|chatRoom\\(id:" SodaLive/Sources/V2/Main/Chat/MainChatView.swift`
+    - 기대 결과: title bar 우측 메뉴/filter/목록/pagination/라우팅 연결이 확인되고 `MainChatFloatingButton`은 존재하지 않는다.
+
+- [x] **Task 6.2: MainView 채팅 탭 교체**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/V2/Main/MainView.swift`
+  - 작업 내용:
+    - `contentView`의 `.chat` case를 `MainPlaceholderTabView(title: MainTab.chat.title)` → `MainChatView(...)`로 교체한다.
+    - 기존 `handleHomeCanChargeTap`, `handleHomeSearchTap`을 `MainChatView`의 우측 메뉴 closure로 전달한다.
+  - 검증 기준:
+    - 실행 명령: `rg "case .chat:|MainChatView|handleHomeCanChargeTap|handleHomeSearchTap|MainPlaceholderTabView" SodaLive/Sources/V2/Main/MainView.swift`
+    - 기대 결과: `.chat`에서 `MainChatView`가 렌더되고 placeholder는 제거되며 충전/검색 라우팅 closure가 전달된다.
+
+### Phase 7: 프로젝트 등록 및 검증
+
+- [x] **Task 7.1: Xcode 프로젝트에 신규 파일 등록 및 빌드**
+  - 대상 파일:
+    - 수정: `SodaLive.xcodeproj/project.pbxproj`
+  - 작업 내용:
+    - 신규 `.swift` 파일을 타깃 소스에 추가한다.
+  - 검증 기준:
+    - 실행 명령: `docs/agent-guides/build-test-verification.md` 기준 빌드.
+    - 기대 결과: 빌드 성공, 채팅 탭에서 목록/필터/pagination/AI 라우팅 정상 동작.
+
+---
+
+## 검증 기록
+- 2026-07-08 문서 작성: Figma `177:3466` design context/metadata 확인, 기존 재사용 위젯(`DefaultTitleBar`, `CapsuleTabBar`, `DownsampledKFImage`, `I18n.Time`, `AppStep.chatRoom`)과 신규 필요 항목(리스트 아이템/플로팅/날짜 포맷/API·Repository·ViewModel·Models)을 분류해 PRD와 본 계획 문서에 반영. 본 범위는 PRD와 계획 문서 작성까지이며 구현은 포함하지 않음.
+- 2026-07-08 문서 보완: 사용자 확인 사항을 반영해 플로팅 버튼을 구현 범위에서 제외하고, title bar 우측 메뉴를 `ic_bar_cash`/`ic_bar_search` 순서와 충전/검색 라우팅으로 확정했다. `chatType == "DM"` 라우팅은 다음 범위의 DM 화면 추가 전까지 미연결로 유지하고, 탭 영어/일본어 문구를 `Talks`/`トーク`로 갱신했다. 실행 명령: `sed -n`으로 PRD/계획 문서와 `documentation-policy.md` 확인, `rg`로 기존 V2 title bar 메뉴 및 `AppStep.canCharge`/`AppStep.search` 관례 확인.
+
+- 2026-07-08 구현 완료: `I18n.Main.Tab.chat`을 `대화/Talks/トーク`으로 변경하고 `I18n.MainChat` 문자열, `DateParser.chatListDateText(fromUTC:fallback:now:)`, V2 채팅 탭의 Model/API/Repository/ViewModel/View/Row 컴포넌트를 추가했다. `.chat` 탭은 `MainChatView`로 교체했고, 신규 Swift 파일을 `SodaLive.xcodeproj/project.pbxproj`의 Chat 그룹 및 앱 소스 빌드 단계에 등록했다.
+- 2026-07-08 검증 기록: `xcodebuild -workspace "SodaLive.xcworkspace" -list` 성공. 최초 `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build`는 신규 파일 참조가 루트 경로로 해석되어 실패했고, pbxproj 파일 참조 ID를 정정한 뒤 동일 명령 재실행 결과 `** BUILD SUCCEEDED **`를 확인했다. 빌드 로그에는 기존 프로젝트의 중복 Compile Sources 경고가 다수 표시되며, 신규 Chat 파일도 기존 등록 패턴과 동일하게 중복 경고에 포함된다. 추가로 `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`도 `** BUILD SUCCEEDED **`를 확인했다.

docs/20260708_홈_채팅_탭/prd.md

@@ -0,0 +1,172 @@
+# PRD: 홈 채팅(대화) 탭
+
+## 1. Overview
+메인 하단 탭의 채팅 탭(`MainTab.chat`)에 진입했을 때 표시하는 V2 대화 목록 화면을 제작한다. 화면은 상단 `DefaultTitleBar`(좌측 화면명 `대화`), 필터용 Capsule Tab(`전체` / `AI 채팅` / `DM`), 채팅방 목록으로 구성한다.
+
+목록 API는 `GET /api/v2/chat/rooms`를 사용하며 `filter`(ALL / AI / DM)와 `cursor` 파라미터로 조회한다. 응답의 `hasMore`와 `nextCursor`로 스크롤 pagination을 처리한다.
+
+Figma 참조:
+- 채팅 탭 전체: `177:3466`(`chat_001`), `https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab/-%EA%B3%B5%EC%9C%A0%EC%9A%A9-%EB%B3%B4%EC%9D%B4%EC%8A%A4%EC%98%A8-UI-UX-%EA%B8%B0%ED%9A%8D%EB%AC%B8%EC%84%9C?node-id=177-3466&m=dev`
+
+---
+
+## 2. Problem
+- 현재 채팅 탭은 `MainView`의 `contentView`에서 `MainPlaceholderTabView(title: MainTab.chat.title)`로만 연결되어 실제 대화 목록이 없다.
+- 홈 팔로잉 탭의 최근 대화(`MainHomeFollowingChatSection`)는 가로 스크롤 카드 형태라 채팅 탭의 세로 목록 UI와 구조가 다르다.
+- 채팅방 목록 조회 API(`GET /api/v2/chat/rooms`)와 filter/cursor 기반 pagination이 연결되어 있지 않다.
+- 탭명과 title bar 좌측 문구가 현재 `채팅`으로 노출되어 기획의 `대화`와 다르다.
+
+---
+
+## 3. Goals
+- 채팅 탭 진입 시 `GET /api/v2/chat/rooms?filter=ALL`(첫 페이지)를 호출해 대화 목록을 표시한다.
+- 탭명과 title bar 좌측 화면명을 `대화`로 변경한다.
+- title bar 우측 메뉴에 `ic_bar_cash`, `ic_bar_search`를 순서대로 배치하고 각각 충전 페이지, 기존 검색 페이지로 이동한다.
+- Capsule Tab(`전체` / `AI 채팅` / `DM`)으로 filter를 전환하고, 미선택 탭 터치 시 화면의 기존 데이터를 모두 지운 뒤 해당 filter의 첫 페이지를 다시 조회해 표시한다.
+- `hasMore == true`이고 `nextCursor`가 있으면 마지막 아이템 노출 시 다음 페이지를 조회해 append한다.
+- 채팅방 아이템은 프로필 이미지, 크리에이터 이름, DM 태그(`chatType == "DM"`), 마지막 메시지 미리보기, 마지막 메시지 상대/절대 시간을 표시한다.
+- `lastMessageAt`(ISO-8601, UTC)을 디바이스 timezone 기준으로 변환해 규칙에 맞는 시간 텍스트를 다국어로 표시한다.
+- 채팅방 아이템 터치 시 `chatType`에 따라 이동한다. `AI`이면 `ChatRoomView`(`AppStep.chatRoom(id:)`)로 이동하고, `DM`이면 이번 범위에서는 이동 대상 화면이 없으므로 라우팅을 연결하지 않는다.
+
+---
+
+## 4. Non-Goals
+- unread dot(안 읽음 표시)은 이번 범위에서 표시하지 않는다.
+- 플로팅 버튼은 이번 범위에서 추가하지 않는다.
+- `chatType == "DM"` 아이템 터치 시 이동할 신규 DM 화면은 이번 범위를 벗어나며 다음 범위에서 만든다.
+- 채팅방 생성/삭제/나가기 등 목록 조회 외 mutation은 다루지 않는다.
+- 기존 홈 팔로잉 `MainHomeFollowingChatSection`(가로 카드)은 변경하지 않는다.
+- Figma localhost asset URL을 앱 코드에 직접 사용하지 않는다.
+- `Pods/**`, `generated/**`, `build/**`는 수정하지 않는다.
+
+---
+
+## 5. Target Users
+- AI 캐릭터 또는 크리에이터와의 대화 목록을 한 곳에서 확인하려는 사용자
+- filter로 AI 채팅 / DM만 골라 보려는 사용자
+
+---
+
+## 6. User Stories
+- 사용자는 채팅 탭에 들어가 자신의 대화 목록을 최신 순으로 확인할 수 있다.
+- 사용자는 `AI 채팅` 탭을 눌러 AI 대화만, `DM` 탭을 눌러 DM 대화만 볼 수 있다.
+- 사용자는 목록을 아래로 스크롤하면 다음 페이지가 이어서 로드되는 것을 확인할 수 있다.
+- 사용자는 각 대화의 마지막 메시지와 마지막 메시지 시간을 확인할 수 있다.
+- 사용자는 AI 대화 아이템을 눌러 해당 AI 채팅방으로 이동할 수 있다.
+
+---
+
+## 7. Core Requirements
+
+### 7.1 API
+신규 V2 조회 API는 채팅 탭 전용 API/Repository로 추가한다. 응답 래퍼는 기존 V2 관례대로 `ApiResponse<...>`로 디코딩하고, Kotlin `Long`은 Swift `Int`로 선언한다.
+
+목록:
+- Method: `GET`
+- Path: `/api/v2/chat/rooms`
+- Query parameters:
+  - `filter`: `ALL` / `AI` / `DM` 중 하나. 선택된 Capsule Tab에 대응한다.
+  - `cursor`: 다음 페이지 조회에 사용할 커서. 첫 페이지 조회 시에는 전달하지 않는다.
+
+서버 응답(`HomeChatModels`)은 채팅 탭 스펙에 맞춰 아래 이름으로 매핑한다. 서버 필드명은 유지하되 Swift 모델 이름만 목적에 맞게 정한다.
+
+```kotlin
+// 서버 응답 (참고: HomeChatModels)
+data class ChatRoomsResponse(
+    val rooms: List<ChatRoomItem>,
+    @JsonProperty("hasMore")
+    val hasMore: Boolean,
+    val nextCursor: String?
+)
+
+data class ChatRoomItem(
+    val roomId: Long,
+    val chatType: String,        // "AI" | "DM"
+    val targetName: String,
+    val targetImageUrl: String,
+    val lastMessage: String,
+    val lastMessageAt: String    // ISO-8601 (UTC)
+)
+```
+
+Swift 모델 네이밍(결정):
+- 목록 래퍼: `MainChatRoomsResponse` (`rooms`, `hasMore`, `nextCursor`)
+- 아이템: `MainChatRoomItem` (`roomId`, `chatType`, `targetName`, `targetImageUrl`, `lastMessage`, `lastMessageAt`)
+
+> 참고: 홈 팔로잉의 기존 `ChatRoomListItemResponse`가 동일한 필드 구성을 가지지만, 페이지네이션 응답(`hasMore`/`nextCursor`)이 없고 다른 화면(`HomeFollowingTabResponse`) 전용이므로, 채팅 탭에서는 별도 `MainChatRoomItem` 모델을 둔다.
+
+### 7.2 화면 구성
+- root View는 `MainContentView` 패턴을 따른다: `DefaultTitleBar` + Capsule Tab + 목록 + `Color.black.ignoresSafeArea()`.
+- title bar: `DefaultTitleBar(title: MainTab.chat.title)`를 사용하고, 좌측 화면명은 `대화`로 노출된다(§7.6 참고). 우측 메뉴는 `ic_bar_cash`, `ic_bar_search` 순서로 노출한다. `ic_bar_cash` 터치 시 충전 페이지(`AppStep.canCharge(refresh:)`), `ic_bar_search` 터치 시 기존 검색 페이지(`AppStep.search`)로 이동한다.
+- filter Capsule Tab: 기존 `CapsuleTabBar<Item>`를 재사용하고 `전체` / `AI 채팅` / `DM` 3개를 노출한다.
+- 목록: 세로 리스트(스크롤). 각 행은 신규 채팅방 리스트 아이템 컴포넌트로 표시한다.
+
+### 7.3 채팅방 리스트 아이템
+- 좌측: 원형 프로필 이미지(`DownsampledKFImage` + `Circle` clip 패턴 재사용).
+- 우측 영역: 크리에이터 이름(bold), 마지막 메시지 미리보기(1줄, tail 말줄임), 마지막 메시지 시간 텍스트.
+- `chatType == "DM"`이면 DM 태그를 함께 표시한다(기존 `DirectTagView` 스타일: `Color.soda400` 배경, 흰색 텍스트).
+- unread dot은 표시하지 않는다.
+
+### 7.4 filter 전환 동작
+- 현재 선택되어 있지 않은 Capsule Tab을 터치하면 해당 filter로 첫 페이지 API를 호출한다.
+- 첫 페이지 로딩 시 화면의 기존 목록 데이터를 모두 비우고, 응답으로 새로 세팅해 표시한다.
+- 이미 선택된 탭을 다시 터치하면 재요청하지 않는다.
+
+### 7.5 pagination
+- 첫 페이지: `cursor` 없이 조회하고 결과로 목록을 교체한다.
+- 다음 페이지: 마지막 아이템 노출 시 `hasMore == true`이고 `nextCursor`가 있으면 `cursor = nextCursor`로 조회하고 결과를 append한다.
+- 중복 호출 방지를 위해 로딩 상태 guard와 요청 경합 방지(`latestRequestId` 패턴)를 둔다.
+
+### 7.6 탭/타이틀 문구
+- `I18n.Main.Tab.chat`의 한국어 값을 `채팅` → `대화`로 변경한다. 이 값은 하단 탭명과 title bar 좌측 화면명에 모두 사용된다.
+- 영어/일본어 값은 `대화`(conversation) 의미에 맞춰 `Talks` / `トーク`로 변경한다.
+- 이 문구는 V2 `MainTab`과 V1 `BottomTabView`에서 공유되므로 두 곳 모두 동일하게 `대화`로 노출된다.
+
+### 7.7 시간 표시 규칙(다국어)
+`lastMessageAt`(ISO-8601, UTC)을 디바이스 timezone으로 변환 후 아래 규칙으로 표시한다.
+
+1. 일주일(7일) 이내: 상대 시간(다국어). 기존 `I18n.Time`(`justNow`/`minutesAgo`/`hoursAgo`/`daysAgo`)을 재사용한다.
+2. 일주일 초과 & 올해 수신: `M월 d일` 형태(다국어).
+   - 한국어: `M월 d일`
+   - 영어: `MMM d`
+   - 일본어: `M月d日`
+3. 올해가 아닌 과거 연도 수신: `yyyy.MM.dd` 형태.
+
+> 기존 `DateParser.relativeTimeText`는 7일 초과 시 `개월/년 전`을 반환하므로 이 규칙과 다르다. 채팅 목록 전용 날짜 포맷 함수를 신규로 추가한다(기존 함수는 변경하지 않는다).
+
+### 7.8 아이템 터치 라우팅
+- `chatType == "AI"`: `AppState.shared.setAppStep(step: .chatRoom(id: roomId))`로 `ChatRoomView(roomId:)`로 이동한다(extras는 `roomId`로 충분).
+- `chatType == "DM"`: 이동할 화면이 다음 범위이므로 라우팅을 연결하지 않는다(액션 미연결).
+
+### 7.9 Edge Cases
+- 빈 목록: empty state 문구를 표시한다.
+- 첫 페이지 로딩 중 filter 재전환: 이전 요청 결과가 화면에 반영되지 않도록 요청 경합을 방지한다.
+- `nextCursor`가 없거나 `hasMore == false`: 추가 조회를 하지 않는다.
+- `lastMessageAt` 파싱 실패: 원문 문자열을 fallback으로 표시한다(기존 `DateParser` 관례와 동일).
+
+---
+
+## 8. UX / UI Expectations
+- 배경은 `Color.black`, 폰트/컬러/spacing은 기존 V2 토큰(`appFont`, `SodaSpacing`, `Color.soda400/gray900` 등)을 따른다.
+- Capsule Tab 선택 시 `Color.soda400` 배경으로 강조(기존 `CapsuleTabBar` 동작 그대로).
+- 목록 스크롤 시 하단 도달 전에 자연스럽게 다음 페이지가 이어지도록 한다.
+
+---
+
+## 9. Technical Constraints
+- 신규 View/ViewModel/Repository/Model은 `SodaLive/Sources/V2/Main/Chat/**` 아래에 작성한다(콘텐츠 탭 `V2/Main/Content/**` 구조와 동일한 규칙).
+- 여러 페이지 공용 컴포넌트는 `V2/Component/**`, 채팅 탭 전용 컴포넌트는 채팅 폴더 하위 `Components`에 배치한다.
+- API는 Moya `TargetType` enum + `Repository`(`requestPublisher` → `Response`) + `ViewModel`(Combine, `ApiResponse<T>` 디코딩) 패턴을 따른다.
+- 다국어 문자열은 `I18n`에 `pick(ko:en:ja:)`로 추가한다.
+
+---
+
+## 10. Open Questions
+- 현재 없음.
+
+## 11. Confirmed Decisions (2026-07-08)
+- 플로팅 버튼은 추가하지 않는다.
+- title bar 우측 메뉴는 `ic_bar_cash`, `ic_bar_search` 순서로 노출한다.
+- `ic_bar_cash`는 충전 페이지, `ic_bar_search`는 기존 검색 페이지로 이동한다.
+- `chatType == "DM"` 터치 시 이동할 DM 화면은 다음 범위에서 추가한다.
+- `I18n.Main.Tab.chat`의 영어/일본어 문구는 `Talks` / `トーク`로 확정한다.