봉이모바일 — 현금 페이백 관리 플로우

현금 페이백 = 전액 현금 지급. 계약 완료 시 bongi_gifts에 "지급 대기" 레코드 자동 생성.
고객이 앱회원 가입 + PASS 본인인증 + 계좌 등록을 모두 완료하면 등록 계좌로 현금 입금.

계약 완료
(어드민/CRM)

→

bongi_gifts
지급대기 자동 생성

→

조건 체크
앱회원+PASS+계좌

→

조건 충족 시
현금 지급

인터넷+TV (현금)

속도 + TV결합 여부로 금액 결정
예: SKT 500M + TV결합 = 43만원
어드민에서 통신사별 수기 입력

렌탈 (현금 or 반값할인)

현금: 고정 금액 계좌 입금 (예: 15만원)
반값할인: 약정 초반 월요금 50% 할인
상품별 어드민에서 종류/금액 설정

앱회원 가입

봉이모바일 앱에서 회원가입
비회원은 지급 불가
필수

PASS 본인인증

PASS 인증 완료
CI 값으로 본인 확인
필수

계좌 등록

은행명 + 계좌번호 + 예금주
bongi_user_profiles에 저장
필수

비회원 상태
(신청만 완료)

→

앱 회원가입
(알림톡 유도)

→

PASS 인증
(본인확인)

→

계좌 등록
(은행/계좌/예금주)

→

3가지 충족
→ 지급 가능

비회원 = 현금 페이백 지급 불가. 비회원은 "비회원 대기" 상태로 표시. 앱 가입 → PASS 인증 → 계좌 등록 완료 시 "지급 대기"로 전환.

인터넷+TV — 속도 + TV결합별 금액 (어드민 수기 입력)

SKT

구성	100M	500M	1G
인터넷 단독	11만	17만	17만
인터넷+TV	40만	43만	49만

구성	100M	500M	1G
인터넷 단독	9만	14만	14만
인터넷+TV	37만	45만	45만

LG U+

구성	100M	500M	1G
인터넷 단독	20만	23만	23만
인터넷+TV	40만	47만	47만

렌탈 — 현금 or 반값할인 (상품별 설정)

현금 지급

고정 금액을 계좌로 직접 입금
예: LG 퓨리케어 28평 → 현금 15만원
상품별 어드민에서 금액 설정

반값할인

약정 초반 월요금 50% 할인 적용

약정	반값 기간
3년	3개월
5년	6개월
6년	9개월
7년	12개월
8년	15개월

현금 페이백 금액 데이터 파생 경로 (한 곳 입력 → 6곳 사용)

어드민에서
현금 페이백 금액 입력
(속도+TV결합별)

→

고객 상품 카드 "현금 현금 페이백 43만"

AI 채팅 응답 "현금 페이백 43만원"

신청 접수 시 bongi_applications.gift_amount

현금 페이백관리(13번) bongi_gifts 지급대기

CRM 상담사 화면 현금 페이백 금액 표시

마이페이지 현금 페이백 지급 현황

변경 시 신규 신청부터 적용. 기존 계약 건은 계약 시점 금액 유지. 통신사별 각각 다르게 설정 가능.

비회원이 신청한 경우 — 현금 페이백 지급을 위해 앱 가입을 유도하는 알림톡 3단계 자동 발송

단계	발송 시점	내용	목적	발송
1차	신청 완료 즉시	"앱 가입 + 계좌 등록 시 현금 페이백 즉시 지급"	최초 가입 유도	자동
2차	계약 완료 시	"현금 페이백 OO만원 준비됨 → 앱 가입 → PASS 인증 → 계좌 등록 → 즉시 입금"	구체적 금액 안내 + 절차 안내	자동
3차	D+7 (미가입 시)	"현금 페이백이 아직 대기 중이에요 → 계좌 등록 즉시 입금"	리마인더 (긴급감 조성)	자동

비회원 신청

→

