fix(setting): 설정 수신자 목록 0건에 안내와 등록 진입점을 그린다 (#556 분리) #2086

작업 유형

bug — 버그·오동작

주 담당 모듈

setting — 설정

개요

설정 > 수신자 목록(ReceiverManageScreen)은 등록된 수신자가 0건이면 LazyColumn 이 아무 항목도 내지 않아 상단바만 남은 빈 화면이 된다. 안내 문구도, 수신자를 등록하러 갈 진입점도 없다. 노션 2차 QA(2026-07-28) 6번이 짚은 항목이다.

상위 추적 이슈 #556 은 목록 0건과 검색 결과 0건 두 축을 한 이슈에 담고 있다. 이 화면만 지금 닫을 수 있어 그 축을 분리한다. 이 화면에는 검색창 자체가 없어 검색 0건 축이 해당하지 않는다.

기준 리비전은 origin/develop 7d87aa3f4 이고 아래 값은 그 리비전에서 다시 잰 것이다.

• feature/setting/presentation/.../screen/ReceiverManageScreen.kt:46-59 가 Scaffold 본문에 LazyColumn + items(receivers) 뿐이고 빈 분기가 없다.
• git grep "등록된 수신자가 없습니다" 가 저장소 전체에서 0건이다.
• 등록 목적지는 이미 있다. SettingNavActions.onNavigateToRecipientRegister 를 설정 홈의 수신자 등록 메뉴가 쓰고 있어서 목적지도 액션도 새로 늘릴 것이 없다.

완료 조건

• receivers 가 비면 목록 대신 안내 문구와 등록 CTA 를 그린다. 문구는 시안 3628:23840 의 "등록된 수신자가 없습니다." 와 수신자 등록하기다.
• 등록 CTA 가 설정의 수신자 등록 화면으로 간다. 새 목적지를 만들지 않고 onNavigateToRecipientRegister 를 재사용한다.
• 빈 상태 본체와 CTA 가 한 컴포저블 안에 묶인다. 뒤에 fix(setting): 수신자 목록의 조회 상태와 재시도를 연결한다 #1281 의 목록 상태 슬롯으로 본체를 옮길 때 CTA 만 슬롯 밖에 남아 등록 진입점을 다시 잃지 않게 한다.
• 0건 분기와 목록 분기를 양쪽에서 잠그는 단위 테스트가 붙는다. 안내 문구와 CTA 가 떠야 하는 쪽, 목록이 있을 때는 새지 않아야 하는 쪽 둘 다다.
• 0건 상태 @Preview 가 있다.
• feature/setting 유닛 테스트와 ktlint 를 통과한다.

참고

• 상위 추적은 수신자 목록 0건·검색 결과 0건에 안내 없이 빈 화면 #556 이다. 이 이슈 하나로는 수신자 목록 0건·검색 결과 0건에 안내 없이 빈 화면 #556 이 닫히지 않아서 blocked_by 로 잇는다.
• 수신자 목록 0건·검색 결과 0건에 안내 없이 빈 화면 #556 에 남는 검색 결과 0건 축은 지금 못 한다. 검색어를 core:ui ReceiverSelectScreen 의 private 스캐폴드가 쥐고 있어 그 안에서 닫아야 하는데, 분기를 넣을 items 블록을 PR fix(core): 초성 점프 인덱스를 렌더되는 행에서 파생 (#939) #2057 이 receiverRows 평탄화로 재작성 중이다.
• 설정 사후 전달 조건 선택 화면(ReceiverListScreen)의 0건은 이 범위가 아니다. 설정 사후 전달 조건 메뉴의 최종 진입 경로 확정 #1998 PM 답변에 걸린 fix(setting): 수신자 목록 조회 상태와 재시도 연결 (#1281) #2051 의 목록 상태 분기에 얹힌다.
• 타임레터 RecipientListScreen 은 공용 컴포넌트를 쓰지 않는 별개 구현이라 이 화면 수정에 딸려 오지 않는다.
• 시안 노드 번호는 수신자 목록 0건·검색 결과 0건에 안내 없이 빈 화면 #556 의 2026-08-23 코멘트에서 옮긴 값이다. 이 세션은 Figma 에 접근하지 못해 다시 열어 대조하지 못했다. 같은 코멘트가 0823 파일 재편으로 인용 프레임이 back up 페이지 소재가 됐다고 적어 두었으니, 착수 시점에 현행 정본(4327 대역)에 대응 노드가 있는지부터 확인한다.

실기동 화면

에뮬레이터 Pixel 7(API 34) 실기동, QA823 계정, 실서버 afternote.kro.kr. 설정 > 수신자 목록에 같은 경로로 들어간 두 빌드다. 현행은 상단바만 남고, 이 이슈의 구현분은 안내와 등록 진입점을 그린다.