V2 Oship
테이블 (20)
carrier_countries (carrier_country)
- id — BIGINT — 기본 키 — NOT NULL — Primary Key
- carrier_id — BIGINT — 외래 키 → carriers.id — NOT NULL — FK
- zone_no — INT — NOT NULL
- country_code — VARCHAR(10) — NOT NULL
- created_at — TIMESTAMP
- modified_at — TIMESTAMP
carrier_rate_cahrges (carrier_rate_charge)
- id — BIGINT — 기본 키 — NOT NULL — Primary Key
- carrier_id — BIGINT — 외래 키 → carriers.id — NOT NULL — FK
- zone_index — INT — NOT NULL
- weight — DECIMAL(20, 2) — NOT NULL
- amount — INT — NOT NULL
- created_at — TIMESTAMP
- modified_at — TIMESTAMP
carriers
- id — BIGINT — 기본 키 — NOT NULL — Primary Key
- partner_id — BIGINT — 외래 키 → 파트너.식별자 — NOT NULL — FK
- name — VARCHAR(255) — NOT NULL
- description — VARCHAR(255)
- weight_min — DECIMAL(20, 2) — NOT NULL
- weight_max — DECIMAL(20, 2) — NOT NULL
- created_at — TIMESTAMP
- modified_at — TIMESTAMP
- service — VARCHAR(50) — NOT NULL
- token — VARCHAR(255) — NOT NULL
notification
- id — BIGINT — 기본 키
- 알림 타입 (type) — VARCHAR(50) — NOT NULL
- 이메일 제목 (title) — VARCHAR(255) — NOT NULL
- 내용 (content) — TEXT — NOT NULL
- 수신자 이메일 주소 (target_email) — VARCHAR(255) — NOT NULL
- 발송 여부 (sent) — TINYINT(1)
- 발송 시각 (sent_at) — DATETIME
- 생성 시각 (created_at) — DATETIME
order_items
- id — BIGINT — 기본 키 — NOT NULL
- 주문 ID (order_id) — BIGINT — 외래 키 → 주문.id — NOT NULL
- 상품 이름 (name) — VARCHAR(100) — NOT NULL
- 수량 (quantity) — INT — NOT NULL
- 단가 (unit_value) — DECIMAL(20, 2) — NOT NULL
- 화폐 단위 (예: USD, KRW) (value_currency) — VARCHAR(10) — NOT NULL
- 무게 단위 (기본 : kg) (weight_unit) — VARCHAR(255)
- 개별 상품 무게 (weight) — DECIMAL(20, 2) — NOT NULL
- HS 코드 (수출입 통관용 코드) (item_hs_code) — VARCHAR(20) — NOT NULL
- 상품 원산지 국가 코드 (item_origin_country_code) — VARCHAR(10) — NOT NULL
- created_at — TIMESTAMP
- modified_at — TIMESTAMP
- Key — 외래 키 — NOT NULL
shipments
- id — BIGINT — 기본 키 — NOT NULL — PK
- order_id — BIGINT — 외래 키 → 주문.id — NOT NULL — FK
- carrier_id — BIGINT — 외래 키 → carriers.id — NOT NULL — FK
- charge_value — DECIMAL(20, 2)
- carrier_tracking_no — VARCHAR(50)
- width — DECIMAL(20, 2)
- height — DECIMAL(20, 2)
- length — DECIMAL(20, 2)
- gross_weight — DECIMAL(20, 2)
- volumn_weight — DECIMAL(20, 2)
- charge_weight — DECIMAL(20, 2)
- data — VARCHER(255) — API Return Data
- url — VARCHER(255) — AWB URL
- updated_at — DATETIME — NOT NULL
- created_at — DATETIME — NOT NULL
- Key — 외래 키 — NOT NULL
tracking_events
- id — BIGINT — 기본 키 — NOT NULL — PK
- id (order_id) — BIGINT — 외래 키 → 주문.id — NOT NULL — FK
- event — VARCHAR(50) — NOT NULL
- description — VARCHAR(255)
- created_at — DATETIME — NOT NULL
- Key — 외래 키 — NOT NULL
결제 (payments)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 고유결제변호 (payment_no) — VARCHAR — NOT NULL
- Toss 고유결제키 (payment_key) — VARCHAR — UNIQUE, Toss에서 전달받은 고유 결제 키
- Toss 주문번호 (toss_order_id) — VARCHAR
- 결제 상태 (status) — ENUM — NOT NULL
- 결제 수단 (method) — INT — NOT NULL
- 결제 금액 (amount) — INT — NOT NULL
- 통화 단위 (currency) — VARCHAR — NOT NULL
- TOSS 승인 시간 (paid_at) — DATETIME
- 실패 사유 (fail_reason) — TEXT
- 결제 요청자 ID (seller_id) — BIGINT — NOT NULL
- 멱등키 (idempotency_key) — VARCHAR — NOT NULL — UNIQUE
- 단일 주문 ID (order_id) — BIGINT — 외래 키 → 주문.id — FK
- 카드번호끝4자리 (card_last4_digits) — VARCHAR(4)
- 영수증 URL (receipt_url) — VARCHAR
- 생성일시 (created_at) — DATETIME — NOT NULL
- 수정일시 (updated_at) — DATETIME — NOT NULL
결제 실패 로그 (payment_fail_logs)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 요청 URL (url) — VARCHAR(500) — NOT NULL
- 요청 바디 (requestBody) — TEXT — NOT NULL
- 멱등 키 (idempotencyKey) — VARCHAR(100) — NOT NULL
- 에러 메시지 (errorMessage) — VARCHAR(1000) — NOT NULL
- 실패 발생 시각 (failedAt) — DATETIME
- 생성 일시 (created_at) — DATETIME — NOT NULL
- 수정 일시 (updated_at) — DATETIME — NOT NULL
결제 취소 이력 (payment_cancel_histories)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 결제주문ID (payment_orders_id) — BIGINT — 외래 키 → 결제주문 중간테이블.식별자 — NOT NULL — FK
- 취소 금액 (cancelAmount) — INT — NOT NULL
- 취소 사유 (cancelReason) — VARCHAR — NOT NULL
- 취소 시각 (canceledAt) — DATETIME — NOT NULL
결제주문 중간테이블 (payment_orders)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 주문별 결제 금액 (payment_amount) — INT — NOT NULL
- 주문별 결제 상태 (payment_status) — ENUM — NOT NULL
- 결제 확정일 (confirmed_at) — DATETIME
- 결제 취소일 (canceled_at) — DATETIME
- 생성 일시 (created_at) — DATETIME — NOT NULL
- 수정 일시 (updated_at) — DATETIME — NOT NULL
- 결제 ID (payment_id) — BIGINT — 외래 키 → 결제.식별자 — NOT NULL — FK
- 주문 ID (order_id) — BIGINT — 외래 키 → 주문.id — NOT NULL — FK
받는 사람 (orders_recipients)
- id — BIGINT — 기본 키 — NOT NULL
- 수취인 주소 (recipient_address_id) — BIGINT — 외래 키 → 배송 도착지.id — NOT NULL
- order_id — BIGINT — 외래 키 → 주문.id — NOT NULL
- 수취인 이름 (recipient_name) — VARCHAR(50) — NOT NULL
- 수취인 회사 (recipient_company) — VARCHAR(50)
- 수취인 이메일 주소 (recipient_email) — VARCHAR(50)
- 수취인 연락처 (recipient_phone_no) — VARCHAR(30)
- Key — 외래 키 — NOT NULL
배송 도착지 (recipients_addresses)
- id — BIGINT — 기본 키 — NOT NULL
- recipient_country_code — VARCHAR(10)
- recipient_state — VARCHAR(30)
- recipient_state_code — VARCHAR(255)
- recipient_city — VARCHAR(30)
- recipient_address_1 — VARCHAR(100)
- recipient_address_2 — VARCHAR(100)
- recipient_zip_code — VARCHAR(20)
- recipient_tax_id — VARCHAR(30)
배송 출발지 (senders_addresses)
- id — BIGINT — 기본 키 — NOT NULL
- sender_country_code — VARCHAR(10)
- sender_state — VARCHAR(30)
- sender_state_code — VARCHAR(255)
- sender_city — VARCHAR(30)
- sender_address_1 — VARCHAR(100)
- sender_address_2 — VARCHAR(100)
- sender_zip_code — VARCHAR(20)
- sender_tax_id — VARCHAR(30)
보내는 사람 (order_senders)
- id — 기본 키 — NOT NULL
- 발송인 주소 (sender_address_id) — BIGINT — 외래 키 → 배송 출발지.id — NOT NULL
- sender_id — BIGINT — 외래 키 → 셀러.식별자 — NOT NULL — PK
- order_id — BIGINT — 외래 키 → 주문.id — NOT NULL — PK
- 주문이 들어온 이커머스 플랫폼 이름 (ex. shopify) (store_platform) — VARCHAR(30) — NOT NULL
- 판매자의 스토어 이름 (ex. shopify 사용시 해당 상점 이름) (store_name) — VARCHAR(30) — NOT NULL
- 발송인 이름 (sender_name) — VARCHAR(50) — NOT NULL
- 발송인 회사 (sender_company) — VARCHAR(50)
- 발송인 이메일 주소 (sender_email) — VARCHAR(50) — NOT NULL
- 발송인 연락처 (sender_phone_no) — VARCHAR(30) — NOT NULL
- Key — 외래 키 — NOT NULL
셀러 (sellers)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 유저식별자 (user_id) — BIGINT — 외래 키 → 유저.식별자 — NOT NULL — PK
- 성 (first_name) — VARCHAR(50) — NOT NULL
- 이름 (last_name) — VARCHAR(50) — NOT NULL
- 휴대폰번호 (phone_no) — VARCHAR(30) — NOT NULL
- 회사이름 (company_name) — VARCHAR(50) — NOT NULL
- 사업자번호 (company_register_no) — VARCHAR(50) — NOT NULL — UNIQUE
- 회사연락처 (company_tel_no) — VARCHAR(30)
유저 (users)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 이메일 (email) — VARCHAR(50) — NOT NULL — UNIQUE
- 비밀번호 (password) — VARCHAR(100) — NOT NULL
- 생성일시 (created_at) — TIMESTAMP — NOT NULL
- 수정일시 (modified_at) — TIMESTAMP — NOT NULL
- 삭제일시 (deleted_at) — TIMESTAMP
- 마지막로그인 (last_login_at) — TIMESTAMP
- 역할 (user_role) — VARCHAR(10) — NOT NULL
주문 (orders)
- id — BIGINT — 기본 키 — NOT NULL — PK
- 파트너 식별자 (partner_id) — BIGINT — 외래 키 → 파트너.식별자 — NOT NULL — FK
- 셀러 식별자 (seller_id) — BIGINT — 외래 키 → 셀러.식별자 — NOT NULL — PK
- Master No (추후 Tracking 시 식별코드 및 바코드로 사용) (oship_master_no) — VARCHAR(50) — NOT NULL
- 주문 번호 (order_mo) — VARCHAR(50) — NOT NULL
- 배송 박스 수 (parcel_count) — INT — 같은 제품을 같은 지역에 10개 보낼 수 있음
- 실제 무게 (kg 기준) (shipment_actual_weight) — DECIMAL(20, 2) — NOT NULL
- 부피 무게 (가로 * 세로 * 높이 / 5000) kg으로 취급 (shipment_volume_weight) — DECIMAL(20, 2) — NOT NULL — 가로*세로*높이 / 5000
- 무게 단위 (kg) (weight_unit) — VARCHAR(20) — kg
- 박스 가로 길이 (dimension_width) — DECIMAL(20, 2)
- 박스 세로 길이 (dimension_length) — DECIMAL(20, 2)
- 박스 높이 길이 (dimension_height) — DECIMAL(20, 2)
- 삭제된 시각 (deleted_at) — DATETIME
- Seller 혹은 Admin이라면 Admin의 이름 (deleted_by) — VARCHAR(255)
- 마지막 배송 상태 (nullable) (last_tracking_event) — VARCHAR(50)
- 바코드 출력 여부 (is_print_barcode) — BOOLEAN
- 운송장 출력 여부 (is_print_awb) — BOOLEAN
- 운송장 출력 시각 (awb_printed_at) — DATETIME — 지워질 정보
- 배송 완료 시각 (배송 트래킹에서 배송완료 되었을 때 Trigger) (delivered_at) — DATETIME
- 배송 소요 일수 (배송 트래킹에서 배송 완료 되었을 때 값 계산) (transit_day) — INT — NOT NULL
- 결제 상태 (payment_status)
- 주문 결제 상태 (PENDING, PAID, FAILED, CANCELLED, REFUNDED) (order_status) — VARCHAR(20) — NOT NULL — PENDING PAID FAILED CANCELLED REFUNDED
- 통관 조건 (shippingTerm) — VARCHAR(50)
- 물품 종류 (itemContentsType) — VARCHAR(50)
- 배송비 정책 (serviceType) — VARCHAR(50)
- 포장방식 (packageType) — VARCHAR(50)
- created_at — TIMESTAMP
- modified_at — TIMESTAMP
주소 (auth_addresses)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — Primary Key
- 유저식별자 (user_id) — BIGINT — 외래 키 → 유저.식별자 — NOT NULL — PK
- 국가 (country) — VARCHAR(50)
- 도시 이름 (city) — VARCHAR(50)
- 주/도 또는 광역 행정 단위 (state) — VARCHAR(50)
- 상세 주소 1 (예: 도로명 + 번지) (detail_1) — VARCHAR(100)
- 상세 주소 2 (예: 건물명, 층수 등) (detail_2) — VARCHAR(100)
- 우편번호 (zip_code) — VARCHAR(10) — NOT NULL
파트너 (partners)
- 식별자 (id) — BIGINT — 기본 키 — NOT NULL — PK
- 유저식별자 (user_id) — BIGINT — 외래 키 → 유저.식별자 — NOT NULL — PK
- 회사이름 (company_name) — VARCHAR(50) — NOT NULL
- 회사연락처 (company_tel_no) — VARCHAR(30)
- 사업자번호 (company_register_no) — VARCHAR(50) — NOT NULL — UNIQUE