PlanLimitDialog — 샘플 & 시나리오

공통 한도 안내 모달 (머지 완료: alpha #9393 · beta #9394) · 아이콘·에러코드 미표시 · 6개 언어 · 2026-07-02

동작 — 포그라운드 액션(그룹 저장·캠페인 활성화)이 한도로 막히면 빨간 토스트 대신 아래 기능 맞춤 안내 모달이 뜬다. SSOT: parsePlanLimitError + useHandlePlanLimitError + 전역 atom + DashboardLayout 1회 마운트.

1. 모달 샘플 (기능별 4종 · 실제 머지 디자인)

제목/설명 AlertDialog primitive · CTA 2개(나중에=Cancel 좌 / 플랜 업그레이드=Action 우 →navigate('/upgrade')). 아이콘 없음, 에러코드 화면 노출 없음(코드는 백엔드 로그·내부 매핑 전용).

2. 다국어 카피 (검색 예시 · 6개 언어)

언어제목설명
한국어이번 달 바이어 검색 한도를 모두 사용했어요상위 플랜으로 올리면 더 많은 바이어를 검색할 수 있어요.
EnglishYou've used all your buyer searches this monthUpgrade your plan to search more buyers.
日本語今月のバイヤー検索の上限に達しましたプランをアップグレードするとより多くのバイヤーを検索できます。
中文本月的买家搜索次数已用完升级方案即可搜索更多买家。
BahasaAnda telah menggunakan semua pencarian pembeli bulan iniTingkatkan paket Anda untuk mencari lebih banyak pembeli.
ไทยคุณใช้การค้นหาผู้ซื้อของเดือนนี้ครบแล้วอัปเกรดแผนเพื่อค้นหาผู้ซื้อได้มากขึ้น

3. 현재 플랜별 기능 제한 (라이브 · alpha=beta)

플랜검색 월/일/시바이어 저장발송 월/일이메일 계정상품WS체험
무료체험10 / 3 / 23005,000 / 20013114일
Pro50 / 10 / 31,0005,000 / 200131-
Team무제한 / 20 / 53,00015,000 / 2,0003무제한3-
Enterprise전 항목 무제한 (맞춤)
Infinite (내부)전 항목 무제한

모달은 이 한도를 초과할 때 뜬다. Team 검색은 월 무제한이라 검색 한도 모달이 뜨지 않음(시간 5·일 20 안전레일만 유지). 무제한 항목은 애초에 차단되지 않아 모달 대상 아님.

4. 시나리오별 동작 & 예상 결과

#행동조건에러 code(내부)예상 결과
1바이어 검색 실행검색 한도 소진monthly_limit_exceeded모달(검색)
2/leads 그룹 추가(사전체크)저장 한도 초과 예상checkLimit=false모달(바이어) · 토스트 제거
3/leads 그룹 추가(서버 throw)사후 초과USAGE_MONTHLY_LIMIT_EXCEEDED모달(바이어)
4캠페인 활성화발송 월 한도 소진PLAN_EMAIL_MONTHLY_LIMIT_REACHED모달(발송)
5캠페인 활성화주소 미입력LEGAL_ADDRESS_REQUIRED기존 주소 모달 우선
6실제 발송(백그라운드)발송 중 한도send-time모달 없음(정상) defer/알림
7Team 검색월 무제한(null)모달 없음(정상)
8관리자 액션admin bypass모달 없음(정상)
9네트워크/기타 에러한도 무관기타기존 토스트 유지

5. 행동 → 예상 결과 (요약)