프로젝트 배경
월세 납부 요청·승인 흐름, KG이니시스 서버사이드 HMAC 서명, 대법원 등기정보광장 API 연동 등 전자금융거래법 표준 PG 연동 수준의 워크플로우를 먼저 파악하고, 5단계 요청서 작성부터 카드 결제·거래명세서 발급까지 엔드-투-엔드를 사전 구현했습니다. 임차인·임대인 정보 입력, 관리자 승인/반려, 이체 완료 확인 등 핵심 운영 시나리오 3가지를 사전에 검증해둔 덕분에, 협의 즉시 착수해 현장에서
프로젝트 성과
임차인·관리자 15개 화면 전 흐름 즉시 사용 가능
5단계 요청 작성부터 관리자 승인·이체 완료까지 15개 화면, 로그인부터 결제 완료까지 실제 사용 흐름 직접 검증
KG이니시스 HMAC-SHA256 결제 연동 검증 완료
sandbox MID·서버사이드 HMAC 서명·결제 완료 콜백 처리까지 PG 연동 전 흐름 파일럿 내 구현·확인
임차인·관리자 세션 분리 — 권한 침범 0건
NextAuth.js ROLE 기반 분기, 임차인↔관리자 쿠키 세션 격리로 교차 접근 차단, 무인가 API 호출 시 403 응답 검증
5단계 입력 + 대법원 등기 API 연동 직접 검증
주소 검색·임대인 계좌 입력·납부 예정일까지 5단계 폼 + 대법원 등기정보광장 API 연동을 파일럿 내 실구현·검증
관리자 KPI 대시보드 실DB 기반 실시간 집계
승인 대기·처리 완료·월수수료·누적 수입 4개 KPI를 실DB 기반으로 집계, 관리자 화면에서 즉시 확인 가능한 상태 구현
핵심 기능
진행 단계
공고 분석 및 아키텍처 설계
2026.05.
요구사항 분석, 5단계 요청 흐름·ROLE 분기·PG 연동 포인트를 사전 식별하고 기술 스택(Next.js 14+Prisma+NextAuth) 확정
프로젝트 상세
임차인이 직접 월세 납부 요청서를 작성하면 운영사 관리자가 검토·승인한 뒤 카드 결제를 진행하고, 결제 금액이 임대인 계좌로 자동 이체되는 월세 대납 서비스 파일럿입니다. Next.js 14 App Router + Prisma 5 + NextAuth.js v4 조합으로 임차인·관리자 분리 UI 15개 화면, API Route 15개를 단일 코드베이스로 구현했습니다. [임차인 요청 플로우] 5단계 요청서







