docs(dm): 날짜 표시 구현과 검증 제한을 기록한다

This commit is contained in:
2026-10-19 10:21:32 +09:00
parent 5637a0acba
commit b2affa66d2
3 changed files with 532 additions and 0 deletions
@@ -0,0 +1,315 @@
# 유저-크리에이터 DM 날짜 구분선과 수신 시간 표시 구현 계획
| 문서 항목 | 내용 |
|---|---|
| 상태 | 구현 완료·검증 제한 기록 완료 |
| 작성일 | 2026-10-16 |
| 요구사항 기준 | `docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md` |
| API 기준 | 없음. 기존 DM API/소켓 계약 변경 없음 |
| 현재 Phase | Phase 1, 구현 및 리뷰 완료 |
| 현재 활성 Goal | 없음 |
## 목표
확정된 제품 정책을 유저-크리에이터 DM의 표시 타임라인과 상대 메시지 레이아웃에 반영하되, 기존 pagination, 메시지 identity, 실시간 전송 및 스크롤 동작을 유지한다.
## 현재 상태
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|---:|---|---:|---|---|
| 1 | 구현 완료, Gate 제한 | `4/4` 구현 Task | 없음 | DM 회귀·빌드·ktlint 통과. 전체 suite/lint 및 기기 확인 제한은 하단 기록 |
사용자 구현 승인에 따라 아래 체크박스를 실제 검증 완료 시점에 갱신한다. 문서 단계의 기존 기록은 유지한다.
## 범위
### 포함
- 앱 언어 `ko`, `en`, `ja`와 기기 현지 시간대에 따른 날짜 포맷 및 표시 타임라인 projection.
- 기존 DM adapter에 날짜 아이템 표시를 통합하고, Activity의 prepend/하단 스크롤 인덱스를 표시 아이템 기준으로 보정.
- 상대 메시지 XML에서 시간을 말풍선 오른쪽 하단 바깥에 둔 채, 시간 영역을 예약하고 본문이 줄바꿈되는 폭 제한.
- 로직/local unit test, 기존 관련 테스트 보존, 자원 컴파일·lint 및 최종 gate.
### 제외
- 이 문서 작업에서 코드·테스트·리소스 변경, 구현·테스트 실행, 기기·에뮬레이터 조작, 스크린샷 및 시각 QA.
- 서버/API/socket/도메인 ViewModel 정책 변경, 레거시 공통 코드 변경, dependency 추가, 새 API contract 파일. 이번에는 코드 리뷰를 수행하거나 리뷰 문서를 생성하지 않는다. 향후 코드 리뷰를 수행하면 저장소의 리뷰 기록 규칙을 따른다.
- 오늘/어제 표현, sticky header, 앱 전체 locale 변경, 시간대 변경 listener 등 PRD 밖 동작.
## 기술적 제약
- 기존 UI는 `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/` 아래에 둔다. 상대 메시지 XML은 `app/src/main/res/layout/item_dm_chat_opponent_message.xml`이다.
- 기존 메시지 입력은 `DmChatRoomUiState.Content.messages: List<DmChatMessageUiItem>`이며 정렬·dedup은 mapper/ViewModel에서 처리한다. 날짜 header는 표시 projection에만 추가한다.
- 앱 언어 코드는 `LanguageManager.getEffectiveLanguage(context)`를 기준으로 하며 기기의 국가 코드를 사용하지 않는다. 날짜 경계는 `TimeZone.getDefault()`에 해당하는 기기 현지 시간대를 사용한다.
- adapter의 `submitItems` 호출 이름, stable IDs, pending local ID와 ACK된 server ID를 연결하는 `sameIdentity` 동작을 깨뜨리지 않는다. `submitItems` 인자는 timeline 표시 아이템으로 바꾼다. 새 아이템 종류는 DiffUtil identity와 view type에서 날짜/메시지를 분리한다.
- stable ID는 header와 message 사이에 충돌하지 않고, 같은 날짜 header의 재구성에서도 안정적이어야 한다. 계획 선택은 adapter lifetime 동안 아래 `DmChatTimelineIdentity`를 key로 단조 증가 ID를 할당하는 방식이다. Long 원본 값/해시 namespace 충돌을 피하고 같은 identity의 ID를 재사용한다. pending-to-ACK는 ViewModel이 보존하는 local ID를 우선 사용한다.
- `DmChatRoomActivity.bindContent`는 메시지 목록 index로 `scrollToPosition`을 호출하고, prepend 시 ViewModel count event를 Content보다 먼저 발행한다. count event에 header 수를 더하는 방식은 금지한다.
- Activity는 실제 prepend 요청 직전의 첫 가시 메시지 identity와 화면 top pixel offset을 보관한다. 첫 가시 행이 날짜라면 그 뒤의 첫 가시 메시지를 anchor로 삼는다. prepend event는 복원 대기 상태만 표시하고, Content 제출 후 새 표시 목록에서 identity를 찾아 해당 offset으로 복원한다. identity를 찾지 못하면 임의의 count 산술로 보정하지 않는다.
- 로딩 중 Content와 실시간 갱신은 저장한 prepend anchor를 소비하지 않는다. `isLoadingOlder == false`인 완료 Content를 제출한 뒤, 해당 요청에 대한 양수 count 신호가 있으면 anchor를 복원한다. 실패·빈 결과·중복만 있는 결과에서는 복원 대기 상태를 정리한다. Activity 재생성 시 재전달된 이전 count 값은 현재 요청의 anchor가 없으면 무시한다.
- 과거 페이지 로딩 중에는 anchor 보존이 자동 하단 이동보다 우선한다. 그 밖의 일반 갱신은 Content 제출 전 near-bottom 상태에 따라 새 표시 목록의 마지막 adapter position으로 이동한다. near-bottom은 현재 표시 위치 뒤에 남은 메시지 수가 2 미만인지로 판단해 날짜 행이 기존 메시지 기준 임계값을 바꾸지 않게 한다.
- `DmChatRoomActivitySourceTest`는 `prependedMessageCountLiveData.observe(this)`, `scrollToPositionWithOffset`, `messageAdapter.submitItems` 및 기존 layout/formatter import 문자열을 확인한다. 필요한 Activity wiring 변경과 실제 assertion 간 충돌이 생기면 source test를 약화·삭제하지 말고 비레이아웃 동작을 확인하는 focused local test를 추가해 해결한다.
- 테스트는 `app/src/test`의 로직/local unit test만 사용한다. 레이아웃 속성 테스트와 `app/src/androidTest`는 추가하지 않는다.
- 수신 시간 표시 XML 조정은 TDD 예외다. 리소스 컴파일, lint, 정적 XML 구조 대조만 수행하며 이를 시각적 성공 증거로 표현하지 않는다.
- 작업 중 범위가 바뀌면 먼저 이 계획을 고치고 확인한다. 제품 구현은 승인 전 시작하지 않는다.
## 구현 파일과 인터페이스
| 파일 | 계획된 책임 |
|---|---|
| `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatDateFormatter.kt` | epoch millis, 앱 언어, timezone으로 전체 날짜/요일 텍스트 생성 |
| `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatTimeline.kt` | sealed 표시 아이템, 날짜 그룹 projection, item identity/index/anchor 관련 순수 로직 |
| `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/ui/DmChatMessageAdapter.kt` | 표시 아이템 수신, header/message view type, DiffUtil 및 stable ID, 기존 message rendering 보존 |
| `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivity.kt` | 앱 언어/timezone projection 입력, Content 제출, prepend anchor와 bottom-scroll 통합 |
| `app/src/main/res/layout/item_dm_chat_date_header.xml` | 기존 DM 색상·글꼴을 이용한 중앙 날짜 텍스트 행, 클릭·sticky 동작 없음 |
| `app/src/main/res/layout/item_dm_chat_opponent_message.xml` | 기존 시간 위치를 유지하며 오른쪽 시간 공간과 본문 폭 관계 조정 |
| `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatDateFormatterTest.kt` | 언어별 전체 날짜/요일과 상대 날짜 표현 배제 검증 |
| `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatTimelineTest.kt` | 날짜 projection, prepend 중복, identity, index와 anchor 계산 검증 |
| `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatMessageAdapterTest.kt` | 아이템 종류 분기, DiffUtil 동일성 및 stable ID 보존 검증. 레이아웃 속성 검증 없음 |
기술 선택은 사용자 제품 결정과 구분한 계획상의 선택이다. 신규 타입은 `DmChatTimeline.kt`에 함께 두고 별도의 공용 계층을 만들지 않는다.
- `fun formatDmChatDate(epochMillis: Long, locale: Locale, timeZone: TimeZone): String`: `DmChatDateFormatter.kt`의 formatter. 패턴은 ko `yyyy년 M월 d일 EEEE`, en `EEEE, MMMM d, yyyy`, ja `yyyy年M月d日EEEE`다.
- `sealed interface DmChatTimelineItem`: `DateHeader(val dateKey: String, val text: String)` 및 `Message(val item: DmChatMessageUiItem)` 두 data class를 중첩한다.
- `fun List<DmChatMessageUiItem>.toTimelineItems(locale: Locale, timeZone: TimeZone): List<DmChatTimelineItem>`: 입력 순서와 메시지 객체를 보존하며 날짜 행을 삽입한다. `dateKey`는 현지 Gregorian 연·월·일의 `yyyy-MM-dd` 키로, 표시 언어와 무관하다. 하루를 고정 24시간으로 나누어 계산하지 않는다.
- `sealed interface DmChatTimelineIdentity`: `DateHeader(val dateKey: String)`, `LocalMessage(val localId: String)`, `ServerMessage(val messageId: Long)`를 중첩한다. 메시지는 local ID가 있으면 이를 우선하며, 서버 조회 메시지는 message ID를 사용한다. 두 ID 모두 없는 메시지는 현재 ViewModel/mapper 계약상 생성되지 않는다.
- `fun DmChatTimelineItem.identity(): DmChatTimelineIdentity` 및 `fun List<DmChatTimelineItem>.positionOf(identity: DmChatTimelineIdentity): Int?`: 표시 아이템 동일성과 anchor 위치 검색에 공통 사용한다.
- `class DmChatTimelineStableIds`의 `fun idFor(identity: DmChatTimelineIdentity): Long`: adapter 인스턴스별 identity-ID 할당 상태. DiffUtil 비교는 identity와 전체 item 값으로 하고, UI 상태 변화가 identity를 변경하지 않게 한다.
- `fun isDmChatNearBottom(items: List<DmChatTimelineItem>, lastVisiblePosition: Int): Boolean`: 빈 목록이면 true, 그 밖에는 마지막 가시 위치 뒤의 메시지 행 개수가 2 미만인지 판단한다. 날짜 행은 개수에서 제외한다.
Activity는 첫 가시 메시지 identity와 top offset을 저장하고 prepend count event를 완료 신호로만 기억한다. 로딩 완료 Content를 `submitItems`에 제출한 뒤 `positionOf`로 새 position을 찾아 `RecyclerView.post`에서 같은 offset을 전달한다. 과거 페이지 로딩 시 anchor를 우선 보존하고, 일반 갱신에서만 near-bottom 하단 이동을 적용한다. 이 순서 선택은 ViewModel의 count LiveData 계약을 바꾸지 않으면서 기존 스크롤 의도를 보존하기 위한 것이다.
## Phase 1
**Phase 결과:** 날짜가 있는 표시 목록과 안정된 메시지 표시/스크롤, 시간 공간이 확보된 수신 말풍선이 기존 DM 정책을 보존한다.
**선행조건:** 이 계획의 제품 구현 착수 승인. 제품 정책의 재결정은 필요하지 않다.
**Phase 완료 조건:** `P1-T1`~`P1-T3` 및 후속 `P1-R1` 완료, `P1-GATE`의 실제 결과와 제한사항 기록. 최초 구현 체크박스는 미체크 상태로 시작했으며 실제 완료에 따라 갱신했다.
### 구현 항목
#### Task 1.1 날짜 formatter와 timeline projection
**Goal 실행 `P1-T1`:** 고정된 언어·시간대 입력에 대해 모든 메시지 날짜를 빠짐없이 그룹화한 UI 표시 목록을 제공한다.
- **시작 조건:** 구현 승인 및 PRD `DM-DATE-001`~`DM-DATE-004` 확인.
- **완료 증거:** formatter/projection 로컬 테스트가 모두 통과하고 ViewModel 메시지 목록을 변형하지 않는다.
- **범위 밖:** Activity/adapter 통합, locale 저장 정책 변경, ViewModel/API 변경.
**Files:**
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatDateFormatter.kt`
- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatTimeline.kt`
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatDateFormatterTest.kt`
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatTimelineTest.kt`
**Interfaces:**
- Consumes: `DmChatMessageUiItem.createdAt`, 기존 `sortByCreatedAtAndMessageId()` 결과, `Locale`, `TimeZone`.
- Produces: 위에 명시한 `formatDmChatDate`, `DmChatTimelineItem`, `toTimelineItems`. 날짜 키는 기기 현지 날짜를 식별하고 header는 앱 언어별 텍스트를 가진다.
- [x] **RED:** ko/en/ja 날짜·요일, 첫 메시지·자정·빈 목록·동일 epoch의 시간대 차이·DST·같은 날짜 prepend·연도 경계·원본 객체/순서/상태 보존 테스트 18개를 추가했다. 고정 시각과 시간대를 사용한다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.DmChatDateFormatterTest" --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.DmChatTimelineTest"`에서 컴파일 후 18개 중 17개 assertion 실패를 확인했다. 빈 목록 1개는 초기 구현에서도 통과했다.
- [x] **GREEN:** 명시적인 Locale/TimeZone, GregorianCalendar와 호출별 formatter 재사용으로 날짜 문자열과 표시 목록을 구현했다.
- [x] **GREEN 확인:** 같은 focused 테스트 18/18 통과와 실패·오류·skip 0을 확인했다.
- [x] **REFACTOR:** 중복 formatter 생성 방식을 공유하고 focused 테스트를 재실행했다. DM 패키지 125/125 통과 및 부모 독립 focused 재실행 성공을 확인했다.
**검증 기록(구현 시 누적):** 명령, 실제 assertion 실패/성공, 확인한 날짜 문자열 및 timezone 입력을 기록한다. 계획 작성 단계에는 실행 결과가 없다.
### P1-T1 검증 기록 — 2026-10-16
- 무엇을: 날짜 formatter와 timeline 모델 제품 파일 2개, local test 2개를 추가했다. ViewModel/메시지/API는 변경하지 않았다.
- 왜: 앱 언어·기기 현지 날짜에 따라 대화 날짜를 구분하기 위해서다.
- 어떻게: focused 명령 RED exit 1(17 assertion 실패) → GREEN exit 0(18개), `:app:compileDebugKotlin :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.*"` exit 0(125개). 부모도 focused 테스트를 독립 재실행해 `BUILD SUCCESSFUL in 13s`를 확인했다.
- 실행 표면: 실제 컴파일된 Kotlin formatter/projection을 Java driver로 호출해 서울 연도 경계의 일본어 날짜 행과 한국어 날짜, 메시지 원본 참조 보존을 확인했다.
- 한계: LSP 진단 도구가 없어 Kotlin 컴파일로 검증했으며 UI 연동은 P1-T2에서 수행한다.
#### Task 1.2 Adapter, Activity 및 prepend 스크롤 identity 통합
**Goal 실행 `P1-T2`:** 날짜 헤더를 adapter 목록에 렌더링하면서 메시지 identity, 기존 near-bottom 동작과 prepend 시 가시 메시지 위치를 유지한다.
- **시작 조건:** `P1-T1` 완료.
- **완료 증거:** timeline identity/index/anchor focused tests와 Activity/adapter DM regression tests가 통과한다.
- **범위 밖:** ViewModel prepend count 의미 수정, 네트워크 pagination 변경, sticky header.
**Files:**
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatTimeline.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/ui/DmChatMessageAdapter.kt`
- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivity.kt`
- Create if needed: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatScrollState.kt` — 실제 Activity가 사용하는 최소 prepend 상태 전이 로직. 소스 문자열 검사만으로 검증하지 않기 위한 경계이며 일반화된 controller는 만들지 않는다.
- Test if created: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatScrollStateTest.kt` — 요청/로딩/count/완료/실패/빈 결과 상태 전이 검증.
- Create: `app/src/main/res/layout/item_dm_chat_date_header.xml`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatTimelineTest.kt`
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatMessageAdapterTest.kt`
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivitySourceTest.kt` only if a behavior/wiring assertion genuinely needs alignment; preserve current layout and formatter import assertions.
**Interfaces:**
- Consumes: `P1-T1` `DmChatTimelineItem` projection; `DmChatRoomUiState.Content.messages`; existing `prependedMessageCountLiveData` and existing adapter message retry callback.
- Produces: `DmChatMessageAdapter.submitItems(newItems: List<DmChatTimelineItem>)`, `identity`, `positionOf`, `DmChatTimelineStableIds`, `isDmChatNearBottom`; header/my/opponent view type 분기와 새 Content 제출 후 Activity anchor 복원. 날짜 view type은 기존 1/2와 겹치지 않는 3을 사용하고 `item_dm_chat_date_header.xml`의 날짜 TextView를 bind한다.
- [x] **RED:** timeline 위치·자정 ACK·near-bottom·첫 가시 메시지, adapter view type/stable ID/DiffUtil, 실제 production scroll helper의 요청/로딩/count/완료/사용자 이동 테스트를 추가했다. 레이아웃 속성 테스트는 추가하지 않았다.
- [x] **RED 확인:** timeline/scroll/adapter/ActivitySource focused 명령에서 최소 scaffold 상태 41개 중 22개 실패를 확인했다. 기존 source 5개는 통과했다. 이후 요청 불가 시 anchor 수집 금지 테스트도 13개 중 1개 실패를 확인했다.
- [x] **GREEN:** 날짜 행과 typed identity/stable ID를 통합하고 실제 Activity가 사용하는 최소 `DmChatScrollState`로 Content 제출 후 복원·실패/빈 결과 해제·사용자 이동 무효화를 구현했다.
- [x] **GREEN 확인:** timeline/scroll/adapter/ActivitySource/pagination/mapper 집중 52개 및 DM 전체 151개가 실패·오류·skip 없이 통과했다.
- [x] **REFACTOR:** 부모가 신규 코드의 ktlint 줄바꿈 오류 6곳만 정리하고 `:app:ktlintCheck` 성공을 확인했다. 기존 ActivitySource assertion은 수정하거나 약화하지 않았다.
**검증 기록(구현 시 누적):** focused command 출력과 기존 source test 변경 여부, pagination/anchor/near-bottom 사례를 기록한다. 기존 layout assertion이나 formatter import assertion은 제거·약화하지 않는다.
### P1-T2 검증 기록 — 2026-10-16
- 무엇을: Activity, adapter, timeline, 날짜 XML, scroll helper 및 세 local test 파일을 연결했다. 기존 메시지/시간/retry binding은 유지했다.
- 왜: 날짜 행의 추가로 달라진 표시 위치를 원본 메시지 index와 혼동하지 않고 pending→ACK identity와 읽던 위치를 보존해야 한다.
- 어떻게: `:app:compileDebugKotlin :app:processDebugResources :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.main.chat.dm.*'` exit 0, 151개 통과. RED/GREEN 로그와 실제 변경 파일을 부모가 직접 대조했다. 전체 테스트 실행에서도 DM 151개는 모두 통과했다.
- 추가 발견: 독립 리뷰에서 lifecycle 재활성화 시 observer 재전달 순서 결함 DM-GATE-01을 확인했다. 기존 완료 Task는 되돌리지 않고 신규 P1-R1로 수정한다.
#### Task 1.3 수신 메시지 XML 시간 공간 확보
**Goal 실행 `P1-T3`:** 시간 표시를 말풍선 오른쪽 하단 바깥에 유지하면서 수신 본문이 시간 공간과 겹치지 않도록 XML 구조를 제한한다.
- **시작 조건:** PRD `DM-TIME-001` 및 현재 `item_dm_chat_opponent_message.xml` 구조 확인.
- **완료 증거:** XML 자원이 컴파일되고 lint가 통과하며 기존 위치/제약과 변경 의도가 정적 구조에서 확인된다.
- **범위 밖:** 시간 재배치, 본문 잘라내기, 사용자인 척하는 시각적 확인.
- **TDD 예외 사유:** 요구사항은 XML 레이아웃 속성에만 적용되며 저장소 규칙상 레이아웃 크기/constraint 속성 테스트는 작성하지 않는다.
- **대체 검증 방법:** `:app:processDebugResources`, `:app:lintDebug` 실행 및 XML source inspection으로 `tv_time`의 기존 message_group 우측/하단 배치와 본문이 쓸 수 있는 제한 폭을 확인한다. 이 증거는 렌더링 또는 화면 넘침 해결을 직접 증명하지 않는다.
**Files:**
- Modify: `app/src/main/res/layout/item_dm_chat_opponent_message.xml`
- Verify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivitySourceTest.kt`의 기존 레이아웃 assertion 보존 여부
**Interfaces:** 기존 `message_group`, `tv_message`, `tv_time`과 adapter의 본문 최대 폭 설정을 소비한다. 화면 오른쪽 경계 안에서 시간의 실제 측정 공간을 확보하고 남은 폭 안에서 본문이 줄바꿈되는 constraint 관계를 제공한다. 고정 시간 폭이나 고정 글자 수로 시간을 잘라내지 않는다.
- [x] XML에 constrained-width/상호 연결/packed chain/parent end 제약 5개를 추가했다. 기존 속성·글꼴·색상·프로필·시간 위치는 유지했다.
- [x] 리소스 컴파일과 APK 생성 성공, 기존 ActivitySource 테스트 통과, `:app:lintDebug` 실행 결과를 기록했다. 전체 lint는 수정 밖 31개 오류로 실패했으며 변경 제품 파일의 lint 지적은 0개다.
- [x] XML 정적 대조와 `xmllint --noout` 성공을 확인했다. 실제 화면 시각 검증 PASS로 표시하지 않는다.
**검증 기록(구현 시 누적):** resource/lint 명령의 실제 결과와 정적 source inspection 범위를 기록한다. 런타임 렌더링은 확인되지 않은 상태로 남긴다.
### P1-T3 검증 기록 — 2026-10-16
- 무엇을: `item_dm_chat_opponent_message.xml` 속성 5개 추가로 부모 end padding 안에 실제 시간 폭을 확보하고 본문 그룹의 폭을 제한했다.
- 왜: 시간의 start 연결만 존재하던 기존 구조가 말풍선 오른쪽 화면 경계를 보장하지 못했기 때문이다.
- 어떻게: xmllint exit 0, `processDebugResources` 및 `assembleDebug` 성공, 독립 리뷰에서 정적 constraint의 추가 차단 결함 없음. lint report를 파싱해 변경 제품 파일 지적 0개 확인.
- 전체 lint 제한: `lintDebug` exit 1, 31 errors/793 warnings. 첫 오류는 기존 AndroidManifest.xml:346의 FacebookActivity MissingClass이며 다른 오류도 기존 media3 opt-in, NotSibling, UseAppTint, StringFormatMatches 등 수정 밖 경로다.
- 커밋: `1baf09af fix(dm): 긴 수신 메시지의 시간 공간을 확보한다`. 기기 미연결로 실제 렌더링은 확인하지 못했다.
#### Task 1.R1 백그라운드 복귀 prepend 복원
**Goal 실행 `P1-R1`:** DM-GATE-01을 수정해 lifecycle 재활성화에서도 count 신호가 완료 Content보다 먼저 처리되고 기존 메시지 anchor를 정확히 한 번 복원한다.
- **시작 조건:** `reviews/phase1-dm-date-timeline-review.md`의 확정 항목 DM-GATE-01.
- **대상 파일:** `DmChatRoomActivity.kt`의 observer 등록 순서, `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatScrollLifecycleTest.kt` 신규 및 기존 Activity source test의 비레이아웃 wiring 검증 보강.
- **범위:** count observer를 Content observer보다 먼저 등록한다. ViewModel/API 및 레거시는 변경하지 않는다.
- **완료 증거:** 실제 LiveData/LifecycleRegistry의 비활성→재활성 회귀 RED→GREEN, DM 영향 회귀, 독립 리뷰 델타.
- [x] **RED:** Activity 소스의 실제 등록 순서로 실제 MutableLiveData/LifecycleRegistry를 연결해 비활성 중 완료된 prepend의 복원 누락을 재현했다. stale count 및 실패/빈 결과도 검증했다.
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests '*DmChatScrollLifecycleTest' --tests '*DmChatRoomActivitySourceTest'`에서 8개 중 1개 실패. 기대 `[Position(position=2, top=-17)]`, 실제 `[]`였다.
- [x] **GREEN:** count observer를 Content observer 앞에 등록하는 순서 변경만 적용했다.
- [x] **GREEN 확인:** DM 전체 154개가 실패·오류·skip 없이 통과했다. 새 lifecycle 3개와 기존 source 5개도 포함한다.
- [x] **REFACTOR:** 테스트용 production hook을 만들지 않았으며 기존 테스트를 변경하지 않았다. 독립 Oracle 수정분 리뷰에서 DM-GATE-01 해결, APPROVE를 받았다.
### P1-R1 검증 기록 — 중단 후 재개
- 무엇을: `DmChatScrollLifecycleTest.kt` 3개 사례와 Activity observer 등록 순서를 수정했다.
- 왜: 비활성 owner의 LiveData 재전달은 ViewModel 발행 순서와 달리 observer 등록 순서에 영향을 받는다.
- 어떻게: old order RED 8개 중 1개 assertion 실패 → count-first GREEN DM154/154. `:app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.main.chat.dm.*' :app:assembleDebug :app:ktlintCheck` 성공 49초. 최종 `--max-workers=1` 재실행도 성공 20초.
- 리뷰: `reviews/phase1-dm-date-timeline-review.md` 수정분 APPROVE, 범위 내 남은 차단 사항 없음.
- 한계: Activity 소스에서 순서를 추출해 실제 LiveData로 검증한 최소 연결 테스트이며, 실제 Activity/RecyclerView 화면을 구동한 증거는 아니다.
### Phase 1 Gate
**Goal 실행 `P1-GATE`:** 문서 요구사항과 구현·테스트 근거가 모두 추적되는지 검증한다.
- **시작 조건:** `P1-T1`~`P1-T3` 구현 완료 상태. 문서 작성 단계에서는 실행하지 않는다.
- **완료 증거:** 아래 명령의 실제 결과, 요구사항별 테스트 근거, 레이아웃 검증 한계가 기록된다.
- **범위 밖:** 기존 테스트 삭제/완화, UI/계측 테스트, device/emulator 조작, screenshot/visual QA.
```bash
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.*"
./gradlew :app:processDebugResources
./gradlew :app:compileDebugKotlin :app:ktlintCheck
./gradlew :app:lintDebug
```
**Expected:** 날짜 언어/시간대/그룹/빈 목록과 prepend/identity 로직 local tests 통과, 기존 DM 회귀 테스트 보존 및 통과, Android resource/Kotlin compilation과 ktlint/lint 성공. 기존 무관한 실패는 이번 수정에 포함하지 않고 별도 기록한다. XML 검증의 한계는 해결된 시각적 결함으로 주장하지 않고 명시한다. 공통 경계를 변경하지 않으므로 전체 앱 테스트 대신 DM 패키지 회귀를 실행하고 생략 근거를 기록한다.
### 완료 조건
- [x] `P1-T1`, `P1-T2`, `P1-T3`, `P1-R1` 구현과 검증 기록을 완료했다.
- [x] PRD의 `DM-DATE-001`~`004`, `DM-TIME-001`를 각각 Task와 실제 검증 증거에 연결했다.
- [x] `DmChatRoomViewModel`, API/socket 및 레거시를 변경하지 않았다.
- [x] 기존 source test를 수정하거나 약화하지 않았다.
- [x] 실제 기기 미연결과 전체 suite/lint 실패를 검증 제한으로 기록했다. Gate가 모두 녹색이라고 주장하지 않는다.
## 실행 순서와 의존성
| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|---:|---|---|---|---|
| 1 | `P1-T1` | 구현 승인 | 아니요 | API/제품 결정을 임의 변경하지 않고 근거 확인 |
| 2 | `P1-T2` | `P1-T1` | 아니요 | anchor identity를 순수 로직으로 먼저 고정 |
| 3 | `P1-T3` | 정책 및 XML 근거 확인 | `P1-T2`와 독립 가능 | source assertion 충돌을 기록하고 기존 테스트 보존 |
| 4 | `P1-R1` | 독립 리뷰 DM-GATE-01 | 아니요 | lifecycle 재전달 회귀를 재현하고 최소 수정 |
| 5 | `P1-GATE` | Task 1.1~1.3 및 P1-R1 | 아니요 | 실패한 Task의 구현 증거 및 범위 밖 검증 제한을 기록 |
```text
P1-T1 → P1-T2 ─┐
├→ 독립 리뷰 → P1-R1 → P1-GATE
P1-T3 ──────────┘
```
## 변경 금지 항목
- PRD Decision Log의 기존 DEC-001~DEC-007 및 사용자 결정은 삭제·정정하지 않는다.
- 날짜 정책을 Today/Yesterday, device country, sticky header로 바꾸지 않는다.
- ViewModel/API/socket의 pagination/정렬/ACK 동작을 날짜 표시 목적으로 변경하지 않는다.
- prepend event의 message count에 header 개수를 더해 position을 추정하지 않는다.
- 테스트를 삭제·skip·완화하거나 XML 속성 테스트를 추가하지 않는다.
- 요청되지 않은 dependency와 API contract를 만들지 않는다. 코드 리뷰를 별도로 수행하게 되면 저장소 규칙에 따라 리뷰 기록을 남긴다.
## Decision Log
| 날짜 | ID | 상태 | 결정 | 근거·영향 |
|---|---|---|---|---|
| 2026-10-16 | PLAN-001 | 확정 | 제품 정책은 PRD DEC-001~DEC-007을 따르고 이번에는 두 문서만 작성한다. | 사용자 인터뷰, 모든 Task는 구현 대기 |
| 2026-10-16 | TECH-001 | 계획 선택 | 표시 목록과 원본 메시지 목록을 분리하고 typed identity별 stable ID를 adapter 수명 안에서 할당한다. | 날짜 아이템 추가에 따른 기존 인덱스·ID 충돌 방지, P1-T1/P1-T2 |
| 2026-10-16 | TECH-002 | 계획 선택 | 과거 페이지는 완료 Content 제출 후 메시지 anchor로 복원하고 일반 갱신에만 near-bottom 자동 이동을 적용한다. | count event가 Content보다 먼저 발생하는 현재 코드와 날짜 행 추가에 대응, P1-T2 |
| 2026-10-16 | PLAN-002 | 정정 | 사용자의 문서대로 구현 요청에 따라 구현·검증을 시작한다. 문서 전용 제한은 최초 단계에만 해당한다. | PRD DEC-008 |
| 2026-10-16 | PLAN-003 | 실행 선택 | 기존 workspace에서 새 로컬 브랜치 `feat/dm-date-separators`로 작업한다. 작업별 임시 디렉터리를 분리하고 기존 파일·캐시를 되돌리거나 정리하지 않는다. | 최소 변경 및 기존 미추적 문서 보존 |
| 2026-10-16 | TECH-003 | 계획 보완 | Activity에서 사용할 최소 prepend 상태 helper와 local test를 P1-T2 범위에 허용한다. 입력/출력 상태 전이만 검증하고 View 크기·constraint 검사는 추가하지 않는다. | 기존 source test만으로 count 선행/로딩 중 갱신을 검증할 수 없음 |
사용자 결정과 기술 선택을 구분한다. 결정 변경 시 기존 행을 지우지 않고 정정 기록을 추가하며 관련 Task를 먼저 갱신한다.
## Progress
최초 문서 단계 기록: 당시 구현은 승인되지 않았고 수행하지 않았다. 당시 체크박스는 전부 미완료였으며 제품 테스트와 빌드는 실행하지 않았다.
후속 구현 단계: 사용자 승인으로 P1-T1~P1-T3 및 리뷰 회귀 P1-R1을 완료했다. 아래 Verification Log는 최초 문서 기록을 유지하면서 실제 구현 결과를 누적한다.
## Verification Log
- 문서 일관성: PRD의 DEC-001~DEC-007 유지, 요구사항-Task 연결, 파일 경로, future checkbox 미체크 상태를 대조했다. 구현 범위는 두 문서로 한정했다.
- Gradle task 존재 확인: 2026-10-16 lead가 저장소 루트에서 `./gradlew tasks --all`을 실행했다. exit 0, `BUILD SUCCESSFUL in 19s`, `1 actionable task: 1 executed`를 확인했다. `app:testDebugUnitTest`, `app:processDebugResources`, `app:compileDebugKotlin`, `app:ktlintCheck`, `app:lintDebug`가 등록돼 있다. 기존 Gradle deprecation 경고가 출력됐다. 이는 명령 등록 확인이며 제품 빌드·테스트·린트 통과를 의미하지 않는다.
- 미래 구현 검증: 위 Task와 Gate의 Gradle 명령은 계획된 실행 명령이며 이번에 테스트·빌드하지 않았다.
- 시각 검증 제한: layout-only 변경은 XML compilation/lint/static inspection만 계획한다. 실제 화면 렌더링·기기 넘침 검증은 미수행으로 기록한다.
- 요구사항 읽기 전용 점검: 최초 점검 세션은 지원되지 않는 모델 오류로 결과를 내지 못했다. 지원되는 모델로 새 점검을 수행해 중요한 미해결 제품 질문이 없음을 확인했다. 제품 코드 리뷰는 수행하지 않았다.
- 최종 문서 대조: 일본어 formatter 패턴을 수용 예시와 일치시켰고 날짜 행 XML 경로·표시 인터페이스·스크롤 로딩/완료 처리·Kotlin 및 ktlint 검증 명령을 보완했다. 제품 코드와 구현 체크박스는 변경하지 않았다.
- 변경 범위·문서 공백 검사: `git status --short --untracked-files=all`에서 이 폴더의 `prd.md`, `plan-task.md` 두 신규 문서만 확인했다. 각 파일에 `git diff --no-index --check /dev/null 문서경로`를 실행해 exit 0과 공백 오류 없음 출력을 확인했다. 미래 구현 완료 체크박스와 미해결 제품 질문이 없음을 문서 내용과 검색 결과로 대조했다.
### 구현 최종 검증
- 변경 전 DM baseline: 107개 통과. T1 후 125개, T2 후 151개, lifecycle 회귀 수정 후 최종 154개 통과. 기존 테스트의 삭제·skip·완화 없음.
- 최종 성공 명령: `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.main.chat.dm.*' :app:assembleDebug :app:ktlintCheck --max-workers=1 --console=plain` → `BUILD SUCCESSFUL in 20s`, DM154개, failures/errors/skipped 모두 0.
- 산출물: `app/build/outputs/apk/debug/app-debug.apk` 생성 확인. 리소스·Kotlin 컴파일과 ktlint 통과.
- 실행 표면: 실제 debug Kotlin classes를 임시 Java 드라이버로 직접 호출해 현지 자정/일본어 날짜/한국어 전체 날짜, loading 동안 anchor 유지, 완료 목록 position=3 및 offset=-17 복원 1회, stable ID 분리를 확인했다. 이는 실제 화면 검증이 아니다.
- 전체 suite 1차: `:app:testDebugUnitTest` 1,601개 중 1개 실패. 변경하지 않은 `V2AuthFlowTest`의 `디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다`, 844행 `isAdultContentVisible` assertion이다.
- 전체 suite 재실행: Gradle Test Executor 5가 exit 1로 종료되어 전체 통과 증거를 확보하지 못했다. 남은 이전 XML을 이번 전체 결과로 집계하지 않았다.
- 인증 실패 분리 실행: `./gradlew :app:testDebugUnitTest --tests '*V2AuthFlowTest' --max-workers=1 --console=plain` → 29개 중 같은 테스트 1개가 같은 844행에서 실패, 53초. DM 테스트를 실행하지 않아도 재현되며 범위 밖 인증 코드는 수정하지 않았다.
- Android lint: `:app:lintDebug` → 31 errors/793 warnings로 실패. 재실행도 동일하다. 최초 오류 AndroidManifest.xml:346 FacebookActivity MissingClass 외 media3 opt-in/NotSibling/UseAppTint/StringFormatMatches가 기존 수정 밖 파일에서 발생했다. XML report 기준 이번 변경 제품 파일의 lint 지적은 0개다. 임의 baseline/suppression을 추가하지 않았다.
- 통합 검증 최초 명령은 lint 분석 중 10분 도구 제한에 걸렸다. 이후 명령을 나누고 재실행해 위의 개별 결과를 확인했다.
- 독립 리뷰: 최초 DM-GATE-01을 P1-R1로 수정한 후 delta review APPROVE. 코드 범위 차단 사항 없음.
- **[blocked] 실제 기기 QA:** `adb devices -l`에 연결 기기가 없었다. 기기·에뮬레이터 UI/스크린샷/계측 테스트는 수행하지 않았고 화면 넘침 해결을 시각적으로 확증하지 못했다.
- **[blocked] LSP:** `lsp_diagnostics` 도구/실행 파일이 제공되지 않아 Kotlin 컴파일과 ktlint로 대체 확인했다.
- **[blocked] 전체 녹색 Gate:** 범위 밖 인증 실패와 기존 Android lint 오류가 남아 있다. DM 구현 완료와 저장소 전체 검증 통과를 구분한다.
- 기능 커밋: `1baf09af` 수신 시간 공간, `d506672b` 현지화 날짜 formatter, `ad6e7b97` timeline/scroll 상태, `5637a0ac` 화면 연결/lifecycle 회귀. 모든 커밋 메시지 검사 통과. push/merge는 수행하지 않는다.
- 임시 자원 정리: 소유 실행 root `dm-impl.Ablr1D`, `dm-p1t1.QDTCMR`, `dm-p1t2.WNBmGb`, `p1-t3-xml.VzDXts`와 ULW 임시 메모를 삭제하고 각 경로가 존재하지 않음을 확인했다. 실행 중인 소유 worker가 없음을 확인한 뒤 정리했으며 공유 Gradle 캐시·daemon, 다른 작업 폴더, APK 및 저장소 테스트 보고서는 유지했다. 임시 로그의 핵심 명령·실패·성공 증거는 이 문서와 리뷰에 보존했다.
@@ -0,0 +1,159 @@
# DM 날짜 구분선과 수신 시간 표시 PRD
## 문서 정보
| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 완료, DM 회귀 통과. 전체 검사·실제 기기 검증 제한은 계획의 Verification Log 참조 |
| 작성일 | 2026-10-16 |
| 최종 수정일 | 2026-10-16 |
| 대상 제품 | Android 유저-크리에이터 DM 채팅방 |
| 작성자·결정권자 | 작성: 에이전트 / 제품 결정: 사용자 |
| 관련 API Contract | 이번 요청에서 API 변경 요구 없음. 기존 `docs/20260610_DM_채팅화면/prd.md` 참고 |
| 관련 구현 계획 | 같은 폴더의 `plan-task.md` |
| 관련 review | `reviews/phase1-dm-date-timeline-review.md` |
## 1. Overview
유저-크리에이터 DM 대화 중간에 날짜 아이템을 추가해 메시지가 어느 날짜의 대화인지 알 수 있게 한다. 날짜 표기는 앱 언어 설정에 따른 형식을 사용하고 날짜 경계는 사용자 기기의 현지 시간대를 기준으로 한다. 긴 수신 메시지에서 시간이 화면 밖으로 벗어나는 문제도 해결한다.
최초 요청은 문서 작성만 수행하는 것이었으며 이를 완료했다. 이후 사용자 요청 `문서대로 구현 진행`으로 아래 확정 정책의 구현이 승인됐다. 기존 문서 단계의 기록은 유지하고 구현·검증 결과를 추가한다.
## 2. Problem Statement
- 사용자 보고: 대화에 날짜가 표시되지 않아 메시지를 주고받은 날짜를 파악하기 어렵다.
- 사용자 보고: 받은 메시지가 길어지면 받은 시간이 화면 밖으로 벗어난다.
- 코드 확인: `DmChatMessageAdapter`에는 내 메시지와 상대 메시지 두 종류만 있고 날짜 아이템은 없다.
- 코드 확인: 수신 레이아웃의 `message_group`은 오른쪽 경계 제약이 없고, `tv_time`은 그 그룹의 오른쪽에 연결되어 있다. 말풍선 본문 최대 폭은 어댑터에서 디스플레이 폭의 68%로 설정한다.
- 위 내용은 정적 코드 확인 결과이며 기기에서 재현하거나 런타임 원인을 확정한 결과가 아니다.
## 3. Goals
- 날짜 아이템으로 대화 날짜를 구분한다.
- 앱 언어 설정에 맞는 날짜 형식을 제공한다.
- 긴 수신 메시지에서도 시간을 메시지와 함께 읽을 수 있도록 한다.
- 인터뷰 결정, 수용 기준, 구현 대상, 검증 방법을 문서로 연결한다.
## 4. Non-Goals
- 이번 문서 작성 단계에서 제품 코드·레이아웃·테스트 코드 수정 및 기능 구현.
- AI 캐릭터 채팅방, 라이브 채팅, 대화방 목록 화면의 기능·디자인 변경.
- 메시지 송수신 프로토콜, 서버 API, 읽음·재전송 정책 변경.
- 신규 의존성 추가, 레거시 공통 코드 수정.
- 기기·에뮬레이터 UI 조작, UI/계측 테스트, 스크린샷 및 시각 QA.
## 5. 대상과 기존 맥락
- 대상 사용자: 유저-크리에이터 DM에 참여하는 사용자와 크리에이터.
- 대상 화면: `DmChatRoomActivity`.
- 메시지 데이터: `DmChatMessageUiItem.createdAt: Long`.
- 정렬: 현재 mapper는 `createdAt`, 같은 시각이면 `messageId` 순으로 정렬한다.
- 목록 동작: 초기 메시지 조회, 과거 메시지 prepend, 실시간 메시지 반영, 전송 상태가 존재한다. 날짜 아이템 추가 계획에서는 이 동작을 보존해야 한다.
- 스크롤: 현재 Activity는 메시지 개수와 위치를 사용해 하단 이동 및 과거 메시지 추가 후 위치 복원을 수행한다. 날짜 아이템 개수를 포함한 표시 목록과 원본 메시지 목록의 위치 차이를 계획에서 다뤄야 한다.
- 언어 설정: `LanguageManager`는 앱 선택 언어를 우선 사용하고 한국어·영어·일본어를 지원한다. `LocaleHelper`는 `Locale(code)`를 적용하므로 이 경로에는 국가 코드가 없다.
## 6. 구현 범위와 제약
- 화면은 유저-크리에이터 `DmChatRoomActivity`에 한정한다.
- `createdAt`은 epoch milliseconds이며 기존 오름차순 정렬과 중복 제거를 유지한다.
- 앱 표시 언어는 `LanguageManager`의 유효 언어 코드 `ko`, `en`, `ja`를 이용한다. 기기 시간대는 날짜 경계를 결정하며, 기기 국가 코드를 앱의 날짜 언어로 취급하지 않는다.
- 표시 날짜는 메시지의 `createdAt`을 표시 목록 생성 시점의 기기 현지 시간대로 변환한 날짜다. 원본 timestamp는 변경하지 않는다. 시간대 변경을 즉시 감지하는 별도 listener는 추가하지 않는다.
- 날짜 구분선은 목록의 일반 아이템이며 sticky header가 아니다.
- 날짜 구분선은 UI 표시 목록에만 존재한다. ViewModel의 메시지 목록, 페이지 cursor, 서버 요청과 socket 계약은 바꾸지 않는다.
- 수신 메시지 시간은 말풍선 오른쪽 하단 바깥에 둔다. 기존 메시지 레이아웃 수정은 상대 메시지 항목에 한정하며, 날짜 아이템 레이아웃은 별도로 추가한다.
## 7. 수용 시나리오
1. 같은 현지 날짜의 연속 메시지는 첫 메시지 앞에만 날짜 아이템이 있고, 날짜 경계를 넘은 첫 메시지 앞에 새 날짜 아이템이 있다.
2. 목록 첫 메시지가 불러온 페이지의 중간 날짜에서 시작해도 그 첫 메시지 앞에는 날짜 아이템이 있다. 빈 메시지 목록은 빈 표시 목록이다.
3. 과거 페이지가 기존 첫 메시지와 같은 현지 날짜로 이어지면 해당 날짜에 새 구분선을 추가하지 않는다. 다른 날짜로 이어지면 그 날짜의 첫 메시지 앞에만 추가한다.
4. 앱 언어가 한국어, 영어, 일본어일 때 각각 해당 언어의 자연스러운 연·월·일·요일 표기를 사용한다. 앱 언어와 기기 언어·국가가 달라도 앱 언어가 우선한다.
5. 자정 전후의 epoch 시각을 기기 현지 시간대로 해석해 다른 날짜면 분리하고, 동일한 epoch 값을 다른 시간대로 해석했을 때 현지 날짜가 달라지면 그 날짜를 따른다.
6. 긴 수신 본문은 시간 표시 공간을 남기고 줄바꿈된다. 시간은 기존처럼 말풍선 우측 하단 바깥에 있으며, 본문이나 시간이 잘리거나 겹치지 않는 레이아웃 구조를 만든다. 실제 기기 시각 검증은 문서 작업 범위 밖이다.
7. 과거 페이지 추가 중 기존에 보이던 메시지가 새 목록에 남아 있으면 그 메시지 identity와 기존 상단 픽셀 오프셋을 유지한다. 과거 메시지 추가가 아닌 일반 메시지 갱신에서는 기존 near-bottom 정책에 따라 하단을 따른다. 이 구분은 날짜 아이템으로 기존 스크롤 의도가 바뀌지 않게 하는 계획상의 보존 기준이다.
## 8. 기능 요구사항
| ID | 상태 | 요구사항 | 수용 기준 | 연결 |
|---|---|---|---|---|
| DM-DATE-001 | 확정 | 현재 표시되는 대화의 첫 메시지 앞과 현지 날짜가 바뀐 첫 메시지 앞에 날짜 아이템을 표시한다. | 같은 날짜 메시지 사이에는 반복 표시하지 않는다. 과거 메시지를 추가로 불러와 같은 날짜가 이어질 때 구분선이 중복되지 않는다. 메시지가 없으면 날짜 아이템도 없다. | DEC-007, OQ-003, P1-T1 |
| DM-DATE-002 | 확정 | 날짜 형식은 앱 언어 설정을 따른다. 기기의 언어·국가 설정을 독립적인 날짜 형식 기준으로 사용하지 않는다. | 앱 언어 ko/en/ja를 각각 사용하며 기기 언어가 영어이고 앱 언어가 일본어이면 일본어 날짜 형식을 사용한다. 표시 구성은 DM-DATE-004를 따른다. | DEC-003, DM-DATE-004, P1-T1 |
| DM-DATE-003 | 확정 | 날짜 구분과 날짜 표기는 사용자 기기의 현지 시간대를 기준으로 한다. | 메시지 시각을 기기 현지 시간대로 해석한 날짜를 사용하고, 현지 날짜가 자정을 넘어 달라지면 서로 다른 날짜로 구분한다. 동일한 메시지도 기기 시간대에 따라 날짜가 다를 수 있다. | DEC-004, OQ-002, P1-T1 |
| DM-DATE-004 | 확정 | 날짜 아이템은 항상 연·월·일과 요일을 표시하고 오늘·어제 같은 상대 날짜 표현은 사용하지 않는다. | 한국어 예시는 `2026년 10월 16일 금요일`이며 다른 앱 언어는 해당 언어의 자연스러운 형식을 사용한다. 올해 날짜도 연도를 생략하지 않는다. | DEC-005, OQ-003, P1-T1 |
| DM-TIME-001 | 확정 | 긴 수신 메시지에서도 받은 시간이 화면 밖으로 벗어나지 않게 한다. 시간은 기존처럼 말풍선 오른쪽 하단 바깥에 유지하며, 시간 표시 공간을 먼저 확보하고 긴 본문을 줄바꿈한다. | 시간과 본문이 겹치거나 화면 밖으로 잘리지 않는다. 시간을 말풍선 아래로 옮기지 않으며 본문을 생략하는 방식으로 해결하지 않는다. | DEC-006, OQ-004, P1-T3 |
| DM-DOC-001 | 완료 | 최초 단계에서는 인터뷰 및 문서 작성만 수행한다. 이후 별도 사용자 승인에 따라 구현 단계로 전환한다. | 문서 단계에서 코드 변경이 없었으며 구현은 DEC-008 이후 수행한다. | DEC-008 |
## 9. 성능과 품질 요구사항
- 날짜 아이템 때문에 메시지 중복 제거, 정렬, 전송 상태, 과거 메시지 조회 및 스크롤 정책이 바뀌지 않도록 구현 계획에 회귀 범위를 포함한다.
- 향후 자동 검증은 `app/src/test`의 날짜 그룹화·현지화 formatter·표시 모델·adapter 분기 등 로직 단일 테스트를 대상으로 한다.
- View 크기·간격·constraint·visibility 등 레이아웃 속성을 직접 검증하는 자동 테스트는 계획하지 않는다.
- 문서 작성 단계에서는 제품 테스트 및 빌드를 실행해 기능 완료를 주장하지 않는다.
## 10. 성공 기준
- [x] 같은 현지 날짜는 한 구분선으로 묶이고 날짜 경계와 첫 메시지에 구분선이 생성된다. 빈 목록은 비어 있다. projection과 adapter 분기 테스트로 확인했다. (`DM-DATE-001`)
- [x] 앱 언어 ko/en/ja에 맞는 연도 포함 날짜·요일, 오늘/어제 미사용을 formatter 테스트로 확인했다. (`DM-DATE-002`, `DM-DATE-004`)
- [x] 기기 현지 timezone 입력에 대한 자정·DST·연도 경계 테스트를 통과했다. (`DM-DATE-003`)
- [x] identity, pending→ACK stable ID, near-bottom 및 prepend anchor 로직을 검증했다. lifecycle 복귀 회귀는 P1-R1에서 RED→GREEN으로 확인했다. 실제 기기 스크롤 검증과는 구분한다. (`DM-DATE-001`)
- [x] 수신 시간 공간 확보와 기존 위치 보존을 XML 구조·리소스 컴파일·독립 코드 리뷰로 확인했다. 실제 렌더링은 기기 미연결로 미확인이다. (`DM-TIME-001`)
- [x] 기존 `DmChatRoomActivitySourceTest`를 수정하거나 약화하지 않고 통과했다.
- [x] DM 로직 단위 테스트 154개가 실패·오류·skip 없이 통과했다. UI/계측 테스트는 추가하지 않았다.
**[blocked] 실제 기기 수용 검증:** 연결된 Android 기기가 없어 긴 수신 메시지의 실제 넘침 여부와 화면 스크롤을 확인하지 못했다. 위 체크는 구현 및 명시한 로직/정적 검증 완료를 뜻하며 시각 QA 통과가 아니다.
## 11. 요구사항 추적표
| 요구사항 | 계획 Task | 향후 자동 검증 | 최종 판정 |
|---|---|---|---|
| `DM-DATE-001`~`004` | `P1-T1`, `P1-T2` | 날짜 formatter/projection 및 timeline identity 테스트 | `P1-GATE` |
| `DM-TIME-001` | `P1-T3` | XML 리소스 컴파일, lint와 정적 소스 대조. 레이아웃 속성 테스트 없음 | `P1-GATE`; 실제 화면 검증은 미수행으로 기록 |
| `DM-DOC-001` | 본 문서 작업 | 두 문서의 경로·요구사항·체크박스 일관성 확인 | 이번 작업 완료 |
## 12. Open Questions
| ID | 상태 | 결정 필요 사항 | 현재 권고 | 결정 주체 | 결정 시점 |
|---|---|---|---|---|---|
| OQ-001 | 해결 | 날짜 형식의 언어·국가 기준 | 사용자 확정: 앱 언어 설정에 따른다. 초기 권고를 확정한 것이 아니라 사용자 답변을 기준으로 결정했다. | 사용자 | 인터뷰 답변 반영 완료 |
| OQ-002 | 해결 | 날짜를 나누는 시간대 기준 | 사용자 확정: 사용자 기기의 현지 시간대를 기준으로 한다. | 사용자 | 인터뷰 답변 반영 완료 |
| OQ-003 | 해결 | 날짜 아이템 삽입 위치, 첫 메시지 앞 표시, 연도·요일 포함 여부 및 오늘/어제 사용 여부 | 사용자 확정: 항상 연·월·일과 요일 표시, 오늘·어제 미사용. 현재 불러온 첫 메시지 앞과 날짜가 바뀐 첫 메시지 앞에 삽입하며 과거 메시지 추가 시 같은 날짜 구분선 중복을 방지한다. | 사용자 | 인터뷰 답변 반영 완료 |
| OQ-004 | 해결 | 긴 수신 메시지의 시간 배치 | 사용자 확정: 기존 말풍선 오른쪽 하단 바깥 배치를 유지하고, 시간 공간을 먼저 확보한 뒤 긴 본문을 줄바꿈한다. | 사용자 | 인터뷰 답변 반영 완료 |
열린 제품 질문은 없다. 구현 계획의 기술 선택은 사용자 결정과 구분해 기록하며, 요청 범위를 바꾸는 새로운 결정이 필요하면 구현 전에 확인한다.
### 인터뷰 종료 평가
- 최종 모호성: 0.03.
- 차원별 명확성: 목표 1.00, 범위 1.00, 제약 1.00, 완료 기준 0.90, 기존 맥락 0.95. 가중 합산 모호성은 0.0275이며 소수 둘째 자리로 반올림했다.
- 남은 검증 한계: 실제 기기에서의 시간 넘침 재현 및 수정 결과 확인은 이번 문서 작성 범위가 아니다.
## 13. Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 |
|---|---|---|---|---|---|
| 2026-10-16 | DEC-001 | 확정 | 날짜 아이템 추가와 긴 수신 메시지 시간 표시 개선을 문서화한다. 모호한 사항은 인터뷰한다. | 사용자 요청 | DM-DATE-001, DM-DATE-002, DM-TIME-001 |
| 2026-10-16 | DEC-002 | 확정 | 이번 작업은 문서 작성만 수행하고 구현하지 않는다. | 사용자 명시 지시 | DM-DOC-001 |
| 2026-10-16 | DEC-003 | 확정 | 날짜 형식은 앱 언어 설정을 따른다. | 사용자 인터뷰: "앱 언어 설정에 따른다." | DM-DATE-002, OQ-001 |
| 2026-10-16 | DEC-004 | 확정 | 날짜 경계와 날짜 표기는 사용자 기기의 현지 시간대를 기준으로 한다. | 사용자 인터뷰: "사용자 기기의 현지 시간대를 기준으로 한다." | DM-DATE-003, OQ-002 |
| 2026-10-16 | DEC-005 | 확정 | 날짜 아이템은 항상 연·월·일과 요일을 표시한다. 오늘·어제 표현은 사용하지 않으며 앱 언어에 맞는 자연스러운 형식을 따른다. | 위 형식 제안에 대한 사용자 인터뷰 답변: "네" | DM-DATE-002, DM-DATE-004, OQ-003 |
| 2026-10-16 | DEC-006 | 확정 | 수신 시간은 말풍선 오른쪽 하단 바깥에 유지한다. 시간 표시 공간을 먼저 확보하고 긴 본문은 줄바꿈하며, 시간을 말풍선 아래로 옮기지 않는다. | 위 배치 제안에 대한 사용자 인터뷰 답변: "네" | DM-TIME-001, OQ-004 |
| 2026-10-16 | DEC-007 | 확정 | 현재 불러온 대화의 첫 메시지 앞과 날짜가 바뀐 첫 메시지 앞에 날짜 아이템을 표시한다. 같은 날짜에서는 반복하지 않으며 과거 메시지 추가 시에도 같은 날짜 구분선이 중복되지 않게 한다. | 위 삽입 정책 제안에 대한 사용자 인터뷰 답변: "네" | DM-DATE-001, OQ-003 |
| 2026-10-16 | DEC-008 | 정정 | 최초 문서 전용 단계가 끝나고 확정 문서에 따른 구현·검증을 진행한다. 제품 정책은 그대로 유지한다. | 사용자: "문서대로 구현 진행", 후속 ulw 지시 | DM-DOC-001, P1-T1~P1-GATE |
## 근거 파일
- `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivity.kt`
- `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/ui/DmChatMessageAdapter.kt`
- `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatUiModels.kt`
- `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/model/DmChatMappers.kt`
- `app/src/main/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomViewModel.kt`
- `app/src/main/res/layout/item_dm_chat_opponent_message.xml`
- `app/src/main/java/kr/co/vividnext/sodalive/settings/language/LanguageManager.kt`
- `app/src/main/java/kr/co/vividnext/sodalive/settings/language/LocaleHelper.kt`
- `docs/sample/sample-prd.md`
- `docs/sample/sample-plan-task.md`
- `docs/agent-guides/work-plan-docs.md`
- `docs/agent-guides/build-test-style.md`
- `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatRoomActivitySourceTest.kt`
- `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatMapperTest.kt`
- `app/src/test/java/kr/co/vividnext/sodalive/v2/main/chat/dm/DmChatPaginationStateTest.kt`
@@ -0,0 +1,58 @@
# Phase 1 DM 날짜 표시와 시간 배치 리뷰
## 1. 리뷰 정보
| 항목 | 내용 |
|---|---|
| 대상 | P1-T1~P1-T3, base 83719d75 이후 working tree |
| 일자 | 2026-10-16 |
| 리뷰어 | 독립 Oracle, 부모 실행자 근거 대조 |
| 기준 | 같은 작업의 prd.md 및 plan-task.md |
| 상태 | 수정 검증 완료: DM-GATE-01 해결, delta APPROVE |
## 2. 목적과 범위
- 날짜 formatter/projection, adapter identity, Activity 스크롤 상태, 수신 XML과 local tests를 검토한다.
- ViewModel/API 변경이나 기기 UI/스크린샷 검증은 수행하지 않는다.
- 기존 source assertion을 약화하거나 레이아웃 속성 테스트를 추가하지 않는다.
## 3. 검토 근거
- 기존 DM baseline 107개, T1 후 125개, T2 후 151개 로직 테스트 통과 로그.
- 날짜 ko/en/ja, 자정·연도·DST, same-day prepend, pending→ACK, 날짜/메시지 identity, 요청 가능 여부와 지연 복원 테스트.
- `DmChatRoomActivity.bindViewModel`, `DmChatScrollState.onContentSubmitted`, `DmChatRoomViewModel.handleOlderMessagesResult`의 실제 코드.
- Oracle는 Gradle이나 실제 기기를 실행하지 않고 위 근거와 코드를 대조했다.
## 4. 발견 사항
| ID | 심각도 | 상태 | 내용 | 후속 Task |
|---|---|---|---|---|
| DM-GATE-01 | Medium | 수정 완료 | 비활성 lifecycle 동안 완료된 prepend가 복귀 시 Content 먼저 재전달되어 anchor를 잃는다. | P1-R1 |
### DM-GATE-01
- 근거: Activity가 Content observer를 count observer보다 먼저 등록한다. LiveData owner 재활성화 시 등록 순으로 최신 값이 전달될 수 있다.
- 경로: prepend 요청/anchor 저장 → owner 비활성 → count와 완료 Content 발행 → owner 재활성 → Content가 pending을 먼저 해제 → count는 무시됨.
- 영향: PRD 수용 시나리오 7의 기존 메시지 identity/offset 복원이 누락된다.
- 조치: count observer를 먼저 등록하고 실제 LiveData/LifecycleRegistry 기반 비활성→재활성 회귀를 추가한다. 원본 ViewModel/API는 변경하지 않는다.
- 판정: 2026-10-16 REQUEST_CHANGES. 다른 날짜/identity/XML 정적 검토 차단 결함은 발견하지 않았다.
## 5. 미확인과 보류
- 연결된 Android 기기가 없어 실제 화면 렌더링과 스크롤을 확인하지 않았다. 정적 XML·로직 테스트를 시각 QA 통과로 표현하지 않는다.
- LSP 도구가 없어 Kotlin 컴파일을 사용한다.
- 전체 local suite의 기존 인증 테스트 실패는 별도로 확인하며 이 리뷰의 DM 범위 수정에 섞지 않는다.
## 6. 후속 검증
- P1-R1을 계획에 추가한 뒤 RED→GREEN으로 수정한다.
- 실제 결과와 리뷰 델타 판정은 여기에 누적한다.
## 7. 수정 검증 및 종료 판정
- P1-R1 RED: 실제 Activity 등록 순서를 반영한 MutableLiveData/LifecycleRegistry 회귀에서 기대 `[Position(position=2, top=-17)]`, 실제 `[]`로 실패했다. focused 8개 중 1개 실패이며 기존 source test는 그대로 통과했다.
- 최소 수정: `prependedMessageCountLiveData.observe`를 `chatRoomStateLiveData.observe`보다 먼저 등록했다. ViewModel/API 변경 없음.
- GREEN: 새 lifecycle 3개 포함 DM154/154, 실패·오류·skip 0. `assembleDebug`와 `ktlintCheck`도 통과했다. 부모 최종 재실행 성공 20초.
- 독립 Oracle delta 판정: **APPROVE, DM-GATE-01 해결.** source에서 등록 순서를 추출해 실제 lifecycle 전달을 검증한 최소 타협을 수용했다. 범위 내 남은 차단 사항 없음.
- 전체 suite 및 Android lint는 PRD/plan Verification Log에 실패와 분리 실행 결과를 기록했다. 이 승인은 해당 범위 밖 오류의 해결이나 실제 기기 시각 QA 통과를 뜻하지 않는다.
- **최종 결론:** 코드 수정·회귀 검증 완료. 실제 기기 렌더링과 LSP는 도구/기기 부재로 미확인.