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,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는 도구/기기 부재로 미확인.