초기 SaaS·AR 커머스
위치기반 AR 선물 수령 서비스
온라인으로 받은 AR 선물을 특정 장소에서 QR로 수령하는 흐름과 상품·사용자 데이터를 설계했습니다.
- Company
- 투스페이스
- Service
- PRESEND
- Period
- 2022.09–2023.07 · 11개월
- Role
- Backend Engineer
- Responsibility
- 백엔드 도메인 모델·서버 구조 담당
- Go
- Gin
- MongoDB
- Firebase
- NestJS
- TypeORM · Mongoose
Project Overview
온라인 선물과 오프라인 수령 조건이 만나는 커머스 모델을 정리했습니다
프로젝트의 핵심 과제는 AR 선물이 온라인 상품이면서도 특정 장소, QR, 예약·수령 상태를 만족해야 완결되는 오프라인 경험을 함께 갖는다는 점이었습니다.
당시 역할 범위에는 메인 서버 구현, 3D 파일 변환 병목 개선, CI/CD 자동화도 포함됐지만, 현재 공개 가능한 근거에서는 Go/Gin 메인 서버의 문서 모델과 라우터 골격, 이후 NestJS 라인의 계층·인프라 어댑터 분리가 가장 분명합니다. 그래서 완성 운영 성과보다 위치 조건, 상품 유형, AR 리소스, 선물 수령 생명주기, 실행 경계를 중심으로 공개했습니다.
- 상점 지오펜스와 선물 수령 좌표·예약 시각을 분리해 장소 기반 수령 조건을 표현했습니다.
- AR·실물·티켓·이벤트 상품을 하나의 선물 흐름 안에서 다루되 리소스 타입은 분리했습니다.
- 스냅샷 근거만 남은 프로젝트라 Phase별 기간·운영 지표가 아니라 모델링과 구조 경계만 공개했습니다.
Ownership
직접 담당한 범위
- 위치기반 AR 선물 수령 커머스의 상점·상품·사진·선물·사용자 문서 모델 설계
- 상점 지오펜스와 QR·예약·수령·확정 상태를 분리한 선물 생명주기 구현
- AR·실물·티켓·이벤트 상품을 공통 상품 흐름과 리소스 타입으로 통합
- Go/Gin·MongoDB 메인 서버의 API·데이터 구조와 Firebase 인증 연동 구현
- NestJS 재구현 과정에서 인증·사용자 기능과 관계형·문서형 저장소, AWS 연동 경계 구성
Constraints
먼저 해결해야 했던 제약
- 선물은 온라인 결제 객체이면서 특정 물리 위치에서만 수령되는 오프라인 상태를 함께 가져야 했습니다.
- 수신자가 미리 정해지지 않은 선물도 허용해야 했고, 좌표에 도착한 사람이 획득하는 흐름을 표현해야 했습니다.
- 상품은 AR 리소스, 실물, 티켓, 이벤트처럼 표현 방식이 달라도 목록·선물 흐름은 하나로 유지해야 했습니다.
Implementation Timeline
도메인 모델에서 실행 경계로 확장된 순서입니다
단일 스냅샷 근거를 기준으로 도메인 의존 순서와 확인 가능한 월까지만 표시했습니다. 필요한 Phase를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.
위치·지오펜스 도메인
Project Infrastructure
프로젝트 공통 인프라는 실행 단위와 어댑터 경계로만 공개합니다
메인 서버·재구현 라인·광고 서버의 실행 단위와 외부 의존성을 구분했습니다.
- 01
실행 단위
Go/Gin 메인 서버, NestJS 재구현 라인, NestJS 광고 서버가 서로 다른 성숙도와 책임을 가진 snapshot으로 남아 있습니다.
- 02
상태 저장소
메인 도메인은 MongoDB 문서 모델을 중심으로, 재구현 라인은 TypeORM · Mongoose · 캐시 모듈 스캐폴드를 중심으로 확인됩니다.
- 03
외부 연동
Firebase 인증, PASS 인증 전제, AWS 어댑터 스캐폴드가 외부 인프라 경계로 분리되어 있습니다.
- 04
검증 한계
배포 전략, 서버 토폴로지, 운영 로그, 장애 복구 지표는 현재 원천에서 직접 검증하지 못해 공개 성과로 사용하지 않습니다.
Outcome
확인 가능한 결과
- 2022 안양청년창업 공모대전 해커톤 대상 (프로젝트 팀)
- 위치기반 AR 선물 수령 커머스의 위치·QR·상태 중심 도메인 모델 정리
- 상점, 상품, 사진, 선물, 사용자 모델을 통해 AR 커머스의 핵심 관계를 설명 가능하게 구성
- AR·실물·티켓·이벤트를 단일 상품 흐름으로 묶는 다형 상품 모델 설계
- Go/Gin 메인 서버와 NestJS 재구현 라인의 실행·계층·인프라 경계 보존
- 구현 완료 범위와 스캐폴딩·미확정 범위를 공개 문장에서 분리
Limitations
한계와 미구현 범위
- 원본 저장소는 코드베이스별 단일 스냅샷 커밋만 확인되어 Phase별 실제 개발 기간을 세밀하게 주장하지 않습니다.
- 메인 서버 핸들러 구현이 완료되지 않은 구간은 완성 API 운영 성과로 표기하지 않습니다.
- 일부 enum 값과 리소스 타입 선언에는 아카이브 시점의 미확정·불일치가 있어 한계로 남깁니다.
- 완성 배포 파이프라인, 서버 토폴로지, 운영 지표는 현재 원천에서 직접 검증 가능한 자료가 없어 상세 주장으로 사용하지 않습니다.
- 정량 성능 개선, 트래픽, 장애율, 비용 절감 수치는 보존 자료가 없어 공개하지 않습니다.
- 내부 저장소, 실제 서비스명, 설정·인증 예시, 실제 API 경로는 공개하지 않습니다.