플러스프로젝트 배경
QR코드 기반 오프라인 마케팅 도달률 추적 서비스를, 실제 의뢰 공고 요구사항을 기반으로 캠페인 관리·QR 생성·스캔 추적·지역별 통계·실시간 대시보드가 실제로 구현 가능한지 파일럿으로 구현했습니다. 서비스 소개 웹사이트부터 PC·모바일 반응형 관리자 대시보드까지 전체 플로우를 단기간에 구현하고 즉시 운영 가능한 상태임을 검증하는 것이 목표였습니다.
프로젝트 성과
요구사항 12개 항목 100% 구현, 2일 내 배포
공고 요구사항 전 항목 구현 완료. E2E 테스트 8개 시나리오 전 통과, 파일럿 착수부터 GitHub 배포까지 2일 내 완료
QR 스캔 전체 추적 파이프라인 단일 API 구현
스캔 시 ip-api.com으로 IP→도시/지역/국가 변환, 유니크 방문 판별, 외부 클릭 여부까지 전체 추적 파이프라인 단일 API 처리
SWR 10초 폴링 실시간 도달률 모니터링
발송 수량 입력 즉시 도달률 카드·시계열 차트·지역별 분포 전체 자동 갱신. Recharts 기반 시간대별 스캔 추이 시각화
E2E 테스트 3건 이슈 발견 및 전수 수정 완료
Playwright 기반 기능·심미 E2E 테스트로 한글 슬러그 버그·도달률 즉시 갱신 미반영·모바일 테이블 레이아웃 깨짐 3건 수정
핵심 기능
캠페인 단위 QR코드 생성 및 관리
관리자가 캠페인명·슬러그·목적지URL·지역 태그를 입력하면 QR코드가 자동 생성되고 PNG로 다운로드 가능. Prisma + SQLite 기반 캠페인 CRUD
진행 단계
요구사항 분석 및 설계
2026.04.
공고 요구사항 12개 항목 분석, Campaign/Scan/SendEntry/Inquiry DB 스키마 설계, Next.js App Router + Prisma 프로젝트 초기화
프로젝트 상세
오프라인 홍보물(전단지·포스터·현수막)에 인쇄된 QR코드 스캔 수를 실시간으로 집계하고, 발송 수량 대비 도달률을 캠페인별로 측정하는 웹 서비스입니다. 서비스 소개 랜딩페이지부터 관리자 대시보드까지 전 기능을 Next.js 14 + Prisma로 구현했습니다.