1차 알림톡
(즉시)

→

2차 알림톡
(계약완료)

→

3차 알림톡
(D+7 리마인더)

→

앱 가입 유도
→ 조건 충족

어드민에서 수동 알림톡 발송도 가능: 현금 페이백관리 테이블에서 비회원 대기 건의 "알림톡" 버튼 클릭.
지급 보류 건도 알림톡 발송 가능 — 보류 사유 해소 유도 목적.

상태 전이 다이어그램

지급대기

→

지급완료

지급대기

→

보류

→

지급완료

상태	DB 값	의미	어드민 액션
지급대기	지급대기	계약완료 → 자동 생성. 3가지 조건 충족 상태.	지급 보류
비회원대기	비회원대기	비회원이라 조건 미충족. 앱 가입 유도 중.	알림톡
지급완료	지급완료	현금 입금 완료. paid_at 기록.	-
보류	보류	사유 발생으로 보류 (확인 필요).	지급 알림톡

API 호출

Method	Endpoint	Body	설명
GET	/admin/platform/gifts	?status=지급대기	현금 페이백 목록 (status 필터 가능). limit 100.
PATCH	/admin/platform/gifts/:id	{ status: '지급완료' }	지급 처리. paid_at 자동 기록 (현재 시간).
PATCH	/admin/platform/gifts/:id	{ status: '보류' }	보류 처리.

KPI (5개)

지급 대기

비회원 대기

1,823

지급 완료

지급 보류

1,901

전체

필터

상태 전체 지급 대기 비회원 대기 지급 완료 지급 보류

유형 전체 앱회원 비회원 이름 / 전화번호 / 티켓번호 검색 엑셀 다운로드 일괄 지급처리

현금 페이백 목록 테이블

이름	연락처	유형	유입경로	티켓번호	상품	현금 페이백(현금)	계약완료일	본인인증	계좌	상태	관리
홍길동	010-1234-5678	앱회원	셀프신청	KT0311	KT 1G+지니TV모든G+기가지니3	45만	2026.04.03	인증완료	국민 123-456-789012	지급 대기	지급 보류
이영희	010-3456-7890	비회원	셀프신청	LG0079	LG U+ 500M+프리미엄+UHD4	47만	2026.03.15	미인증	미등록	비회원 대기	알림톡
정수민	010-6789-0123	앱회원	셀프신청	R015	LG 퓨리케어 공기청정기 28평	15만	2026.04.06	인증완료	카카오뱅크 3333-01-1234567	지급 대기	지급 보류
강민준	010-0123-4567	앱회원	셀프신청	KT0146	KT 500M+지니TV베이직+기가지니A	45만	2026.03.20	인증완료	우리 1002-123-456789	지급 완료	-
한지민	010-7890-1234	비회원	CRM등록	-	LG U+ 인터넷+TV	40만	2026.03.25	미인증	미등록	지급 보류	지급 알림톡

100건씩 로드 · 상태/유형/검색어 필터 · 체크박스 일괄 지급처리

관리 버튼별 동작

버튼	조건	동작
지급	지급대기 / 보류 상태	PATCH /gifts/:id { status: '지급완료' } → paid_at 기록
보류	지급대기 상태	PATCH /gifts/:id { status: '보류' }
알림톡	비회원대기 / 보류 상태	수동 알림톡 발송 (앱 가입 유도)
일괄 지급처리	체크박스 선택 건	선택된 건 일괄 지급완료 처리
엑셀 다운로드	전체	현재 필터 기준 엑셀 파일 다운로드

이름 클릭: 회원 상세 팝업 열림 (findAndOpenMember) → 기본정보, 계좌, 신청이력, 현금 페이백탭 등 확인 가능
티켓번호: 셀프신청/티켓 접수 시 자동 기록. CRM 등록 건은 티켓번호 없음 (-)

Gifts.jsx — 고객이 마이페이지에서 보는 화면

KT 인터넷+TV 500Mbps

