From 302096630f244bdb793efecac9befaf502a86d42 Mon Sep 17 00:00:00 2001 From: klaus Date: Mon, 19 Oct 2026 10:57:33 +0900 Subject: [PATCH] =?UTF-8?q?docs(dm):=20=EC=88=98=EC=8B=A0=20=EC=8B=9C?= =?UTF-8?q?=EA=B0=84=20=EA=B2=BD=EA=B3=84=20=EC=A1=B0=EC=A0=95=EA=B3=BC=20?= =?UTF-8?q?=EA=B2=80=EC=A6=9D=EC=9D=84=20=EA=B8=B0=EB=A1=9D=ED=95=9C?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 25 ++++++++++++++++++- .../prd.md | 5 +++- .../reviews/phase1-dm-date-timeline-review.md | 9 +++++++ 3 files changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/plan-task.md b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/plan-task.md index 0658a481..9f3679b6 100644 --- a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/plan-task.md +++ b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/plan-task.md @@ -17,7 +17,7 @@ | 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, 범위 내 남은 차단 사항 없음. - 한계: 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 **Goal 실행 `P1-GATE`:** 문서 요구사항과 구현·테스트 근거가 모두 추적되는지 검증한다. diff --git a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md index c377643d..6f12c350 100644 --- a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md +++ b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md @@ -6,7 +6,7 @@ |---|---| | 문서 상태 | 구현 완료, DM 회귀 통과. 전체 검사·실제 기기 검증 제한은 계획의 Verification Log 참조 | | 작성일 | 2026-10-16 | -| 최종 수정일 | 2026-10-16 | +| 최종 수정일 | 2026-10-19 | | 대상 제품 | Android 유저-크리에이터 DM 채팅방 | | 작성자·결정권자 | 작성: 에이전트 / 제품 결정: 사용자 | | 관련 API Contract | 이번 요청에서 API 변경 요구 없음. 기존 `docs/20260610_DM_채팅화면/prd.md` 참고 | @@ -81,6 +81,7 @@ | 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-TIME-002 | 확정 | 수신 시간의 오른쪽 경계를 부모 메시지 행의 85% 지점으로 제한해 오른쪽 여백을 확보한다. | 긴 말풍선과 시간은 85% 경계 안에서 배치한다. 짧은 메시지는 기존처럼 말풍선 옆에 시간을 붙이고, 프로필·날짜·발신 메시지 배치는 변경하지 않는다. | DEC-009, P1-T4 | | DM-DOC-001 | 완료 | 최초 단계에서는 인터뷰 및 문서 작성만 수행한다. 이후 별도 사용자 승인에 따라 구현 단계로 전환한다. | 문서 단계에서 코드 변경이 없었으며 구현은 DEC-008 이후 수행한다. | DEC-008 | ## 9. 성능과 품질 요구사항 @@ -108,6 +109,7 @@ |---|---|---|---| | `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-002` | `P1-T4` | XML 파싱·리소스 컴파일·기존 DM 회귀. 레이아웃 속성 테스트 없음 | Task별 검증 기록 | | `DM-DOC-001` | 본 문서 작업 | 두 문서의 경로·요구사항·체크박스 일관성 확인 | 이번 작업 완료 | ## 12. Open Questions @@ -139,6 +141,7 @@ | 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 | +| 2026-10-19 | DEC-009 | 확정 | 현재 main 브랜치에서 수신 시간 오른쪽 경계를 85%로 조정한다. 기존 말풍선 옆 compact 배치는 유지하며 오른쪽 최대 경계만 변경한다. | 사용자 후속 요청: "시간의 오른쪽 끝을 85%에 맞추도록 조정" | DM-TIME-002, P1-T4 | ## 근거 파일 diff --git a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/reviews/phase1-dm-date-timeline-review.md b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/reviews/phase1-dm-date-timeline-review.md index 566c6499..3d0b439d 100644 --- a/docs/20261016_DM_날짜_구분선과_수신_시간_표시/reviews/phase1-dm-date-timeline-review.md +++ b/docs/20261016_DM_날짜_구분선과_수신_시간_표시/reviews/phase1-dm-date-timeline-review.md @@ -56,3 +56,12 @@ - 독립 Oracle delta 판정: **APPROVE, DM-GATE-01 해결.** source에서 등록 순서를 추출해 실제 lifecycle 전달을 검증한 최소 타협을 수용했다. 범위 내 남은 차단 사항 없음. - 전체 suite 및 Android lint는 PRD/plan Verification Log에 실패와 분리 실행 결과를 기록했다. 이 승인은 해당 범위 밖 오류의 해결이나 실제 기기 시각 QA 통과를 뜻하지 않는다. - **최종 결론:** 코드 수정·회귀 검증 완료. 실제 기기 렌더링과 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 전환 항목 없음.