← 포트폴리오 목록

프리미엄 프라이빗 매칭 플랫폼

프리미엄 프라이빗 매칭 서비스의 핵심 플로우 — 서류 인증 회원가입, 매칭 홈, 호감·매칭 성사, 포인트 결제를 React Native와 Node.js 기반으로 설계·구현합니다.

매칭 상태 머신 설계전송·수락·거절·확정 4단계 상태를 Prisma enum으로 관리하는 매칭 상태 전이 로직 구현
포인트 이중기입 원장 구축충전·차감 내역을 이중기입 방식으로 기록하는 포인트 원장 테이블 설계, 트랜잭션 정합성 검증
서류 인증 심사 파이프라인 구현S3 presigned URL 업로드부터 심사 상태 전이까지 이어지는 인증 파이프라인 설계
서비스 타입Web
업종플랫폼
기술 스택
React NativeTypeScriptNode.jsExpressPostgreSQLPrismaAWS S3JWT 인증
주요 기능
  • 매칭 홈
  • 본인 인증
  • 호감 & 매칭
  • 포인트 충전
Overview

프로젝트 개요

범위: 개발, 디자인, 기획

프리미엄 프라이빗 매칭 서비스의 핵심 플로우 — 서류 인증 회원가입, 매칭 홈, 호감·매칭 성사, 포인트 결제를 React Native와 Node.js 기반으로 설계·구현합니다. 인증 뱃지와 매칭 확정 시 채팅방 자동 개설 구조로 프라이빗 매칭 서비스에 요구되는 신뢰성과 안전한 연결 흐름을 구현합니다.

작업 범위

  • 매칭 홈: 프리미엄 회원 전용으로 매일 정해진 시간에 정해진 인원의 이성 프로필 카드를 노출하고, 필터·스와이프·상세 열람으로 탐색할 수 있는 매칭 피드를 구현합니다
  • 본인 인증: 가입 시 프로필 정보와 증빙 서류/사진을 업로드하고, 관리자 심사를 거쳐 인증 뱃지를 부여받는 플로우를 구현합니다
  • 호감 & 매칭: 호감 보내기(포인트 소모), 수락/거절 처리, 양측 수락 시 매칭 확정과 채팅방 자동 개설까지의 흐름을 구현합니다
  • 포인트 충전: 포인트 충전, 인앱결제(App Store/Google Play IAP) 연동 인터페이스, 잔액 조회, 거래 내역 확인 기능을 구현합니다

주요 업무

  • 매칭 홈 화면: 카드 그리드 노출 알고리즘 + 필터(연령/지역/직업) + 카드 클릭 시 퀵뷰 drawer로 상세 프로필 프리뷰를 표시합니다
  • 본인 인증 화면: AWS S3 presigned URL 업로드 + 심사 상태(대기/승인/반려) 관리 + 인증 뱃지 표시 로직을 구현합니다
  • 호감 & 매칭 화면: 포인트 차감 트랜잭션 + 매칭 상태 관리 + 매칭 확정 시 채팅방 개설 플로우를 구현합니다
  • 포인트 충전 화면: IAP 영수증 검증 인터페이스 + 포인트 충전/차감 원장 테이블 + 거래 내역 UI를 구현합니다
프리미엄 프라이빗 매칭 플랫폼
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

매일 정해진 노출 횟수를 서버 사이드에서 정확히 통제하는 카운터 설계

호감 전송 시 포인트 차감의 동시성 제어(중복 차감 방지) 트랜잭션 격리 수준 설계

서류 인증 심사 대기 상태에서 매칭 기능 접근을 제한하는 권한 분기 로직 설계

인앱결제 영수증 검증 실패·재시도 케이스를 포함한 결제 상태 관리

구현 내용

핵심 기능 상세

핵심 기능 1

매칭 홈

프리미엄 회원 전용으로 매일 정해진 시간에 정해진 인원의 이성 프로필 카드를 노출하고, 필터·스와이프·상세 열람으로 탐색할 수 있는 매칭 피드를 구현합니다.

  • React Query로 프로필 카드 목록을 페이지네이션 캐싱하고 staleTime을 노출 주기에 맞춰 관리
  • 필터 조건(연령/지역/직업)을 조합하는 동적 쿼리 빌더를 Express API에 구현
  • 카드 스와이프 제스처와 퀵뷰 drawer 트랜지션을 CSS transform 기반으로 적용

일 노출 횟수 제한 로직을 서버 사이드 카운터로 구현해 하루 매칭 노출 한도를 정확히 통제하는 구조를 설계합니다.

매칭 홈
매칭 홈 실제 화면
핵심 기능 2

