docs(dm): 날짜 표시 구현과 검증 제한을 기록한다
This commit is contained in:
@@ -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`
|
||||
Reference in New Issue
Block a user