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) — 분실, 파손, 실사 차이 등 (음수 또는 양수)