klaus/sodalive-android

Fork 0

Files

T

klaus 7a21b37d8f feat(creator): 차단 성공 후 채널에서 이탈한다

2026-08-14 16:20:29 +09:00

9.6 KiB

Raw Blame History

PRD: 크리에이터 채널 차단 후 이탈

문서 정보

항목	내용
문서 상태	구현 완료
작성일	`2026-08-14`
최종 수정일	`2026-08-14`
대상 제품	크리에이터 채널 사용자 차단 흐름
작성자·결정권자	사용자, Sisyphus
관련 API Contract	기존 `CreatorChannelRepository.blockUser(userId, token)` 계약 사용
관련 구현 계획	`docs/20260814_크리에이터_채널_차단_후_이탈/plan-task.md`
관련 review	없음

1. Overview

사용자가 크리에이터 채널에서 현재 보고 있는 크리에이터를 차단하면, 차단 성공 후 더 이상 해당 크리에이터 채널 화면에 머물지 않는다. 일반 진입에서는 현재 채널 화면을 종료해 이전 화면으로 돌아가고, 푸시 또는 딥링크처럼 이전 화면이 없는 진입에서는 홈 화면인 MainV2Activity로 이동한다.

2. Problem Statement

현재 CreatorChannelHomeViewModel.blockUser()는 차단 성공 시 성공 토스트만 emit한다.
그 결과 사용자가 차단한 크리에이터 채널 화면에 그대로 남아, 차단 이후에도 차단 대상의 채널 콘텐츠를 보는 부자연스러운 상태가 된다.
딥링크·푸시 진입처럼 이전 화면이 없는 경우 단순 종료만 하면 앱 내 안전한 목적지가 부족할 수 있다.

문제를 해결했다는 판단은 차단 API 성공 후 현재 CreatorChannelActivity가 종료되고, task root 상태에서는 MainV2Activity가 fallback으로 시작되는 것으로 한다.

3. Goals

3.1 제품 목표

사용자는 차단 성공 후 현재 크리에이터 채널에서 즉시 빠져나간다.
일반 진입에서는 Android 뒤로가기와 같은 의미로 이전 화면으로 돌아간다.
이전 화면이 없는 푸시·딥링크 진입에서는 홈인 MainV2Activity로 이동한다.

3.2 UX 목표

기존 차단 확인 모달과 성공 토스트는 유지한다.
API 성공 전에는 화면을 이탈하지 않는다.
API 실패 시에는 현재처럼 오류 토스트만 표시하고 화면에 머문다.

4. Non-Goals

차단 API 계약, 차단 대상 식별자, 서버 응답 형식을 변경하지 않는다.
MainV2Activity 자체의 홈 탭 구조나 초기 탭 정책을 변경하지 않는다.
차단 목록, 차단 해제, 차단된 크리에이터 콘텐츠 필터링 정책은 이번 범위에 포함하지 않는다.
app/src/androidTest, 기기·에뮬레이터 조작, 스크린샷 기반 검증은 이번 계획에 포함하지 않는다.

5. Target Users and Permissions

사용자	목표	주요 작업	사용 환경
로그인 사용자	원하지 않는 크리에이터를 차단하고 해당 채널에서 벗어난다	크리에이터 채널 더보기 > 차단 확인	Android 앱

인증 주체: 기존 SharedPreferenceManager.token 기반 로그인 사용자.
허용 조건: 기존 크리에이터 채널 차단 액션을 수행할 수 있는 상태.
거부 조건: API 실패, 네트워크 오류, CreatorChannelHomeUiState.Content 미준비 상태.

6. 핵심 사용자 흐름

사용자가 CreatorChannelActivity에서 더보기 메뉴를 연다.
사용자가 차단을 선택하고 기존 확인 모달에서 확인한다.
앱은 기존 homeActionDelegate?.blockUser() 경로로 차단 API를 호출한다.
API 성공 시 기존 차단 성공 토스트를 표시하고 현재 크리에이터 채널에서 이탈한다.
CreatorChannelActivity.isTaskRoot == false이면 finish()로 이전 화면에 돌아간다.
CreatorChannelActivity.isTaskRoot == true이면 MainV2Activity를 시작한 뒤 현재 CreatorChannelActivity를 종료한다.
API 실패 또는 예외 발생 시 기존 unknown error toast를 표시하고 현재 화면에 머문다.

7. 정보 구조와 라우팅

CreatorChannelActivity
  block success, isTaskRoot=false -> finish() -> previous Activity
  block success, isTaskRoot=true  -> MainV2Activity -> finish()

홈 fallback 대상은 kr.co.vividnext.sodalive.v2.main.MainV2Activity다.
fallback은 차단 성공 후 현재 Activity가 task root일 때만 수행한다.

8. 기능 요구사항

