프로젝트 소개

공식 실시간 정산 API가 부재한 환경에서, 딥링크 세션 트래킹과 비동기 데이터 융합으로 유저의 구매 직후 10분 내 포인트 적립 경험을 실현하는 실시간 구매 추론 엔진을 구축합니다.

프로젝트 개요

핵심 요구사항 분석

• 실시간 어트리뷰션 파이프라인 — 딥링크 생성, 브릿지 페이지, ClickID 발급/생명주기 관리, 세션 하이재킹 방지
• 데이터 퓨전 & 실시간 매칭 엔진 — 비동기 로그/클라이언트 이벤트 수집 Ingestion 워커, 파편화된 데이터와 내부 토큰의 실시간 1:1 매칭, 가주문(Pending) 상태 즉시 도출
• 포인트 정산 시스템 — 실시간 가지급 포인트와 익일 배치 데이터 교차 검증(Reconciliation), 오탐지/어뷰징 방어 룰 엔진
• Flutter 앱 연동 — iOS/Android 크로스플랫폼 앱의 딥링크(Universal Link, App Link) 라우팅 및 WebView 통신 지원

제안 포인트

본 프로젝트의 핵심은 "흩어진 데이터 조각들로 완벽한 데이터 플로우를 창조"하는 것입니다. 이를 위해 다음과 같이 접근합니다:

• 이벤트 드리븐 아키텍처 경험 — 유사 프로젝트(Life3)에서 Kafka 기반 이벤트 드리븐 마이크로서비스를 구축하고, 복식부기 회계 시스템으로 포인트/토큰의 100% 정합성을 확보한 경험이 있습니다. 본 프로젝트의 Reconciliation 로직에 직접 활용 가능합니다.
• NestJS + Redis 실시간 처리 — NestJS 기반 서버를 다수 설계/운영했으며(Harmony Link: 140+ API, EZ-Approve: 120+ API), Redis를 활용한 세션 관리 및 실시간 데이터 매칭 구현 경험이 풍부합니다.
• 복잡한 비즈니스 로직 설계 — 결제, 포인트 정산, 다단계 상태 전이를 포함한 트랜잭션 설계 경험(EZ-Approve: 8종 결재 액션, Life3: 포인트-토큰 스왑 정산)을 보유하고 있습니다.
• Flutter 딥링크 연동 — Flutter 앱에서의 Universal Link/App Link 라우팅 및 WebView 통신 구조를 직접 구현한 경험(Harmony Link, Calendar Share)이 있어 프론트엔드 팀과의 원활한 협업이 가능합니다.

사용 기술 및 툴

개발 기술

협업 및 커뮤니케이션

견적서

본 견적서는 프로젝트 요구사항 분석을 기반으로 산출되었습니다.

견적 요약

상세 견적 내역

산정 근거

• 유사 프로젝트(이벤트 드리븐 포인트 정산 시스템, NestJS 기반 실시간 처리) 수행 경험 기반 산정
• 백엔드 전용 프로젝트로 프론트엔드 작업 제외
• Flutter 프론트엔드 연동을 위한 API 설계 및 문서화 포함

포함 사항

• 소스 코드 전체 이관
• 개발 문서 (API 명세서, DB 스키마, 아키텍처 문서, 배포 가이드)
• 1개월 무상 하자 보수
• 배포 환경 세팅 (AWS, 1회)

불포함 사항

• 서버 호스팅 비용 (AWS)
• Flutter 프론트엔드 개발
• 외부 유료 API 사용 비용
• 하자 보수 기간 이후 유지보수

공수계산서

기능별 개발 공수(Man-Day)를 산출하여 일정과 비용의 근거를 제시합니다.

공수 요약

기능별 상세 공수

산정 기준

• 1 M/D = 8시간 기준 (1인 1일 작업량)
• 주 5일 근무 기준
• 버퍼 10~15% 포함
• 유사 프로젝트 수행 경험 기반 효율적 개발

PRD (Product Requirements Document)

