GOMS_v_1.0

Tables (8)

customers

  • customerId — VARCHAR(255) — Primary key — NOT NULL — 고객 고유 ID. email > phoneNumber > YYYYMMDD_GuestN 우선순위
  • type — VARCHAR(50) — NOT NULL — MEMBER / GUEST / GIFT_RECIPIENT / OFFLINE / POTENTIAL
  • profiles — ARRAY(profile) — NOT NULL — array<map>: {firstName, lastName, phoneNumber}. 0은 최초 유입 데이터
  • email — VARCHAR(255) — 이메일 (있는 경우 unique 권장, 동일고객 판정 1순위)
  • addresses — ARRAY(VARCHAR) — map: 배송지 목록
  • memo — TEXT — 비고
  • totalSpent — DECIMAL(15, 2) — 누적 구매액 (orders 합산, 비정규화. channel=gift는 totalPrice=0)
  • orderCount — INT — 총 주문/거래 횟수 (비정규화)
  • channel — VARCHAR(100) — 유입 경로 (imweb, samcart, offline_event_2026q1, gift_youtube 등)
  • createdAt — TIMESTAMP — NOT NULL — 문서 생성일시

devices

  • productCode — VARCHAR(255) — NOT NULL — 제품 시리얼 넘버(예: Ggrip_S3700000C)
  • productId — VARCHAR(255) — Foreign key → products.productId — 제품 참조 번호
  • customerId — VARCHAR(255) — Foreign key → customers.customerId — 고객 참조 번호
  • orderId — VARCHAR(255) — Foreign key → orders.orderNumber — 주문 참조 번호
  • status — TINYINT — NOT NULL — 0=PENDING(미출고), 1=SHIPPED(출고)
  • options — TINYINT — 9자리 옵션 코드

devices/options (자릿수)

  • 1 (mode) — 센서 모드 (예: 1=궤도, 2=압력, 9=미지정)
  • 2-3 (clubType) — 클럽 종류 (예: 1=7번 아이언/2=Driver/3=Putter 등. 9=한 자리 미지정, 99=두 자리 미지정)
  • 4 (gender) — 성별 (1=남, 2=여, 9=미지정)
  • 5-6 (shaftLength) — 샤프트 길이 코드 (예: Longer 2 등 길이 변형. 99=미지정)
  • 7 (gripSize) — 그립 크기 (예: 1=Longer, 2=미드. 9=미지정)
  • 8 (hand) — 잡는 손 (1=오른손, 2=왼손, 9=미지정)
  • 9 (flex) — 샤프트 플렉스 (예: 1=R flex, 2=S flex. 9=미지정)

optionQuantity (Untitled2)

  • option — TINYINT — 9자리 옵션 코드
  • currentStock — TINYINT — 현재 수량
  • stockMovements — Collection(StockMovements) — 하위 상품 변동 컬렉션

orders

  • orderNumber — VARCHAR(255) — Primary key — NOT NULL — 주문 번호
  • channel — VARCHAR(50) — NOT NULL — 0=아임웹, 1=샘카트, 2=오프라인
  • customerId — VARCHAR(255) — Foreign key → customers.customerId — 수령 고객 (미출고는 NULL)
  • firstName — VARCHAR(100) — NOT NULL — 주문 시점 이름
  • lastName — VARCHAR(100) — NOT NULL — 주문 시점 성
  • email — VARCHAR(255) — NOT NULL — 주문 시점 이메일
  • phoneNumber — VARCHAR(50) — 주문 시점 연락처
  • shippingAddress — TEXT — NOT NULL — 배송지 (스냅샷)
  • domesticTrackingNumber — VARCHAR(100) — 국내 송장번호
  • internationalTrackingNumber — VARCHAR(100) — 해외 송장번호
  • memo — TEXT — 비고 / 예외 사항
  • orderSummary — VARCHAR(255) — NOT NULL — 주문 요약 (예: 지그립 궤도 외 2건)
  • orderDate — TIMESTAMP — NOT NULL — 주문 일시
  • orderItems — ARRAY(item) — NOT NULL — map: {options, quantity, unitPrice}
  • currency — TINYINT — 0=달러, 1=원화
  • shippingPrice — DECIMAL(15, 2) — 배송비
  • tax — DECIMAL(15, 2) — 세금
  • totalPrice — DECIMAL(15, 2) — NOT NULL — 총계 (channel=gift는 0)
  • discountPrice — DECIMAL(15, 2) — 할인 가격
  • orderStatus — TINYINT — NOT NULL — 0=ORDERED, 1=REFUNDED, 2=RETURNED
  • orderType — TINYINT — 주문/환불/교환/AS 구분
  • shippingStatus — TINYINT — NOT NULL — 0=출고 전, 1= 배송 중, 2=배송 완료
  • arrivalDate — TIMESTAMP — 도착 일자
  • slackNotified — BOOLEAN — Slack 신규 주문 알림 발송 여부
  • createdAt — TIMESTAMP — NOT NULL — 문서 생성일시

products

  • productId — VARCHAR(255) — Primary key — NOT NULL — 상품 번호
  • name — VARCHAR(255) — NOT NULL — 상품명 (예: G-grip Men's 7-iron)
  • basePrice — DECIMAL(15, 2) — NOT NULL — 기본 판매가
  • memo — TEXT — 비고
  • createdAt — TIMESTAMP — NOT NULL — 문서 생성일시
  • optionQuantity — Collection(optionQuantity) — 하위 수량 컬렉션

stockMovements

  • movementId — VARCHAR(255) — Primary key — NOT NULL — 입출고 이력 ID (자체 발급, 문서 ID)
  • type — VARCHAR(50) — NOT NULL — ORDER_OUT / ORDER_REFUND / GIFT_OUT / OFFLINE_SALE / INVENTORY_IN / ADJUSTMENT
  • quantity — INT — NOT NULL — 변동 수량 (음수=출고, 양수=입고)
  • referenceType — VARCHAR(50) — 참조 대상 유형 (order)
  • referenceId — VARCHAR(255) — Foreign key → orders.orderNumber — 참조 문서 ID (orderNumber)
  • reason — TEXT — 비고(사유)
  • occurredAt — TIMESTAMP — NOT NULL — 실제 변동 발생일시
  • createdAt — TIMESTAMP — NOT NULL — 기록 생성일시

stockMovemetns/type (type)

  • 온라인 주문 출고 (ORDER_OUT) — orders 신규 저장 시 자동 (음수)
  • 반품으로 인한 재입고 (ORDER_REFUND) — orderStatus가 RETURNED(2)로 변경 시 자동 (양수)
  • 증정 출고 (GIFT_OUT) — orders(channel=gift) 생성 시 자동 (음수)
  • 오프라인 판매 출고 (OFFLINE_SALE) — orders(channel=offline) 생성 시 자동 (음수)
  • 재고 입고 (INVENTORY_IN) — 운영자 수동 입고 등록 (양수)
  • 수동 조정 (ADJUSTMENT) — 분실, 파손, 실사 차이 등 (음수 또는 양수)