⚠️ API 계약·에러 코드·데이터 원천은 상위 공통 문서에서만 정의함. 이 문서에서 재정의하지 않음.

1. 요약

방 커뮤니케이션 10화면을 구현함. 이 화면의 난이도는 권한 × 차단 × 모더레이션 3개 축이 곱해지는 조건 분기임. 같은 피드가 보는 사람·역할·차단 여부에 따라 다르게 렌더됨.

2. 전제 및 지원 범위

방 내부 API는 전부 멤버 전용임 — 비멤버는 403
재사용: 멤버 프로필 1000:127은 마이페이지에서 하단 메뉴만 제거한 형태임 — 기존 디자인 규칙을 따르며 마이페이지 모듈과 컴포넌트를 공유함
디자인: Figma 988:44 — 스레드 988:45 · 공지 상세 989:44 · 공지 쓰기 990:44 · 빈 상태 990:84 · 신고 시트 991:44 · 방 내부 랭킹 995:51 · 방 외부 랭킹 996:51 · 공지 모아보기 997:51 · 누적 성공 998:51 · 멤버 프로필 1000:127

Goals — 권한별 UI 분기를 응답 필드로만 결정, 차단 유저 3경로 처리 일관, 스레드 무한스크롤 안정화, 빈 상태 설계

Non-Goals — 이의 제출 화면은 인증 모듈, 블랙리스트 관리 화면은 마이페이지·신고 모듈 소관임. 여기서는 진입점만 제공함

라우트	진입 경로	사용 API
방 스레드 · 메인	챌린지 상세 · 방 입장	`GET /api/v1/challenges/{id}/room` · `GET /api/v1/challenges/{id}/threads` — 병렬 호출
공지 상세	스레드 아이템 · 고정 배너 · 푸시	`GET /api/v1/challenges/{id}/notices/{noticeId}` · `GET /api/v1/comments`
공지 쓰기	스레드 — 방장만	`POST /api/v1/challenges/{id}/notices`
공지 모아보기	스레드 퀵링크	`GET /api/v1/challenges/{id}/notices`
신고 시트	⋯ 메뉴 — 공지 · 댓글 · 프로필	`POST /api/v1/reports`
방 내부 랭킹	스레드 헤더	`GET /api/v1/challenges/{id}/ranking`
방 외부 랭킹	방 내부 랭킹	`GET /api/v1/rankings/challenges`
누적 성공	스레드 퀵링크	방 안 랭킹 API 재사용
멤버 프로필	아바타 탭 · 멤버 목록	`GET /api/v1/challenges/{id}/members` · 타인 프로필
빈 상태	items 빈 배열	—

조건	노출
`myRole = OWNER` · `ownerType = USER`	공지 쓰기 FAB · 공지 ⋯ 메뉴로 수정·삭제·고정 · 멤버 관리로 초대·강퇴·위임
`myRole = MEMBER` · `ownerType = BOT`	"방장 되기" CTA · 공지 영역은 빈 상태
`myRole = MEMBER` · `ownerType = USER`	조회 + 댓글만
초대 버튼	비공개 방에서만 노출한다. 공개·솔로는 사전 비노출 — 409 유발 금지
댓글 ⋯	`deletable = true`일 때만 삭제 메뉴
답글 버튼	원 댓글에만 노출한다. 답글에는 미노출 — 400 유발 금지
신고	본인 글·본인 프로필엔 미노출

원칙: 서버가 403/400을 내리기 전에 클라이언트가 버튼을 안 보여줌. 에러는 경합·상태 변경 시의 백업임.

경로	처리	클라이언트 확인
공지	미노출 — 고정이었으면 `pinnedNotice: null`	고정 배너 영역 자체를 숨김
인증 이벤트	마스킹 노출 — 임시 닉네임 + 기본 이미지	아이템은 그대로 두고 사람 정보만 교체
댓글·답글	목록에서 제외	`commentCount`와 실제 개수가 다를 수 있음 — 숫자 불일치를 버그로 보지 말 것
공지 상세 직접 진입	404 — 존재 은닉	"찾을 수 없는 공지" — 차단했다고 알리지 않음
랭킹	마스킹된 채 등수 유지	순위에서 빼지 않음