1. 요약 (Summary)

2026-09-15 KST 재정합화 — 공지·댓글과 방장 재량 강퇴·권한 위임·봇방장 클레임은 Phase 2다. 설계와 비활성 코드는 보존할 수 있지만, Phase 1에는 관련 테이블·인덱스·쿼리·API를 배포하지 않는다. 자동 강퇴 3종의 판정은 외부 모듈, 신호를 받은 뒤의 집행은 본 모듈이 담당한다.

• Phase 1 스레드는 단일 원천이다 — 인증 이벤트만 커서 페이징으로 내려주고 itemType 계약만 유지한다. 공지 쿼리와 병합 로직은 Phase 2에서 구현한다.
• VERIFY_FAIL은 인증 모듈이 기록한 shareable_at으로만 필터한다 — 조기 노출 0건 가드레일의 구현 지점. Phase 1에서도 그대로 유효하며 이번 범위의 최우선 검증 대상이다.
• 차단 마스킹은 응답 조립 단계에서 조회자 컨텍스트로 처리한다 — 마스킹 결과를 공용 캐시에 넣지 않는다. Phase 1에서 경로는 인증 이벤트 마스킹 하나로 줄어든다.
• OWNER 1명 불변식은 Phase 1에서 방장 자진 탈퇴에 따른 USER→BOT 단방향 전환으로 보장한다. 방장 재량 강퇴·위임·클레임은 Phase 2지만, 외부 판정 신호를 받는 자동 강퇴 3종의 집행은 Phase 1이다.

2. 전제 및 현재 시스템

• Phase 1 소유 범위: 방 조회, 인증 이벤트 스레드, 방 안/밖 랭킹, 멤버 조회·탈퇴·비공개 초대, USER→BOT 전환, 자동 강퇴 3종 집행, 신고·차단
• Phase 2 소유 범위: 공지·댓글, 방장 재량 강퇴, 권한 위임, 봇방장 클레임. 이미 작성된 코드는 기능 플래그로 비활성화할 수 있지만 Phase 1 DB 마이그레이션과 QA 대상에서는 제외한다.
• 외부 원천: 인증 모듈의 판정 결과·shareable_at·부정행위/권한 미허용 신호, 티어·점수 모듈의 연속 실패 신호, 회원·백오피스의 외부 이탈 신호, 알림 모듈의 FCM 발송
• 정합성 원본: 현재 멤버는 challenge_members.left_at IS NULL, 방장은 challenges.owner_id와 owner_type, 정원과 유령방 판정은 DB다. 탐색 Redis는 참여 인원·isFull 조회 모델일 뿐이다.
• 저장 엔진 기본값: 온라인 테이블은 MySQL 8.x InnoDB다. MySQL ENGINE=ARCHIVE는 사용하지 않으며, 별도 Archive DB는 종료·종결된 데이터에만 후속 수명주기로 적용한다.

3. 목표 (Goals) / 목표가 아닌 것 (Non-Goals)

Goals

• Phase 1 스레드를 인증 이벤트 단일 원천의 커서 조회로 구현하고, VERIFY_FAIL은 shareable_at <= NOW()인 확정 건만 노출한다.
• 역할을 저장 컬럼으로 중복 보관하지 않고 challenges.owner_id에서 파생한다. 방장 자진 탈퇴 트랜잭션에서 챌린지 행을 잠근 뒤 USER→BOT으로 전환한다.
• 자동 강퇴 신호를 (challengeId, userId, reason, sourceEventId)로 멱등 집행하고, 멤버십 종료·근거 보존·랭킹 제거·백오프 또는 영구 차단을 한 경로에서 처리한다.
• 신고 접수·개인 차단·시점 스냅샷을 단일 트랜잭션으로 저장하고, 운영자 큐의 인덱스 조회를 보장한다.
• 만료·유령방·직권 폐쇄 시 생성/라이프사이클 모듈의 이력 3종 적재가 끝난 뒤 본 모듈의 운영 데이터를 하드 삭제할 수 있게 한다.