docs(dm): 수신 시간 경계 조정과 검증을 기록한다

This commit is contained in:
2026-10-19 10:57:33 +09:00
parent 3a77333357
commit 302096630f
3 changed files with 37 additions and 2 deletions
@@ -17,7 +17,7 @@
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 | | Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|---:|---|---:|---|---| |---:|---|---:|---|---|
| 1 | 구현 완료, Gate 제한 | `4/4` 구현 Task | 없음 | DM 회귀·빌드·ktlint 통과. 전체 suite/lint 및 기기 확인 제한은 하단 기록 | | 1 | 구현 완료, Gate 제한 | `5/5` 구현 Task | 없음 | P1-T4 포함 DM 회귀·빌드 통과. 전체 suite/lint 및 기기 확인 제한은 하단 기록 |
사용자 구현 승인에 따라 아래 체크박스를 실제 검증 완료 시점에 갱신한다. 문서 단계의 기존 기록은 유지한다. 사용자 구현 승인에 따라 아래 체크박스를 실제 검증 완료 시점에 갱신한다. 문서 단계의 기존 기록은 유지한다.
@@ -217,6 +217,29 @@ Activity는 첫 가시 메시지 identity와 top offset을 저장하고 prepend
- 리뷰: `reviews/phase1-dm-date-timeline-review.md` 수정분 APPROVE, 범위 내 남은 차단 사항 없음. - 리뷰: `reviews/phase1-dm-date-timeline-review.md` 수정분 APPROVE, 범위 내 남은 차단 사항 없음.
- 한계: Activity 소스에서 순서를 추출해 실제 LiveData로 검증한 최소 연결 테스트이며, 실제 Activity/RecyclerView 화면을 구동한 증거는 아니다. - 한계: Activity 소스에서 순서를 추출해 실제 LiveData로 검증한 최소 연결 테스트이며, 실제 Activity/RecyclerView 화면을 구동한 증거는 아니다.
#### Task 1.4 수신 시간 오른쪽 경계 85% 조정
**Goal 실행 `P1-T4`:** 수신 메시지의 시간 오른쪽 최대 경계를 부모 행 85%에 맞춰 여백을 확보한다.
- **시작 조건:** PRD DM-TIME-002/DEC-009, 현재 main 브랜치 직접 작업 승인.
- **Files:** `app/src/main/res/layout/item_dm_chat_opponent_message.xml`만 제품 변경. 기존 PRD·계획은 같은 작업의 후속 기록으로 갱신한다.
- **Interfaces:** 수직 Guideline `layout_constraintGuide_percent="0.85"`를 만들고 `tv_time`의 end를 해당 guideline에 연결한다. 기존 parent padding과 packed chain/bias를 유지하므로 비율은 ConstraintLayout의 내부 가용 폭 기준이다. Kotlin/발신 XML/날짜 행은 수정하지 않는다.
- **범위 밖:** 짧은 메시지 시간을 항상 85%에 강제 배치, 말풍선/시간 사이 간격 확대, 기기 UI 조작, 기존 무관한 lint 오류 수정.
- **TDD 예외 사유:** XML 배치 속성 변경이며 저장소 규칙에 따라 레이아웃 속성 테스트를 만들지 않는다.
- **대체 검증:** XML 파싱·리소스 컴파일·기존 DM 회귀를 실행하고 diff로 범위를 확인한다. 실제 화면 성공으로 표현하지 않는다.
- [x] 수직 85% guideline 추가 및 수신 시간 end 경계만 연결했다.
- [x] `xmllint --noout app/src/main/res/layout/item_dm_chat_opponent_message.xml`과 `./gradlew :app:processDebugResources :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.main.chat.dm.*' :app:assembleDebug --max-workers=1`로 검증했다.
- [x] 변경 전후 diff와 현재 main 유지, 검증 결과 및 실제 화면 미확인 한계를 기록했다.
### P1-T4 검증 기록 — 2026-10-19
- 무엇을: `guideline_message_end`를 0.85에 추가하고 `tv_time` end를 부모 오른쪽에서 해당 guideline start로 연결했다. 기존 padding·상호 제약·packed chain/bias를 유지했다.
- 왜: 긴 수신 메시지가 화면 오른쪽까지 차는 답답함을 줄이되 짧은 메시지의 본문/시간 간격은 유지하기 위해서다.
- 어떻게: xmllint 성공, 리소스 컴파일/DM154개/assembleDebug 모두 성공, `BUILD SUCCESSFUL in 4m 20s`, 실패·오류·skip 0. `git diff --check` 오류 없음. 현재 main에서 브랜치 전환 없이 수정했다.
- 제한 리뷰: 독립 visual-engineering 읽기 전용 검토 APPROVE, 정적 제약 연결의 확정 결함 없음. 같은 작업 review 문서에 추가 기록했다.
- 한계: XML 속성 테스트는 추가하지 않았다. 기존 전체 앱 테스트/Android lint의 범위 밖 실패는 재실행하지 않았다. LSP 도구와 실제 기기 시각 검증은 미수행이며 리소스 컴파일을 화면 확인으로 주장하지 않는다.
- 문서 명령 확인: `./gradlew tasks --all --console=plain` 성공 2초. 소유 실행 root `dm-time85.jenavU`와 ULW 메모를 정리하고 부재를 확인했다. 공유 캐시·기존 APK는 유지했으며 커밋·push·브랜치 전환은 하지 않았다.
### Phase 1 Gate ### Phase 1 Gate
**Goal 실행 `P1-GATE`:** 문서 요구사항과 구현·테스트 근거가 모두 추적되는지 검증한다. **Goal 실행 `P1-GATE`:** 문서 요구사항과 구현·테스트 근거가 모두 추적되는지 검증한다.
@@ -6,7 +6,7 @@
|---|---| |---|---|
| 문서 상태 | 구현 완료, DM 회귀 통과. 전체 검사·실제 기기 검증 제한은 계획의 Verification Log 참조 | | 문서 상태 | 구현 완료, DM 회귀 통과. 전체 검사·실제 기기 검증 제한은 계획의 Verification Log 참조 |
| 작성일 | 2026-10-16 | | 작성일 | 2026-10-16 |
| 최종 수정일 | 2026-10-16 | | 최종 수정일 | 2026-10-19 |
| 대상 제품 | Android 유저-크리에이터 DM 채팅방 | | 대상 제품 | Android 유저-크리에이터 DM 채팅방 |
| 작성자·결정권자 | 작성: 에이전트 / 제품 결정: 사용자 | | 작성자·결정권자 | 작성: 에이전트 / 제품 결정: 사용자 |
| 관련 API Contract | 이번 요청에서 API 변경 요구 없음. 기존 `docs/20260610_DM_채팅화면/prd.md` 참고 | | 관련 API Contract | 이번 요청에서 API 변경 요구 없음. 기존 `docs/20260610_DM_채팅화면/prd.md` 참고 |
@@ -81,6 +81,7 @@
| DM-DATE-003 | 확정 | 날짜 구분과 날짜 표기는 사용자 기기의 현지 시간대를 기준으로 한다. | 메시지 시각을 기기 현지 시간대로 해석한 날짜를 사용하고, 현지 날짜가 자정을 넘어 달라지면 서로 다른 날짜로 구분한다. 동일한 메시지도 기기 시간대에 따라 날짜가 다를 수 있다. | DEC-004, OQ-002, P1-T1 | | DM-DATE-003 | 확정 | 날짜 구분과 날짜 표기는 사용자 기기의 현지 시간대를 기준으로 한다. | 메시지 시각을 기기 현지 시간대로 해석한 날짜를 사용하고, 현지 날짜가 자정을 넘어 달라지면 서로 다른 날짜로 구분한다. 동일한 메시지도 기기 시간대에 따라 날짜가 다를 수 있다. | DEC-004, OQ-002, P1-T1 |
| DM-DATE-004 | 확정 | 날짜 아이템은 항상 연·월·일과 요일을 표시하고 오늘·어제 같은 상대 날짜 표현은 사용하지 않는다. | 한국어 예시는 `2026년 10월 16일 금요일`이며 다른 앱 언어는 해당 언어의 자연스러운 형식을 사용한다. 올해 날짜도 연도를 생략하지 않는다. | DEC-005, OQ-003, P1-T1 | | DM-DATE-004 | 확정 | 날짜 아이템은 항상 연·월·일과 요일을 표시하고 오늘·어제 같은 상대 날짜 표현은 사용하지 않는다. | 한국어 예시는 `2026년 10월 16일 금요일`이며 다른 앱 언어는 해당 언어의 자연스러운 형식을 사용한다. 올해 날짜도 연도를 생략하지 않는다. | DEC-005, OQ-003, P1-T1 |
| DM-TIME-001 | 확정 | 긴 수신 메시지에서도 받은 시간이 화면 밖으로 벗어나지 않게 한다. 시간은 기존처럼 말풍선 오른쪽 하단 바깥에 유지하며, 시간 표시 공간을 먼저 확보하고 긴 본문을 줄바꿈한다. | 시간과 본문이 겹치거나 화면 밖으로 잘리지 않는다. 시간을 말풍선 아래로 옮기지 않으며 본문을 생략하는 방식으로 해결하지 않는다. | DEC-006, OQ-004, P1-T3 | | DM-TIME-001 | 확정 | 긴 수신 메시지에서도 받은 시간이 화면 밖으로 벗어나지 않게 한다. 시간은 기존처럼 말풍선 오른쪽 하단 바깥에 유지하며, 시간 표시 공간을 먼저 확보하고 긴 본문을 줄바꿈한다. | 시간과 본문이 겹치거나 화면 밖으로 잘리지 않는다. 시간을 말풍선 아래로 옮기지 않으며 본문을 생략하는 방식으로 해결하지 않는다. | DEC-006, OQ-004, P1-T3 |
| DM-TIME-002 | 확정 | 수신 시간의 오른쪽 경계를 부모 메시지 행의 85% 지점으로 제한해 오른쪽 여백을 확보한다. | 긴 말풍선과 시간은 85% 경계 안에서 배치한다. 짧은 메시지는 기존처럼 말풍선 옆에 시간을 붙이고, 프로필·날짜·발신 메시지 배치는 변경하지 않는다. | DEC-009, P1-T4 |
| DM-DOC-001 | 완료 | 최초 단계에서는 인터뷰 및 문서 작성만 수행한다. 이후 별도 사용자 승인에 따라 구현 단계로 전환한다. | 문서 단계에서 코드 변경이 없었으며 구현은 DEC-008 이후 수행한다. | DEC-008 | | DM-DOC-001 | 완료 | 최초 단계에서는 인터뷰 및 문서 작성만 수행한다. 이후 별도 사용자 승인에 따라 구현 단계로 전환한다. | 문서 단계에서 코드 변경이 없었으며 구현은 DEC-008 이후 수행한다. | DEC-008 |
## 9. 성능과 품질 요구사항 ## 9. 성능과 품질 요구사항
@@ -108,6 +109,7 @@
|---|---|---|---| |---|---|---|---|
| `DM-DATE-001`~`004` | `P1-T1`, `P1-T2` | 날짜 formatter/projection 및 timeline identity 테스트 | `P1-GATE` | | `DM-DATE-001`~`004` | `P1-T1`, `P1-T2` | 날짜 formatter/projection 및 timeline identity 테스트 | `P1-GATE` |
| `DM-TIME-001` | `P1-T3` | XML 리소스 컴파일, lint와 정적 소스 대조. 레이아웃 속성 테스트 없음 | `P1-GATE`; 실제 화면 검증은 미수행으로 기록 | | `DM-TIME-001` | `P1-T3` | XML 리소스 컴파일, lint와 정적 소스 대조. 레이아웃 속성 테스트 없음 | `P1-GATE`; 실제 화면 검증은 미수행으로 기록 |
| `DM-TIME-002` | `P1-T4` | XML 파싱·리소스 컴파일·기존 DM 회귀. 레이아웃 속성 테스트 없음 | Task별 검증 기록 |
| `DM-DOC-001` | 본 문서 작업 | 두 문서의 경로·요구사항·체크박스 일관성 확인 | 이번 작업 완료 | | `DM-DOC-001` | 본 문서 작업 | 두 문서의 경로·요구사항·체크박스 일관성 확인 | 이번 작업 완료 |
## 12. Open Questions ## 12. Open Questions
@@ -139,6 +141,7 @@
| 2026-10-16 | DEC-006 | 확정 | 수신 시간은 말풍선 오른쪽 하단 바깥에 유지한다. 시간 표시 공간을 먼저 확보하고 긴 본문은 줄바꿈하며, 시간을 말풍선 아래로 옮기지 않는다. | 위 배치 제안에 대한 사용자 인터뷰 답변: "네" | DM-TIME-001, OQ-004 | | 2026-10-16 | DEC-006 | 확정 | 수신 시간은 말풍선 오른쪽 하단 바깥에 유지한다. 시간 표시 공간을 먼저 확보하고 긴 본문은 줄바꿈하며, 시간을 말풍선 아래로 옮기지 않는다. | 위 배치 제안에 대한 사용자 인터뷰 답변: "네" | DM-TIME-001, OQ-004 |
| 2026-10-16 | DEC-007 | 확정 | 현재 불러온 대화의 첫 메시지 앞과 날짜가 바뀐 첫 메시지 앞에 날짜 아이템을 표시한다. 같은 날짜에서는 반복하지 않으며 과거 메시지 추가 시에도 같은 날짜 구분선이 중복되지 않게 한다. | 위 삽입 정책 제안에 대한 사용자 인터뷰 답변: "네" | DM-DATE-001, OQ-003 | | 2026-10-16 | DEC-007 | 확정 | 현재 불러온 대화의 첫 메시지 앞과 날짜가 바뀐 첫 메시지 앞에 날짜 아이템을 표시한다. 같은 날짜에서는 반복하지 않으며 과거 메시지 추가 시에도 같은 날짜 구분선이 중복되지 않게 한다. | 위 삽입 정책 제안에 대한 사용자 인터뷰 답변: "네" | DM-DATE-001, OQ-003 |
| 2026-10-16 | DEC-008 | 정정 | 최초 문서 전용 단계가 끝나고 확정 문서에 따른 구현·검증을 진행한다. 제품 정책은 그대로 유지한다. | 사용자: "문서대로 구현 진행", 후속 ulw 지시 | DM-DOC-001, P1-T1~P1-GATE | | 2026-10-16 | DEC-008 | 정정 | 최초 문서 전용 단계가 끝나고 확정 문서에 따른 구현·검증을 진행한다. 제품 정책은 그대로 유지한다. | 사용자: "문서대로 구현 진행", 후속 ulw 지시 | DM-DOC-001, P1-T1~P1-GATE |
| 2026-10-19 | DEC-009 | 확정 | 현재 main 브랜치에서 수신 시간 오른쪽 경계를 85%로 조정한다. 기존 말풍선 옆 compact 배치는 유지하며 오른쪽 최대 경계만 변경한다. | 사용자 후속 요청: "시간의 오른쪽 끝을 85%에 맞추도록 조정" | DM-TIME-002, P1-T4 |
## 근거 파일 ## 근거 파일
@@ -56,3 +56,12 @@
- 독립 Oracle delta 판정: **APPROVE, DM-GATE-01 해결.** source에서 등록 순서를 추출해 실제 lifecycle 전달을 검증한 최소 타협을 수용했다. 범위 내 남은 차단 사항 없음. - 독립 Oracle delta 판정: **APPROVE, DM-GATE-01 해결.** source에서 등록 순서를 추출해 실제 lifecycle 전달을 검증한 최소 타협을 수용했다. 범위 내 남은 차단 사항 없음.
- 전체 suite 및 Android lint는 PRD/plan Verification Log에 실패와 분리 실행 결과를 기록했다. 이 승인은 해당 범위 밖 오류의 해결이나 실제 기기 시각 QA 통과를 뜻하지 않는다. - 전체 suite 및 Android lint는 PRD/plan Verification Log에 실패와 분리 실행 결과를 기록했다. 이 승인은 해당 범위 밖 오류의 해결이나 실제 기기 시각 QA 통과를 뜻하지 않는다.
- **최종 결론:** 코드 수정·회귀 검증 완료. 실제 기기 렌더링과 LSP는 도구/기기 부재로 미확인. - **최종 결론:** 코드 수정·회귀 검증 완료. 실제 기기 렌더링과 LSP는 도구/기기 부재로 미확인.
## 8. P1-T4 85% 경계 후속 리뷰 — 2026-10-19
- 범위: `item_dm_chat_opponent_message.xml`의 0.85 guideline 및 시간 end 연결, PRD DM-TIME-002. 기존 완료 리뷰와 별도 후속 판정이다.
- 리뷰어: 독립 visual-engineering 읽기 전용 검토. 명령 실행·기기 렌더링은 수행하지 않았다.
- 근거: 12~17행 vertical guideline 0.85, 97행 time end 연결. 35~39행 constrainedWidth/packed chain/bias0와 91~98행 시간 간격·하단 정렬 유지.
- 판정: **APPROVE, 확정 발견 사항 없음.** 짧은 메시지는 기존 compact 배치, 긴 메시지는 내부 가용 폭 85% 최대 경계를 사용한다.
- 부모 검증: XML 파싱·리소스 컴파일·DM154/154·assembleDebug 성공. 제품 변경이 상대 XML 하나뿐임을 diff로 확인했다.
- 제한: 실제 렌더링/시각 QA는 미수행. 추가 회귀 수정 Task 전환 항목 없음.