지급 예정일 2026.05.01

지급 대기

370,000원

LG 정수기 렌탈

지급 완료 2026.03.10

지급 완료

150,000원

UI 컴포넌트 구조

요소	표시 내용	스타일
제목	"현금 페이백 현황"	18px / 700 / #1a2744
부제	"설치 완료 후 현금으로 지급됩니다"	13px / #999
카드 - 대기	상품명 + 지급 예정일 + 금액	배경 #fef3c7 / 테두리 #fcd34d / 금액 orange
카드 - 완료	상품명 + 지급 완료일 + 금액	배경 #fff / 테두리 #e5e7eb / 금액 green
상태 배지	"지급 대기" / "지급 완료"	pill 스타일 (11px/700)

앱회원만 확인 가능. 비회원은 마이페이지 접근 불가.
파일: client/src/pages/my/Gifts.jsx

케이스	상황	처리
비회원 장기 미가입	3차 알림톡(D+7) 이후에도 미가입	비회원 대기 유지. 어드민에서 수동 알림톡 추가 발송 가능.
PASS 인증만 미완료	앱 가입 + 계좌 등록했으나 PASS 미인증	지급 불가. 본인인증 "미인증" 표시. 지급 대기 유지.
계좌 미등록	앱 가입 + PASS 인증했으나 계좌 미등록	지급 불가. 계좌 "미등록" 표시. bongi_user_profiles 계좌 필드 비어있음.
CRM 등록 건	콜센터에서 직접 접수한 건 (티켓번호 없음)	티켓번호 "-" 표시. 상품명은 텍스트로 기록. 현금 페이백 금액 수기 입력.
렌탈 반값할인	현금 지급이 아닌 반값할인 프로모션	현금 페이백 금액에 "반값할인" 표시. 계좌 입금 아닌 월요금 할인 적용.
지급 보류	확인이 필요한 건 (예: 계약 취소 우려, 정보 불일치)	어드민에서 "보류" 클릭 → hold 상태. 확인 후 "지급" 가능.
현금 페이백 금액 변경	어드민에서 현금 페이백 금액 수정	신규 신청부터 적용. 기존 계약 건은 계약 시점 금액 유지.

컬럼	타입	설명
id	integer PK	자동 증가
status	text	'지급대기' / '지급완료' / '보류' / '실패' / '취소' / '비회원대기'
paid_at	timestamptz	지급 완료 시각 (paid 시 자동 기록)
created_at	timestamptz	생성 시각 (계약완료 시 자동)

연관 테이블:
bongi_applications — 신청 건 (gift_amount 필드에 현금 페이백 금액 기록)
bongi_user_profiles — 회원 정보 (bank_name, account_number, account_holder 계좌 필드)
bongi_user_profiles — PASS 인증 (ci, verified_at 필드)

회원관리 팝업 연동

현금 페이백관리에서
이름 클릭

→

회원 상세 팝업
(findAndOpenMember)

→

기본정보 (이름/전화/생년월일)

계좌정보 (은행/계좌/예금주)

신청/계약이력

현금 페이백내역 (대기/완료/보류)

포인트내역

어드민	https://bongi-mobile-production.up.railway.app/admin/	13 현금 페이백관리
GitHub	https://github.com/vinsenzo83/bongi-mobile	소스코드
어드민 UI	server/public/admin/index.html	1700줄~ 현금 페이백관리 섹션
API 라우트	server/routes/admin-platform.js	GET /gifts, PATCH /gifts/:id
고객 UI	client/src/pages/my/Gifts.jsx	마이페이지 현금 페이백 현황
현금 페이백 금액 데이터	server/data/providers/all_providers.json	gift_100m / gift_500m / gift_1g
인터넷+TV 플로우	docs/flow-internet-tv.html	현금 페이백 금액 편집 상세
렌탈 플로우	docs/flow-rental.html	렌탈 현금 페이백 종류 (현금/반값)