ID	상태	요구사항	수용 기준	계약/Goal 연결
`CCB-001`	확정	차단 성공은 화면 이탈 이벤트를 발생시킨다.	`CreatorChannelHomeViewModel.blockUser()`가 `ApiResponse.success == true`일 때만 one-shot 차단 성공 이벤트를 emit한다.	`P1-T1`
`CCB-002`	확정	API 성공 전에는 화면 이탈을 시작하지 않는다.	`showUserBlockDialog()`의 확인 콜백은 기존처럼 `homeActionDelegate?.blockUser()`만 호출하며 직접 `finish()` 또는 홈 이동을 하지 않는다.	`P1-T2`
`CCB-003`	확정	일반 진입에서는 이전 화면으로 돌아간다.	`CreatorChannelActivity.isTaskRoot == false`이면 `finish()`만 호출한다.	`P1-T2`
`CCB-004`	확정	이전 화면이 없는 진입에서는 홈으로 이동한다.	`CreatorChannelActivity.isTaskRoot == true`이면 `MainV2Activity` intent를 시작하고 현재 Activity를 종료한다.	`P1-T2`
`CCB-005`	확정	기존 성공/실패 feedback은 유지한다.	성공 시 `creator_channel_block_success`, 실패·예외 시 `common_error_unknown` toast 흐름을 유지한다.	`P1-T1`

9. UI/UX Expectations

신규 UI는 없다.
기존 차단 확인 모달 문구와 버튼은 변경하지 않는다.
성공 후 이동은 추가 확인 없이 즉시 수행한다.

10. API 계약

신규 API는 없다.
기존 호출 경로: CreatorChannelRepository.blockUser(userId, token).
성공 판단은 기존 ApiResponse.success를 따른다.

11. 보안과 데이터 취급

token, URL, 사용자 식별자 등 민감 정보는 로그·Toast·문서 fixture에 추가 노출하지 않는다.
실패 시 서버 오류 상세를 사용자에게 직접 노출하지 않고 기존 unknown error toast를 유지한다.

12. 성공 기준

12.1 기능 수용 기준

차단 성공 시 CreatorChannelHomeViewModel이 성공 토스트와 차단 성공 이벤트를 emit한다. (CCB-001, CCB-005)
차단 실패 또는 예외 시 차단 성공 이벤트가 emit되지 않는다. (CCB-001, CCB-005)
CreatorChannelHomeFragment가 차단 성공 이벤트를 consume한 뒤 Host에 전달한다. (CCB-001)
CreatorChannelActivity가 isTaskRoot에 따라 이전 화면 복귀 또는 MainV2Activity fallback을 수행한다. (CCB-003, CCB-004)
확인 모달의 confirm callback은 API 성공 전 직접 이동하지 않는다. (CCB-002)

12.2 검증 기준

CreatorChannelHomeViewModelTest focused unit test가 통과한다.
CreatorChannelActivitySourceTest focused source contract test가 통과한다.
변경 파일 compile, ktlint 범위 검증이 통과하거나 기존 전역 blocker를 문서에 기록한다.

13. Open Questions

ID	상태	결정 필요 사항	현재 결정	결정 주체	영향 Goal
`OQ-001`	확정	뒤로가기 의미	현재 `CreatorChannelActivity`에서 빠져나가 이전 화면으로 돌아가는 의미	사용자	`P1-T2`
`OQ-002`	확정	이전 화면이 없는 경우 fallback	`MainV2Activity`로 이동	사용자	`P1-T2`

14. 요구사항 추적표

요구사항 범위	API Contract	계획 Phase	Goal	자동 검증	수동 검증
`CCB-001`, `CCB-005`	기존 `blockUser`	1	`P1-T1`	`CreatorChannelHomeViewModelTest`	없음
`CCB-002~004`	없음	1	`P1-T2`	`CreatorChannelActivitySourceTest`	없음

15. Decision Log

날짜	ID	상태	결정	근거	영향 요구사항·계약·Goal
`2026-08-14`	`DEC-001`	확정	차단 성공 후 현재 크리에이터 채널에서 이탈한다.	사용자 요청	`CCB-001~005`, `P1-T1`, `P1-T2`
`2026-08-14`	`DEC-002`	확정	일반 진입은 `finish()`로 이전 화면에 돌아가고, task root는 `MainV2Activity`로 fallback한다.	사용자 확인	`CCB-003`, `CCB-004`, `P1-T2`

Verification Log

2026-08-14: 현재 구현 맥락을 확인했다. CreatorChannelHomeViewModel.blockUser()는 성공 토스트만 emit하고, CreatorChannelActivity.showUserBlockDialog()는 확인 시 homeActionDelegate?.blockUser()를 호출한다. 이번 문서 작성 요청에 따라 production code와 test code는 변경하지 않았다.
2026-08-14: 승인 후 CreatorChannelHomeViewModel의 차단 성공 one-shot event, CreatorChannelHomeFragment.Host 전달, CreatorChannelActivity의 isTaskRoot 기반 MainV2Activity fallback을 구현했다. ViewModel/source contract RED를 각각 확인한 뒤 최소 구현으로 GREEN 전환했다.
2026-08-14: focused test 통합 실행, compileDebugKotlin, ktlintCheck, git diff --check가 성공했다. 전체 testDebugUnitTest는 1,221개 중 이번 변경과 무관한 CreatorChannelFanTalkFragmentLayoutTest 일본어 문구 기대값 불일치 1건으로 실패했으며, 실패 test와 locale string 파일은 현재 diff에 포함되지 않는다.
2026-08-14: Phase 1 재리뷰에서 이전 문서 정합성 blocker 해소를 확인하고 최종 APPROVE 판정을 받았다.
2026-08-14: 후속으로 CreatorChannelFanTalkFragmentLayoutTest의 일본어 empty message 기대값을 현재 values-ja/strings.xml의 팬레터 문구와 맞췄다. focused Fan Talk layout test와 전체 testDebugUnitTest가 BUILD SUCCESSFUL로 통과했다.

9.6 KiB Raw Blame History