# 마이 탭 공지사항 롤링 PRD ## 문서 정보 | 항목 | 내용 | |---|---| | 상태 | 클라이언트 구현·범위 회귀 완료, 운영 연동 확인 대기 | | 작성일 / 수정일 | 2026-10-28 | | 대상 | 메인 페이지 마이 탭 최상단 공지사항 | | 결정권자 | 요청 사용자 | | 구현 계획 | [plan-task.md](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`로 처리한다. 예시만 보고 생략을 가정하지 않는다. - 실패 응답의 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](plan-task.md) Verification Log와 [리뷰 보고서](reviews/phase1-my-notice-ticker-review.md)에 있다.