sodalive-android/docs/20260330_라이브룸캡쳐녹화스탭권한확장.md

20260330 라이브룸 캡쳐/녹화 스탭 권한 확장

구현 체크리스트

• 화면 캡쳐/녹화 정책이 적용되는 분기(isHost, FLAG_SECURE, 녹화 감지 mute)와 스탭 판별 소스를 확인한다. (QA: LiveRoomActivity에서 정책 함수/호출 지점과 스탭 판별 API 확인)
• 화면 캡쳐/녹화 허용 대상을 방장에서 방장+스탭으로 확장한다. (QA: 정책 분기에서 방장/스탭 공통 허용, 일반 청취자 차단 유지 확인)
• 정책 변경 후 연관 UI/상태 동기화 로직의 정합성을 검증한다. (QA: 룸 정보 수신 시점과 포그라운드 전환 시점 모두에서 동일 정책 적용 확인)
• 진단/테스트/빌드 및 수동 QA를 수행하고 결과를 기록한다. (QA: 실행 명령과 결과 로그, 수동 검증 결과 기록)

검증 기록

• 2026-03-30

  • 무엇: 작업 계획 문서를 생성하고 요청 범위를 방장+스탭 캡쳐/녹화 허용으로 고정했다.
  • 왜: 구현 전 체크리스트 기반으로 정확한 범위와 검증 기준을 고정해 과/미구현을 방지하기 위해서다.
  • 어떻게:
    • docs/20260330_라이브룸캡쳐녹화스탭권한확장.md 신규 작성
    • 체크리스트에 QA 기준(정책 분기/동기화/검증)을 명시

• 2026-03-30

  • 무엇: 캡쳐/녹화 권한 및 스탭 판별 로직을 병렬 탐색하고 변경 지점을 확정했다.
  • 왜: 기존 정책이 방장(isHost) 기준으로 고정되어 있어 스탭 동적 권한 부여/회수 상황을 반영하려면 정확한 동기화 지점을 먼저 확보해야 했기 때문이다.
  • 어떻게:
    • 내부 탐색(explore):
      • bg_dd2bd641 (캡쳐 보안 플로우 맵)
      • bg_9c629910 (host-only guard 분류)
      • bg_649ec034 (스탭 판별 canonical predicate)
    • 외부 탐색(librarian):
      • bg_22584dd7 (OSS 역할 기반 사례 탐색 시도)
      • bg_7d687143 (Android FLAG_SECURE 공식 레퍼런스 탐색)
    • 직접 검색:
      • grep으로 syncCaptureSecurityPolicyByRole, syncCapturePrivacyMuteState, isEqualToManagerId, managerList 교차 확인
      • ast_grep_search로 if (!isHost) guard 위치 점검
      • rg는 로컬 환경 미설치(command -v rg 결과 없음)로 grep/ast-grep 기반으로 대체 탐색

• 2026-03-30

  • 무엇: LiveRoomActivity의 캡쳐/녹화 허용 대상을 방장+스탭으로 확장했다.
  • 왜: 스탭 권한은 입장 시 고정이 아니라 라이브 중간에 부여/해제되므로, 룸 정보 갱신 시점마다 권한을 재계산해 정책을 즉시 재동기화해야 하기 때문이다.
  • 어떻게:
    • isStaff 상태 필드와 syncRoomRoleState(response)를 추가해 response.managerList 기반으로 현재 사용자 스탭 여부를 계산
    • viewModel.roomInfoLiveData.observe에서 syncRoomRoleState(response) 직후 syncCaptureSecurityPolicyByRole()를 호출하도록 변경
    • hasCapturePermissionByRole() 헬퍼를 추가하고 캡쳐 정책/녹화 mute 계산을 isHost 단일 조건에서 isHost || isStaff 조건으로 확장
      • syncCaptureSecurityPolicyByRole(): 방장+스탭은 FLAG_SECURE 해제/녹화 콜백 해제
      • syncCapturePrivacyMuteState(): 일반 청취자만 녹화 감지 시 강제 mute

• 2026-03-30

  • 무엇: 진단/테스트/빌드/수동 QA를 수행했다.
  • 왜: 변경이 컴파일 안정성과 요청 동작(방장+스탭 허용, 일반 차단, 중간 권한 변경 반영)을 만족하는지 증거로 확인하기 위해서다.
  • 어떻게:
    • LSP 진단: .kt 서버 미구성으로 lsp_diagnostics 실행 불가(환경 제약 확인)
    • 실행 명령: ./gradlew :app:testDebugUnitTest :app:assembleDebug
    • 결과: BUILD SUCCESSFUL
    • 수동 QA 명령: python3 검증 스크립트로 정책 함수/역할 동기화/조건식을 점검
    • 수동 QA 결과: MANUAL_QA_PASS: host+staff 캡쳐/녹화 허용 분기와 런타임 재동기화 경로를 소스 기준으로 확인했습니다.