본인 인증

가입 시 프로필 정보와 증빙 서류/사진을 업로드하고, 관리자 심사를 거쳐 인증 뱃지를 부여받는 플로우를 구현합니다.

  • Multer + AWS S3 presigned URL로 서류/사진 업로드 파이프라인 구현
  • 심사 상태 머신(대기→승인/반려)을 Prisma 스키마와 상태 전이 로직으로 설계
  • 인증 뱃지 컴포넌트를 프로필 카드/상세 화면 등 3개 지점에서 재사용

프라이빗 폐쇄형 매칭 서비스의 신뢰성을 뒷받침하는 서류 인증 상태 관리 구조를 구현하며, 심사 대기 중에는 매칭 기능 접근을 제한합니다.

본인 인증
본인 인증 실제 화면
핵심 기능 3

호감 & 매칭

호감 보내기(포인트 소모), 수락/거절 처리, 양측 수락 시 매칭 확정과 채팅방 자동 개설까지의 흐름을 구현합니다. 포인트 차감 트랜잭션 + 매칭 상태 관리 + 매칭 확정 시 채팅방 개설 플로우를 구현합니다.

  • 호감 전송 시 포인트 차감을 원자적 트랜잭션으로 처리해 중복 차감을 방지
  • 매칭 상태(전송/수락/거절/확정)를 Prisma enum과 상태 전이 함수로 관리
  • 매칭 확정 이벤트를 트리거로 채팅방 레코드를 자동 생성하는 훅 구현

실제 연락처 대신 매칭 성사 후 자동 개설되는 채팅방으로 대화를 연결해, 개인정보 노출 없이 안전한 만남 흐름을 구현합니다.

호감 & 매칭
호감 & 매칭 실제 화면
핵심 기능 4

포인트 충전

포인트 충전, 인앱결제(App Store/Google Play IAP) 연동 인터페이스, 잔액 조회, 거래 내역 확인 기능을 구현합니다.

  • App Store/Google Play 마켓 정책에 맞춘 IAP 영수증 검증 인터페이스를 서버 사이드에 구현
  • 포인트 원장(ledger) 테이블로 충전/차감 내역을 이중기입 방식으로 기록
  • 거래 내역 화면에 무한 스크롤 + 필터(충전/사용)를 적용

포인트 원장을 이중기입 구조로 설계해 충전·차감 내역의 정합성을 트랜잭션 단위로 검증할 수 있는 구조를 구현합니다.

포인트 충전
포인트 충전 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

매칭 도메인 분석 및 ERD 설계 · 2026.09

회원/인증/매칭/포인트 도메인 분석, PostgreSQL 테이블 18개 정의 및 관계 매핑

STEP 2

인증 및 매칭 API 개발 · 2026.09

Express 기반 서류 업로드·심사·매칭 상태 API 26개 엔드포인트 구현, JWT 인증 적용

STEP 3

모바일 UI 및 스와이프 인터랙션 구현 · 2026.09

React Native 기반 매칭 피드·프로필 상세 화면 구현, 카드 스와이프 제스처 적용

STEP 4

결제 연동 및 통합 테스트 · 2026.09

IAP 영수증 검증 인터페이스 연동, 포인트 트랜잭션 통합 테스트 32개 케이스 작성

프로젝트 성과

주요 성과

매칭 상태 머신 설계전송·수락·거절·확정 4단계 상태를 Prisma enum으로 관리하는 매칭 상태 전이 로직 구현
포인트 이중기입 원장 구축충전·차감 내역을 이중기입 방식으로 기록하는 포인트 원장 테이블 설계, 트랜잭션 정합성 검증
서류 인증 심사 파이프라인 구현S3 presigned URL 업로드부터 심사 상태 전이까지 이어지는 인증 파이프라인 설계
연락처 비노출 매칭 플로우 설계매칭 확정 시 채팅방을 자동 개설해 개인 연락처 노출 없이 대화를 시작하는 구조 구현
Highlights

기술적 주안점

  • 일 노출 횟수 제한 로직을 서버 사이드 카운터로 구현해 하루 매칭 노출 한도를 정확히 통제하는 구조를 설계합니다
  • 프라이빗 폐쇄형 매칭 서비스의 신뢰성을 뒷받침하는 서류 인증 상태 관리 구조를 구현하며, 심사 대기 중에는 매칭 기능 접근을 제한합니다
  • 실제 연락처 대신 매칭 성사 후 자동 개설되는 채팅방으로 대화를 연결해, 개인정보 노출 없이 안전한 만남 흐름을 구현합니다

유사한 프로젝트를 기획하고 계신가요?

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기