이찬양Backend Engineer

언어

← 프로젝트 목록으로 돌아가기

초기 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를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.

Phase 01 · 위치·지오펜스 도메인

위치·지오펜스 도메인

Phase 01

“장소에 도착해야 받을 수 있다”는 요구를 위치 조건으로 분리했습니다

상점의 수령 가능 영역과 선물의 실제 수령 좌표를 별도 책임으로 나눴습니다.

위치기반 수령 조건Mermaid

다이어그램을 렌더링하는 중입니다.

  1. 01

    요구 분석

    선물 수령은 단순 소유권 이전이 아니라 장소, 좌표, 예약 시각이 함께 맞아야 성립하는 경험으로 보았습니다.

    • 상점은 수령 가능한 물리 공간의 기준점이고, 선물은 실제로 놓이거나 수령될 위치를 따로 가져야 했습니다.
    • 수신자가 미리 정해지지 않은 선물도 가능해야 했으므로 “누구에게”보다 “어디에서”가 먼저인 케이스가 있었습니다.
  2. 02

    도메인 모델링

    상점은 중심 좌표와 반경을, 선물은 수령 좌표와 예약 시각을 갖도록 나눴습니다.

    • 상점의 위치 정보는 지오펜스의 기준이고, 선물의 위치 정보는 수령 이벤트의 대상입니다.
    • 좌표는 정밀 수치 타입으로 표현해 위도·경도 값을 문자열이나 부동소수 오차에 느슨하게 맡기지 않았습니다.
  3. 03

    아키텍처 결정

    복잡한 공간 모델보다 원형 지오펜스를 선택해 초기 요구를 단순한 좌표·반경 판단으로 고정했습니다.

    • 폴리곤이나 층 단위 공간은 표현력이 높지만 초기 모델 복잡도가 커집니다.
    • 원형 지오펜스는 한 상점당 하나의 중심과 반경으로 설명 가능해 초기 도메인 검증에 적합했습니다.
  4. 04

    구현·검증

    아카이브된 Go 모델에서 상점 위치·반경, 선물 위치·예약 시각이 별도 문서에 존재하는 것을 확인했습니다.

    • 위치 주변 조회와 좌표 배치 라우터 주석도 같은 도메인 방향을 가리킵니다.
    • 핸들러 구현이 완료되지 않은 구간은 실제 위치 검증 API 성과로 주장하지 않습니다.
  5. 05

    운영·복구

    운영 중 수령 오류를 보면 QR만 확인하지 않고, 상점 지오펜스와 선물 좌표·예약 조건을 함께 확인해야 합니다.

    • 위치 조건이 빠지면 “코드는 맞지만 장소가 아닌 곳에서 받는” 도메인 위반이 생깁니다.
    • 공개 페이지에서는 위치 검증 전략만 설명하고 실제 좌표·상점 정보는 노출하지 않습니다.

Project Infrastructure

프로젝트 공통 인프라는 실행 단위와 어댑터 경계로만 공개합니다

메인 서버·재구현 라인·광고 서버의 실행 단위와 외부 의존성을 구분했습니다.

  1. 01

    실행 단위

    Go/Gin 메인 서버, NestJS 재구현 라인, NestJS 광고 서버가 서로 다른 성숙도와 책임을 가진 snapshot으로 남아 있습니다.

  2. 02

    상태 저장소

    메인 도메인은 MongoDB 문서 모델을 중심으로, 재구현 라인은 TypeORM · Mongoose · 캐시 모듈 스캐폴드를 중심으로 확인됩니다.

  3. 03

    외부 연동

    Firebase 인증, PASS 인증 전제, AWS 어댑터 스캐폴드가 외부 인프라 경계로 분리되어 있습니다.

  4. 04

    검증 한계

    배포 전략, 서버 토폴로지, 운영 로그, 장애 복구 지표는 현재 원천에서 직접 검증하지 못해 공개 성과로 사용하지 않습니다.

Outcome

확인 가능한 결과

  • 2022 안양청년창업 공모대전 해커톤 대상 (프로젝트 팀)
  • 위치기반 AR 선물 수령 커머스의 위치·QR·상태 중심 도메인 모델 정리
  • 상점, 상품, 사진, 선물, 사용자 모델을 통해 AR 커머스의 핵심 관계를 설명 가능하게 구성
  • AR·실물·티켓·이벤트를 단일 상품 흐름으로 묶는 다형 상품 모델 설계
  • Go/Gin 메인 서버와 NestJS 재구현 라인의 실행·계층·인프라 경계 보존
  • 구현 완료 범위와 스캐폴딩·미확정 범위를 공개 문장에서 분리

Limitations

한계와 미구현 범위

  • 원본 저장소는 코드베이스별 단일 스냅샷 커밋만 확인되어 Phase별 실제 개발 기간을 세밀하게 주장하지 않습니다.
  • 메인 서버 핸들러 구현이 완료되지 않은 구간은 완성 API 운영 성과로 표기하지 않습니다.
  • 일부 enum 값과 리소스 타입 선언에는 아카이브 시점의 미확정·불일치가 있어 한계로 남깁니다.
  • 완성 배포 파이프라인, 서버 토폴로지, 운영 지표는 현재 원천에서 직접 검증 가능한 자료가 없어 상세 주장으로 사용하지 않습니다.
  • 정량 성능 개선, 트래픽, 장애율, 비용 절감 수치는 보존 자료가 없어 공개하지 않습니다.
  • 내부 저장소, 실제 서비스명, 설정·인증 예시, 실제 API 경로는 공개하지 않습니다.