프로젝트 요구사항을 정의하고 기능 범위를 명확히 합니다.

1. 프로젝트 배경 및 목적

현재 이커머스 제휴 마케팅 생태계의 가장 큰 페인포인트는 '느린 피드백'입니다. 유저는 오늘 쇼핑을 했지만, 적립금은 다음 날 오후에나 확인할 수 있습니다. 본 프로젝트는 이 24시간의 지연을 허물고, 유저가 쇼핑을 마친 직후 10분 내로 즉각적인 포인트 적립 경험을 제공하는 실시간 앱테크 플랫폼의 백엔드를 구축합니다.

공식적인 실시간 정산 API가 부재한 환경에서, 딥링크 세션 트래킹, 클라이언트 이벤트 가로채기, 비동기 데이터 융합 등을 조합하여 '실시간 구매 추론 엔진'을 구현합니다.

2. 사용자 정의

3. 기능 요구사항

3.1 실시간 어트리뷰션 파이프라인

• [필수] 딥링크(Deep Link) 생성 API — 앱에서 외부 이커머스로 전환 시 고유 추적 링크 생성
• [필수] ClickID 발급 및 생명주기 관리 — 쿠키/토큰 기반 유저 식별자, TTL 관리
• [필수] 브릿지 페이지(Bridge Page) — 앱에서 브라우저 전환 시 세션 연결
• [필수] 세션 하이재킹 방지 — IP, User-Agent, 타임스탬프 기반 검증

3.2 데이터 수집 & Ingestion

• [필수] 비동기 로그 수집 Ingestion 워커 — 외부 이커머스 데이터 수집
• [필수] 클라이언트 이벤트 수집 API — 앱에서 발생하는 구매 관련 이벤트
• [필수] 데이터 정규화 및 저장 — 다양한 소스의 데이터를 통일된 포맷으로 변환

3.3 실시간 매칭 엔진

• [필수] Redis 기반 실시간 1:1 매칭 — 수집된 데이터와 내부 ClickID 토큰 매칭
• [필수] 가주문(Pending) 상태 즉시 도출 — 매칭 성공 시 즉시 포인트 가지급
• [필수] 매칭 실패/타임아웃 처리 — 미매칭 데이터의 재시도 및 폐기 정책

3.4 포인트 정산 시스템

• [필수] 실시간 가지급 포인트 처리 — 매칭 즉시 임시 포인트 부여
• [필수] 익일 배치 교차 검증(Reconciliation) — 공식 데이터와 가지급 내역 대조
• [필수] 차감/보정 로직 — 불일치 시 자동 정산 처리

3.5 어뷰징 방어 룰 엔진

• [필수] 룰 기반 어뷰징 탐지 — 비정상 패턴(빈도, 금액, IP) 감지
• [필수] 오탐지 처리 프로세스 — 수동 검토 및 화이트리스트
• [선택] 룰 설정 관리 API — 관리자가 룰을 동적으로 추가/수정

4. 비기능 요구사항

5. 기술 제약사항

• 백엔드: Node.js (NestJS) — 클라이언트 지정 기술
• 데이터베이스: PostgreSQL — 트랜잭션 정합성 보장
• 캐시: Redis — 실시간 매칭 및 세션 관리
• 인프라: AWS 기반 — 클라이언트 지정 인프라
• 앱 클라이언트: Flutter (iOS/Android) — 백엔드 API 연동 기준

6. 범위 외 사항 (Out of Scope)

• Flutter 프론트엔드 개발 (클라이언트 명시)
• 이커머스 앱/웹 UI 개발
• 마케팅 캠페인 관리 기능
• 관리자 웹 대시보드 UI 개발 (API만 제공)

일정 제안

총 30일 기준 단계별 마일스톤 및 산출물을 제안합니다.

전체 일정 요약

마일스톤 체크포인트

커뮤니케이션 계획

유사 프로젝트 경험

본 프로젝트와 유사한 기능/기술 스택을 활용한 수행 경험을 소개합니다.