Files
sodalive-android/docs/20261028_마이_탭_공지사항_롤링/prd.md
T

8.6 KiB

마이 탭 공지사항 롤링 PRD

문서 정보

항목 내용
상태 클라이언트 구현·범위 회귀 완료, 운영 연동 확인 대기
작성일 / 수정일 2026-10-28
대상 메인 페이지 마이 탭 최상단 공지사항
결정권자 요청 사용자
구현 계획 plan-task.md

1. 목표와 범위

기존 단일 공지 영역에서 최신 공지를 최대 3개까지 순서대로 보여준다. 우측 자세히 문구는 제거하고 화살표만 유지하며, 확보한 너비를 제목에 사용한다. 기존 공지 상세 화면의 제목·HTML 본문·날짜 표시와 클릭 이동을 재사용한다.

다른 마이 탭 기능, 공지 목록 API, 기존 홈의 latestNotice, 상세 WebView 처리, 공통 인증·오류 정책은 변경하지 않는다. 서버 배포·보안 설정 변경과 서버의 구 API 삭제는 Android 저장소 작업 범위가 아니다.

2. 현재 구현과 변경 제약

  • 호출 경로: MyPageFragment → MyPageViewModel → NoticeRepository → NoticeApi.
  • 현재 GET /notice/latest는 단일 NoticeItem을 반환한다. Android 운영 소스 내 호출자는 마이 탭뿐이다.
  • 기존 NoticeItem은 title, content, date만 가지고 있으며 id는 없다. 신규 응답에서는 Long 식별자를 보존하고 기존 상세 화면 계약을 유지해야 한다.
  • 공지 조회에는 별도 로딩 UI가 없고, 실패는 기존 로그 처리 후 기존 데이터를 유지한다. 사용자 정보 조회의 로딩·Toast는 그대로 둔다.
  • 사용자는 레거시 공지 관련 최소 수정과 5초 상향 롤링을 명시 승인했다. 신규 지원 코드는 kr.co.vividnext.sodalive.v2 아래에 작성한다.

3. 확정 요구사항

ID 요구사항 수용 기준
NOTICE-001 자세히 제거, 화살표 유지, 제목 너비 확장 기존 색상·서체·주변 구조를 유지하고 문구가 차지하던 공간을 제목이 사용
NOTICE-002 성공한 빈 배열은 공지 영역 미표시 로딩·실패와 성공한 []를 혼동하지 않음
NOTICE-003 1개는 고정, 2~3개는 5초마다 아래에서 위로 전환 서버 순서대로 표시하고 마지막 다음에는 첫 항목으로 순환
NOTICE-004 다른 탭·백그라운드·화면 파괴 시 롤링 중지 중복 예약과 파괴된 View 참조가 없으며 재진입 시 정상 재개
NOTICE-005 현재 표시 항목을 클릭하면 해당 공지 상세 이동 제목·본문 전체·날짜가 해당 항목과 일치하고 HTML 본문은 기존 처리 재사용
NOTICE-006 서버 배열 순서·문자열 보존 로컬 정렬, 날짜 시간대 변환, 본문 가공을 추가하지 않음
NOTICE-007 v2 API 전환 후 미사용 구 latest 클라이언트 선언 제거 /notice 목록과 기존 홈 계약은 유지하고 구 endpoint fallback은 추가하지 않음
NOTICE-008 실제 배포·응답 확인과 목 응답 회귀 검증 비로그인 실제 GET 결과와 0/1/2/3개, 클릭 대상, 순서·내용 테스트 기록

4. API 계약

  • Method/path: GET /api/v2/notices/latest.
  • 비로그인 접근 가능. 요청 body·query·개수 지정·페이지네이션 없음.
  • 정상: HTTP 200, success=true, data는 0~3개 배열. 활성 공지를 id 내림차순으로 서버가 반환한다.
  • 항목: id: Long, title: String, content: String(기존 본문 전체), date: String(Asia/Seoul 기준 yyyy-MM-dd).
  • 공통 message, errorProperty는 nullable이며 포함·생략 모두 기존 ApiResponse<T>로 처리한다. 예시만 보고 생략을 가정하지 않는다.
  • 실패 응답의 HTTP status·오류 문구를 새로 추정하지 않으며 기존 공통 네트워크 처리와 공지 조회 오류 정책을 유지한다.

5. 상태와 접근성

  • 최초 로딩 중에는 빈 공지 컴포넌트를 보이지 않는다. 성공 시 받은 배열을 반영한다.
  • 실패 시 성공한 이전 데이터가 있으면 유지하며, 임의 목 데이터나 구 API로 대체하지 않는다.
  • 롤링 중 표시 제목과 클릭 대상이 일치해야 한다. 숨겨진 이전 항목이 접근성 탐색에 중복 노출되지 않도록 기본 플랫폼 동작을 활용한다.
  • 기존 상세 진입을 재사용하며 공지 제목을 새 HTML 렌더링 경계에 전달하지 않는다. 키·토큰·BuildConfig 값을 로그나 문서에 노출하지 않는다.

