docs(dm): 날짜 표시 구현과 검증 제한을 기록한다
This commit is contained in:
@@ -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 및 저장소 테스트 보고서는 유지했다. 임시 로그의 핵심 명령·실패·성공 증거는 이 문서와 리뷰에 보존했다.
|
||||
Reference in New Issue
Block a user