Files
sodalive-android/docs/20261016_DM_날짜_구분선과_수신_시간_표시/prd.md
T

17 KiB

DM 날짜 구분선과 수신 시간 표시 PRD

문서 정보

항목 내용
문서 상태 구현 완료, DM 회귀 통과. 전체 검사·실제 기기 검증 제한은 계획의 Verification Log 참조
작성일 2026-10-16
최종 수정일 2026-10-19
대상 제품 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-TIME-002 확정 수신 시간의 오른쪽 경계를 부모 메시지 행의 85% 지점으로 제한해 오른쪽 여백을 확보한다. 긴 말풍선과 시간은 85% 경계 안에서 배치한다. 짧은 메시지는 기존처럼 말풍선 옆에 시간을 붙이고, 프로필·날짜·발신 메시지 배치는 변경하지 않는다. DEC-009, P1-T4
DM-DOC-001 완료 최초 단계에서는 인터뷰 및 문서 작성만 수행한다. 이후 별도 사용자 승인에 따라 구현 단계로 전환한다. 문서 단계에서 코드 변경이 없었으며 구현은 DEC-008 이후 수행한다. DEC-008

9. 성능과 품질 요구사항

  • 날짜 아이템 때문에 메시지 중복 제거, 정렬, 전송 상태, 과거 메시지 조회 및 스크롤 정책이 바뀌지 않도록 구현 계획에 회귀 범위를 포함한다.
  • 향후 자동 검증은 app/src/test의 날짜 그룹화·현지화 formatter·표시 모델·adapter 분기 등 로직 단일 테스트를 대상으로 한다.
  • View 크기·간격·constraint·visibility 등 레이아웃 속성을 직접 검증하는 자동 테스트는 계획하지 않는다.
  • 문서 작성 단계에서는 제품 테스트 및 빌드를 실행해 기능 완료를 주장하지 않는다.

10. 성공 기준

  • 같은 현지 날짜는 한 구분선으로 묶이고 날짜 경계와 첫 메시지에 구분선이 생성된다. 빈 목록은 비어 있다. projection과 adapter 분기 테스트로 확인했다. (DM-DATE-001)
  • 앱 언어 ko/en/ja에 맞는 연도 포함 날짜·요일, 오늘/어제 미사용을 formatter 테스트로 확인했다. (DM-DATE-002, DM-DATE-004)
  • 기기 현지 timezone 입력에 대한 자정·DST·연도 경계 테스트를 통과했다. (DM-DATE-003)
  • identity, pending→ACK stable ID, near-bottom 및 prepend anchor 로직을 검증했다. lifecycle 복귀 회귀는 P1-R1에서 RED→GREEN으로 확인했다. 실제 기기 스크롤 검증과는 구분한다. (DM-DATE-001)
  • 수신 시간 공간 확보와 기존 위치 보존을 XML 구조·리소스 컴파일·독립 코드 리뷰로 확인했다. 실제 렌더링은 기기 미연결로 미확인이다. (DM-TIME-001)
  • 기존 DmChatRoomActivitySourceTest를 수정하거나 약화하지 않고 통과했다.
  • 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-TIME-002 P1-T4 XML 파싱·리소스 컴파일·기존 DM 회귀. 레이아웃 속성 테스트 없음 Task별 검증 기록
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
2026-10-19 DEC-009 확정 현재 main 브랜치에서 수신 시간 오른쪽 경계를 85%로 조정한다. 기존 말풍선 옆 compact 배치는 유지하며 오른쪽 최대 경계만 변경한다. 사용자 후속 요청: "시간의 오른쪽 끝을 85%에 맞추도록 조정" DM-TIME-002, P1-T4

근거 파일

  • 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