6. 검증 범위

  • app/src/test local unit test로 실제 Gson 역직렬화, Rx/LiveData 전달, 롤링 순서·중지·재개, 클릭 payload를 검증한다.
  • 0/1/2/3개 목 응답, Long 식별자, 원문 HTML/날짜 보존, nullable 공통 필드 포함·생략, 성공 후 빈 배열·실패를 포함한다.
  • 레이아웃 크기·간격·constraint·visibility 속성 자체를 테스트하지 않는다.
  • 기기·에뮬레이터 UI 조작, 계측 테스트, 스크린샷·시각 QA는 요청되지 않았으므로 실행하지 않는다.

7. 실제 API 확인 및 외부 의존

2026-10-28 인증 header·body·query 없이 앱의 debug/release 대상에 GET을 실행했다.

환경 관찰 결과 판정
테스트 서버 HTTP 200, success=true, 3개, id [4,3,2], 날짜 모두 2026-10-28, message=null, errorProperty=null 현재 응답의 필드·타입·개수·정렬·날짜 형식 일치
운영 서버 HTTP 401, Unauthorized 비로그인 계약 충족·신규 controller 배포 여부 확인 필요

테스트 서버 본문은 HTML 문자열을 포함한다. JSON 파싱 검사로 data 배열, 최대 3개, 각 필드 타입, 날짜 형식과 id 내림차순을 확인했다. 실제 활성 필터, 서울 날짜 생성 규칙, 0/1/2개 결과는 현재 3개 응답만으로 확정하지 않으며 목 검증과 서버 확인을 구분한다.

외부 의존 EXT-001: 운영 서버 담당자가 신규 endpoint 배포 및 비로그인 보안 허용 설정을 확인해야 한다. 운영 인증 없는 HTTP 200을 재확인하기 전에는 운영 연동 완료로 표시하지 않는다. 클라이언트 구현·테스트는 승인된 계약과 정상인 테스트 서버 응답을 기준으로 진행한다.

8. Decision Log

날짜 ID 결정 근거
2026-10-28 DEC-001 레거시 공지 관련 부분 최소 수정 허용 사용자 명시 승인
2026-10-28 DEC-002 5초 간격 아래→위 순환, 비활성 시 중지 제안에 대한 사용자 승인
2026-10-28 DEC-003 기존 상세 UI·본문 처리 재사용, 신규 의존성 미추가 사용자 요구 및 최소 변경
2026-10-28 DEC-004 실제 서버는 읽기 전용 GET만 검사, 운영 401을 클라이언트 우회하지 않음 사용자 확인 요청 및 실제 응답
2026-10-28 DEC-005 현재 저장소에서 worktree·브랜치 생성 및 커밋 없이 진행 사용자 명시 지시

9. 구현 및 검증 결과

  • NOTICE-001~007 클라이언트 변경을 구현했다. 공지·직접 영향 회귀 33개가 통과했고, 전체 debug local 실행에서도 같은 33개가 모두 통과했다. 첫 전환 애니메이션과 저장된 이전 토큰에 대한 회귀를 추가했다.
  • assembleDebug, ktlintCheck, git diff --check는 성공했다. 독립 코드 리뷰와 두 수정의 한정 재검토에서 공지 범위의 미해결 차단 결함은 없다.
  • 전체 debug local 테스트 최종 실행은 1,642개 중 1개 실패다. 변경하지 않은 V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다의 :844에서 실패했다. 이전 전체 실행에서는 다른 인증 메서드 :528이 실패했으며 이 작업에서 인증 코드/테스트는 변경하지 않았다. 전체 통과로 표시하지 않는다.
  • Android lint는 변경하지 않은 코드의 오류 31개·경고 795개로 실패했다. 첫 오류는 AndroidManifest.xml:346의 com.facebook.FacebookActivity MissingClass다. 요청 범위 밖 lint 수정이나 baseline 추가는 하지 않았다.
  • 최종 무인증 GET 재확인(2026-10-28 18:51 KST): 테스트 서버 HTTP 200, id [4,3,2], 원문 HTML·날짜·nullable envelope 계약 일치. 운영 서버는 여전히 HTTP 401로 EXT-001 미해결이다.
  • 실제 Android 기기/에뮬레이터 시각 QA와 LSP는 실행하지 않았다. 이 세션에 native UI 제어·LSP 진단 도구가 없어 브라우저/소스 대조를 실제 화면 증거로 대체하지 않았다.
  • 상세 증거는 plan-task.md Verification Log와 리뷰 보고서에 있다.