관리 백엔드

admin-next 사용자 관리 상세 팝업——UserDetailModal 이중 컬럼 레이아웃 + Tab 분할 + 기기 제어 및 계정 정지

admin-next UI 컴포넌트 라이브러리 – 12가지 기본 컴포넌트: Button, Card, Modal, Input, Select, Switch, Badge, Toast, Dropdown, ImageUpload, Breadcrumbs

admin-next UI 컴포넌트 라이브러리에 대한 종합적인 안내서 — React, Tailwind CSS, Framer Motion으로 구축된 12가지 재사용 가능한 컴포넌트. Button, Card, Modal, Input, Select, Switch, Badge, Toast, Dropdown, ImageUpload, Breadcrumbs 및 유틸리티 내보내기를 다룹니다.

admin-next Server Prefetch + ISR——Server Component 데이터 가져오기와 증분 정적 재생성

admin-next의 서버 측 데이터 가져오기 전략에 대한 심층 분석 — Server Components용 serverGet 유틸리티, 태그 기반 ISR 재검증, 그리고 캐시 무효화를 위한 Server Actions.

보안 도구 체인: Zod 검증 + PII 마스킹 + XSS 방어

security-utils.ts 모듈은 관리 백엔드의 프론트엔드 보안 도구 키트로, 276줄에 걸쳐 Zod 입력 검증, PII 데이터 마스킹, XSS 방어, SQL 인젝션 휴리스틱 탐지, 비밀번호 강도 평가 등 다섯 가지 보안 관심사를 다룹니다.

admin-next 라우트 구성 체계 — 8개의 라우트 그룹, 27개의 라우트 및 lucide-react 아이콘 매핑

admin-next 라우트 구성 시스템에 대한 심층 분석 — RouteConfig 타입 시스템, 27개의 라우트 정의가 포함된 8개의 라우트 그룹, lucide-react 아이콘 매핑 전략, 메타데이터 매칭을 위한 숨겨진 라우트, 그리고 내비게이션/권한 부여 통합.

등록 신청 승인 워크플로우 — 관리자 계정 자가 신청부터 권한 개설까지의 전체 링크

admin-next 상품 CRUD——CreateProductFormModal + EditProductFormModal：react-hook-form 다중 섹션 폼과 이미지 업로드

Prisma 데이터베이스 스키마 설계: 30개 이상 모델의 계층적 아키텍처와 모범 사례

결제 Webhook & 콜백 처리 심층 분석 — 낙관적 락, 멱등성, 원자적 지갑 연산

PaymentWebhookController (단일 엔드포인트 라우팅 + callback-token 인증) → handleUniversalWebhook (충전/출금 분기) → handleInvoiceWebhook (updateMany 낙관적 락 + creditCash) → handlePayoutWebhook (원자적 unfreeze + CRITICAL 폴백) → WalletService (ensureWallet / creditCash / freezeCash / unfreezeCash + beforeBalance/afterBalance 감사 내역) 심층 분석

결제 프로세스 전체 체인 — API Xendit → Flutter App → admin-next 재무 심사

NestJS PaymentService (Xendit Invoice/Payout 게이트웨이) → ClientWalletService (충전/출금/Webhook 콜백 비즈니스) → admin-next Finance 페이지 (WithdrawalList, DepositList, TransactionList)