| 어드민 입력 | DB 테이블 | 반영되는 곳 | 관련 문서 |
|---|---|---|---|
| 인터넷+TV 상품 03~05번 |
speeds / tv / settop / wifi | InternetSelectCard(바텀시트) · 고객 상품 카드 · AI 채팅 · 티켓 자동 생성 · 현금 페이백 금액 · CRM | 인터넷+TV · 티켓 |
| 렌탈 상품 06번 |
rental_products | RentalSelectCard(바텀시트) · 렌탈 카드 · AI 채팅 · 티켓(R001~) · 신청현황 · CRM | 렌탈 · 티켓 |
| 중고폰 시세 07번 |
used_phone_prices | UsedPhoneSelectCard(바텀시트) · TradeinCard · AI 채팅 · 매입 접수 · 중고폰 현황 | 중고폰 |
| 휴대폰 시세 08번 |
phone_prices | PhoneSelectCard(바텀시트) · MobilePriceCard · AI 채팅 · 매장별 시세 | 매장·시세 |
| 매장 정보 09번 |
stores | StoreCard · 고객 매장 페이지 · AI 채팅 매장 추천 | 매장·시세 |
| 현금 페이백 금액 상품관리 하단 |
어드민 수기 입력 | 고객 카드 · AI 채팅 · 신청서 · 현금 페이백관리 · CRM · 마이페이지 | 인터넷+TV · 현금 페이백 |
| 공시지원금 20번 |
subsidy_data | AI 채팅 공시/선택약정 비교 · 어드민 크롤링 관리 | 데이터 흐름도 |
| # | 트리거 | 대상 | 조건 | 관련 문서 |
|---|---|---|---|---|
| 1 | 현금 페이백 지급대기 자동 생성 | bongi_gifts (지급대기) | 계약완료 확인 (CRM) | 현금 페이백 |
| 2 | 포인트 자동 적립 (본인 계약) | bongi_cash_balance | 앱회원 + PASS 인증 | 포인트 |
| 3 | 친구초대 보상 (추천인+친구) | bongi_rewards | 양쪽 PASS 인증 완료 | 친구초대 |
| 4 | 비회원 → 앱 가입 유도 알림톡 | 카카오 알림톡 | 비회원인 경우 | 현금 페이백 |
| 5 | 회원관리 신청 건수 +1 | bongi_user_profiles | 전화번호 매칭 | 서비스 플로우 |
| 6 | 마이페이지 신청이력 반영 | bongi_applications | 앱회원만 | 신청현황 |
| 7 | 후기 작성 유도 앱 푸시 | 앱 푸시 | 설치완료 후 | 후기 |
| 유형 | 유입 경로 | 데이터 보유 |
|---|---|---|
| 앱회원 | 카카오/구글 로그인 | 이름·전화·소셜·PASS(선택)·마이페이지 |
| 비회원(셀프) | 셀프신청 | 이름·전화·주소·계좌 |
| 비회원(CRM) | 전화/매장 | 이름·전화 (CRM에서 수집) |
| 비회원(중고폰) | 매입 접수 | 이름·전화·생년월일·성별·통신사 (PASS 완료) |
| 기능 | PASS 필수 | 이유 | 관련 문서 |
|---|---|---|---|
| 현금 페이백 지급 | 필수 | 현금 지급 → 본인 확인 | 현금 페이백 |
| 포인트 출금 | 필수 | 현금 출금 → 본인 확인 | 포인트 |
| 포인트 적립 (전체) | 필수 | 어뷰징 방지 (CI 중복 체크) | 포인트 |
| 친구초대 보상 | 양쪽 필수 | 허위가입 방지 | 친구초대 |
| 중고폰 매입 접수 | 필수 | 매입금 지급 → 본인 확인 | 중고폰 |
| 후기 작성 (15,000P) | 필수 | 포인트 적립 전제 조건 | 후기 |
| 어드민 # | 메뉴 | 플로우 문서 | DB 테이블 |
|---|---|---|---|
| 01 | 대시보드 | 데이터 흐름도 | 전체 집계 |
| 02 | 회원 관리 | 서비스 플로우 | user_profiles |
| 03~05 | SKT / KT / LG U+ 상품 | 인터넷+TV | speeds / tv / settop / wifi |
| 06 | 렌탈 상품 | 렌탈 | rental_products |
| 07 | 중고폰 매입 시세 | 중고폰 | used_phone_prices |
| 08 | 휴대폰 시세 | 매장·시세 | phone_prices |
| 09 | 매장 관리 | 매장·시세 | stores |
| 10 | 티켓 관리 | 티켓 | tickets (156) |
| 11 | 신청 현황 | 신청현황 | applications |
| 12 | 중고폰 매입 현황 | 중고폰 | used_phone_buyback |
| 13 | 현금 페이백 관리 | 현금 페이백 | gifts |
| 14 | 포인트 관리 | 포인트 | cash_balance / withdrawals |
| 15 | 후기 관리 | 후기 | reviews (99) |
| 16 | 돈지키미 | 돈지키미 | user_alarms |
| 17 | 알림 관리 | 알림 | notifications |
| 20 | 공시지원금 | 데이터 흐름도 | subsidy_data (1,134) |
| 계층 | 기술 |
|---|---|
| 프론트 | React 19 + Vite + react-router-dom |
| API | Express (ES modules) · REST API |
| AI | Claude API (@anthropic-ai/sdk) |
| DB | Supabase (PostgreSQL) · 23개 테이블 |
| 어드민 | HTML 단일파일 (정적) · API fetch |
| 배포 | Railway · GitHub 자동 배포 |
| 크롤링 | Playwright (공시지원금) · 매일 09:00 KST |
| 경로 | 설명 |
|---|---|
| /api/products/* | 상품/카테고리/티켓/중고폰 카탈로그 |
| /api/stores | 매장 목록/상세 |
| /api/applications | 셀프신청 접수/조회 |
| /api/reviews | 후기 목록/작성/이미지 업로드 |
| /api/cash/* | 포인트 잔액/내역/출금/은행/정책 |
| /api/referrals/* | 추천코드/실적/등록/계약/보상정책 |
| /api/alarms | 돈지키미 CRUD |
| /api/chat/* | AI 채팅 세션/메시지/스트리밍 |
| /api/auth/* | 회원가입/로그인/소셜프로필 |
| 경로 | 설명 |
|---|---|
| /api/admin/platform/members | 회원 목록/상세(8탭)/동기화 |
| /api/admin/platform/applications | 신청 목록/상태·상품 변경 |
| /api/admin/platform/gifts | 현금 페이백 목록(회원 매칭)/상태 변경 |
| /api/admin/platform/cash/* | 출금 목록(회원 매칭)/승인(조건검증)/적립내역/수동적립 |
| /api/admin/platform/don-jikimi | 돈지키미 목록(회원 매칭)/상태 변경 |
| /api/admin/platform/notifications | 알림 목록(회원 매칭)/수동발송/재발송 |
| /api/admin/platform/used-phone-buyback | 중고폰 매입현황 |
| /api/admin/platform/subsidy | 공시지원금/벌크삽입/크롤링 |
| /api/admin/platform/tickets | 티켓 목록/동기화 |
| 항목 | 상태 | 비고 |
|---|---|---|
| DB 상태값 | 전부 한글 | 신청완료/상담중/계약완료/지급대기/지급완료/승인/대기/반려/적립/출금 등 |
| 회원 동기화 | 구현 완료 | member-sync.js — 전화번호 기준 전체 테이블 동기화 |
| 중고폰 매입 | 분리 완료 | 신청현황에서 분리 → bongi_used_phone_buyback 별도 관리 |
| 출금 조건 검증 | 구현 완료 | 승인 시 5만P+PASS+계좌+계약1회 자동 검증 |
| Race Condition | 수정 완료 | deduct_cash_balance/add_cash_balance RPC 원자적 처리 |
| 출금 반려 환불 | 구현 완료 | 반려 시 잔액 복구 + cash_history 환불 기록 |
| SQL Injection | 방지 완료 | sanitizeSearch() 적용 |
| 공시지원금 크롤링 | 정상 작동 | Playwright dynamic import + 매일 09:00 KST |
| 이미지 자동 리사이즈 | 구현 완료 | 후기/중고폰 사진 자동 압축 |
| 마이페이지 API 연동 | 4/8 완료 | Home/Applications/Points/Gifts 완료. Referral/MoneyGuard/Profile/BankAccount 미완 |
| 어드민 API 인증 | 미적용 | MVP 단계 — 출시 직전 authenticateJWT 적용 예정 |
| API | Method | URL | 설명 |
|---|---|---|---|
| 상품 조회 | GET | /api/products | 전체 상품 |
| 신청 접수 | POST | /api/applications | 신청서 제출 |
| 채팅 AI | POST | /api/ai/chat | Claude AI 채팅 |
| 현금 페이백 | GET | /api/admin/platform/gifts | 현금 페이백 관리 |
| 출금 요청 | POST | /api/cash/withdraw | 캐시 출금 |
| 친구초대 | GET | /api/referrals/my-code | 추천코드 조회 |
| 돈지키미 | GET | /api/alarms | 알람 목록 |
| 후기 | GET/POST | /api/reviews | 후기 CRUD |
| 회원 프로필 | GET | /api/user/profile | 내 정보 |
| 계좌 관리 | GET/POST | /api/user/bank-account | 계좌 CRUD |
| 주소 관리 | GET/POST | /api/user/addresses | 주소 CRUD |