📂 문서 구조: 이 문서는 공통임. 프론트·백엔드가 함께 합의해야 하는 경계면만 다룸 — 아키텍처 · API 계약 · 데이터 원천 · 에러 코드 · 플로우. 구현 상세는 맨 아래 하위 페이지에 있으며, 하위 문서는 여기 정의된 계약을 참조만 하고 재정의하지 않음.

문서 정보

1. 요약 — Summary

인증 파이프라인이 쌓아둔 판정 데이터를 읽기 전용으로 조립해 마이 홈·활동 캘린더·티어·통계·이의 현황을 렌더링함. 새 판정 로직은 만들지 않으며, 쓰기는 프로필 편집뿐임. 모든 화면은 성공은 조건 충족 즉시 확정 → 귀속일 종료 후 하루는 유예 · 실패 예정 → 귀속일+2일 00:00 KST 최종 확정이라는 단일 타임라인을 공유함 — 인증 정책 § 2. 구 00시 판정 → 03시 확정 체계는 폐기됨.

2. 배경 — Background

• 사업적 배경은 기능 스펙 1-3 참조. 여기서는 기술 전제만 적음.
• 조회 계층: 원천은 인증 모듈의 일 단위 판정 결과와 티어 모듈의 점수 변동. 이 모듈은 그것을 화면 단위로 조립할 뿐임 → 같은 사실이 화면마다 다르게 보이면 안 됨 — 단일 원천 원칙임.
• 유예 구간이 계약에 박혀 있음: 인증 상태값은 진행중 · 실패 예정 · 완료 · 실패 4종이며, 귀속일이 끝난 뒤 D+1 00:00 ~ D+2 00:00 KST 동안은 실패 예정으로 보임. 늦게 도착한 신호로 실패 예정이 완료로 뒤집힐 수 있으므로 시간에 따라 같은 날짜의 응답이 바뀜. 구 CHECKING 상태는 폐기됨 — 2026-08-28. 캐시 설계 시 이 경계를 넘지 않아야 함.
• 소급 정정이 존재함: 이의는 자동 인용이라 즉시 반영되고, 캘린더·통계·스트릭·티어 4개 표면이 함께 바뀌어야 함.
• 구 체계 잔재: v1 스펙의 매너 온도 체계는 36.5·EMA·밴드 기반이었음. 이 중 관심 카테고리 15종은 구계약임. 친구 초대는 현행 Phase 1 계약에 포함되며 GET /api/v1/me/invitation으로 조회함.

3. 목표 — Goals

• 마이 홈을 1회 호출로 렌더링함 — GET /api/v1/me/home 일괄 조회
• 캘린더는 월 단위 요약 + 일자 상세 2단으로 제공하고, 일자 상세에서 이의 가능 여부까지 함께 내림 — 별도 조회 없이 버튼 상태를 결정함
• 통계는 정책 지표 4종 고정 — 전체 성공률 / 총 성공 인증 수 / 현재·최고 스트릭 / 챌린지 완주 개수. 기간 파라미터 없음. 최근 12주 사이클 성과는 정책 § 3에서 삭제됨
• 티어는 실제 티어/점수와 표시 티어를 분리해 내림. 표시 티어는 유예 밴드를 반영한 값임
• 타인 프로필은 닉네임·사진·표시 티어·완주 개수만 응답에 포함함 — 비공개 항목은 필드 자체가 없음

4. 목표가 아닌 것 — Non-Goals

• 판정·점수 계산 — 인증 스펙과 온도 계산 · 티어 스펙 소관임. 이 모듈은 결과만 읽음