양말바보

양말바보_ERD

테이블 (18)

admin_user_memos

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(36) — NOT NULL
  • user_id — bigint — 외래 키 → users.id — NOT NULL
  • admin_user_id — bigint — 외래 키 → admin_users.id — NOT NULL
  • content — text — NOT NULL
  • created_at — datetime — NOT NULL
  • updated_at — datetime — NOT NULL

admin_users

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(36) — NOT NULL
  • login_id — varchar(50) — NOT NULL
  • password_hash — varchar(255) — NOT NULL
  • name — varchar(50) — NOT NULL
  • role — enum('super_admin','admin') — NOT NULL
  • is_active — tinyint(1) — NOT NULL
  • token_hash — varchar(255)
  • created_at — datetime — NOT NULL
  • updated_at — datetime — NOT NULL

banners

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(36) — NOT NULL
  • image_url — varchar(500) — NOT NULL
  • product_id — bigint — 외래 키 — NOT NULL
  • sort_order — int — NOT NULL
  • is_active — tinyint — NOT NULL
  • archived_at — datetime
  • created_at — datetime(6) — NOT NULL
  • updated_at — datetime(6) — NOT NULL

cart_items

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(32) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — NOT NULL — 사용자 FK
  • variant_id — bigint — 외래 키 — NOT NULL — 상품 옵션 FK
  • quantity — int — NOT NULL — 수량
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

notices

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • title — varchar(200) — NOT NULL — 공지 제목
  • blocks — json — 내용 블록 배열 {type,content?},{type,url?}
  • is_published — tinyint(1) — NOT NULL — 공개 여부
  • published_at — datetime — 게시 시작일시 (예약 게시용)
  • archived_at — datetime — 소프트 삭제 시각
  • created_at — datetime — NOT NULL
  • updated_at — datetime — NOT NULL

order_items

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • order_id — bigint — 외래 키 → orders.id — NOT NULL — orders.id FK
  • product_variant_id — bigint — 외래 키 — NOT NULL — product_variants.id FK
  • product_name — varchar(255) — NOT NULL — 주문 시점 상품명 스냅샷
  • variant_color — varchar(50) — NOT NULL — 주문 시점 색상 스냅샷
  • variant_size — varchar(20) — NOT NULL — 주문 시점 사이즈 스냅샷
  • unit_price — int — NOT NULL — 주문 시점 단가
  • quantity — int — NOT NULL — 수량
  • line_total — int — NOT NULL — 항목 소계
  • image_url — varchar(500) — 대표 이미지 URL 스냅샷
  • created_at — datetime — NOT NULL — 생성 시각

order_status_logs

  • id — bigint — 기본 키 — NOT NULL
  • order_id — bigint — 외래 키 → orders.id — NOT NULL
  • prev_status — varchar(30) — 변경 전 상태 (최초 생성 시 NULL)
  • new_status — varchar(30) — NOT NULL — 변경 후 상태
  • reason — varchar(255) — 변경 사유
  • created_at — datetime — NOT NULL

orders

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — 회원 주문 시 사용자 FK (NULL이면 비회원)
  • order_number — varchar(64) — NOT NULL — 주문번호 (YMB-YYYYMMDD-XXXXX)
  • guest_name — varchar(50) — 주문자 이름 (비회원 시 필수)
  • guest_email — varchar(255) — 주문자 이메일
  • guest_phone — varchar(20) — 주문자 연락처 (비회원 시 필수)
  • guest_password — varchar(255) — 비회원 주문 조회용 비밀번호 (bcrypt 해시, 비회원 시 필수)
  • status — enum('CREATED', 'PAYMENT_PENDING', 'PAID', 'SHIPPING', 'DELIVERED', 'CANCELLED', 'REFUNDED') — NOT NULL — 주문 상태
  • tracking_carrier — varchar(30) — 택배사
  • tracking_number — varchar(50) — 운송장번호
  • recipient_name — varchar(50) — NOT NULL — 수령인 이름
  • recipient_phone — varchar(20) — NOT NULL — 수령인 연락처
  • postal_code — varchar(10) — NOT NULL — 우편번호
  • address — varchar(255) — NOT NULL — 기본 주소
  • address_detail — varchar(255) — 상세 주소
  • delivery_memo — varchar(255) — 배송 메모
  • total_amount — int — NOT NULL — 총 상품 금액
  • shipping_fee — int — NOT NULL — 배송비
  • used_reward_amount — int — NOT NULL — 사용한 적립금
  • pay_amount — int — NOT NULL — 실 결제 금액
  • archived_at — datetime — 소프트 삭제 시각
  • created_at — datetime — NOT NULL — 주문 생성 시각
  • updated_at — datetime — NOT NULL — 수정 시각

payments

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • order_id — bigint — 외래 키 → orders.id — NOT NULL — orders.id FK (1:1)
  • payment_key — varchar(200) — 토스페이먼츠 paymentKey
  • toss_order_id — varchar(64) — NOT NULL — 토스에 전달한 orderId
  • method — enum('CARD', 'BANK_TRANSFER', 'VIRTUAL_ACCOUNT', 'KAKAO_PAY', 'NAVER_PAY', 'TOSS_PAY', 'PAYCO', 'SAMSUNG_PAY', 'APPLE_PAY', 'REWARD') — NOT NULL — 결제 수단
  • amount — int — NOT NULL — 결제 요청 금액
  • status — enum('PENDING', 'SUCCESS', 'FAILED', 'CANCELLED', 'REFUNDED', 'PARTIAL_REFUNDED') — NOT NULL — 결제 상태
  • virtual_account_bank — varchar(20) — 가상계좌 은행명
  • virtual_account_number — varchar(30) — 가상계좌번호
  • virtual_account_due_date — datetime — 가상계좌 입금기한
  • approved_at — datetime — 결제 승인 시각
  • cancelled_at — datetime — 취소 시각
  • cancel_reason — varchar(255) — 취소 사유
  • fail_reason — varchar(255) — 실패 사유
  • toss_raw_response — json — 토스 응답 원본
  • created_at — datetime — NOT NULL — 생성 시각
  • updated_at — datetime — NOT NULL — 수정 시각

product_likes

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(32) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — NOT NULL
  • product_id — bigint — 외래 키 — NOT NULL
  • created_at — datetime — NOT NULL

reviews

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(32) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — NOT NULL
  • product_id — bigint — 외래 키 — NOT NULL
  • order_id — bigint — 외래 키 → orders.id — 주문 FK (봇 리뷰는 NULL)
  • rating — tinyint — NOT NULL — 별점 1~5
  • content — text — NOT NULL — 리뷰 본문
  • image_url — varchar(500) — 리뷰 이미지
  • purchased_options — varchar(500) — NOT NULL — 구매 옵션
  • reward_amount — int — NOT NULL — 적립금
  • is_hidden — tinyint(1) — NOT NULL — 어드민 숨김 여부
  • is_bot — tinyint(1) — NOT NULL — 봇 리뷰 여부
  • created_at — datetime — NOT NULL
  • updated_at — datetime — NOT NULL
  • deleted_at — datetime — 소프트 삭제 시각

reward_histories

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — NOT NULL — 사용자 FK
  • type — enum('SIGNUP', 'PURCHASE', 'REVIEW_TEXT', 'REVIEW_IMAGE', 'USAGE', 'ADMIN_CREDIT', 'ADMIN_DEBIT') — NOT NULL — 적립금 유형
  • amount — int — NOT NULL — 변동 금액 (양수=적립, 음수=사용)
  • balance — int — NOT NULL — 변동 후 잔액
  • description — varchar(255) — NOT NULL — 설명
  • reference_id — varchar(100) — 참조 ID (주문 UUID 또는 리뷰 UUID)
  • created_at — datetime — NOT NULL — 생성 시각

shipping_addresses

  • id — bigint — 기본 키 — NOT NULL — 내부 PK
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • user_id — bigint — 외래 키 → users.id — NOT NULL — 사용자 FK
  • name — varchar(50) — NOT NULL — 배송지 이름 (예: 집, 회사)
  • recipient_name — varchar(50) — NOT NULL — 수령인 이름
  • recipient_phone — varchar(20) — NOT NULL — 수령인 연락처
  • postal_code — varchar(5) — NOT NULL — 우편번호
  • address — varchar(255) — NOT NULL — 주소
  • address_detail — varchar(255) — 상세주소
  • is_default — tinyint(1) — NOT NULL — 기본 배송지 여부
  • created_at — datetime(6) — NOT NULL — 생성 시각
  • updated_at — datetime(6) — NOT NULL — 수정 시각

users

  • id — bigint — 기본 키 — NOT NULL
  • uuid — char(36) — NOT NULL — 외부 노출용 UUID
  • type — enum('NORMAL', 'BOT') — NOT NULL — 사용자 유형
  • provider — enum('EMAIL', 'KAKAO', 'NAVER', 'GOOGLE') — NOT NULL — 가입 경로
  • email — varchar(255) — NOT NULL — 이메일 (로그인 ID)
  • password_hash — varchar(255) — 비밀번호 (bcrypt 해시, 소셜 로그인 시 NULL)
  • name — varchar(50) — 이름
  • nickname — varchar(50) — NOT NULL — 닉네임
  • phone — varchar(20) — 연락처
  • profile_image_url — varchar(500) — 프로필 이미지 URL
  • social_provider — enum('EMAIL', 'KAKAO', 'NAVER', 'GOOGLE') — 연동된 소셜 로그인 (NULL이면 미연동)
  • social_id — varchar(255) — 소셜 로그인 고유 ID
  • status — enum('active', 'suspended') — NOT NULL
  • agreed_to_marketing — tinyint(1) — NOT NULL — 마케팅 수신 동의 여부
  • token_hash — varchar(255) — Refresh Token SHA-256 해시
  • last_login_at — datetime — 마지막 로그인 시각
  • archived_at — datetime — 소프트 삭제 시각 (NULL이면 활성)
  • created_at — datetime — NOT NULL
  • updated_at — datetime — NOT NULL
  • is_temporary_password — tinyint(1) — NOT NULL — 임시 비밀번호 사용 여부
  • reward_balance — int — NOT NULL — 적립금 잔액

상품 (products)

  • id — BIGINT — 기본 키 — 내부 PK (조인용 숫자 ID)
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 UUID (API/URL 식별자)
  • name — VARCHAR(255) — NOT NULL — 상품명(한글)
  • line_name — VARCHAR(100) — NOT NULL — 라인명(필수) 예: 클래식no.1
  • brand_name — VARCHAR(50) — NOT NULL — 브랜드명(고정값: 양말바보)
  • short_desc — VARCHAR(255) — 상품 한 줄 설명(리스트/검색용)
  • detail_desc — TEXT — 상품 상세 설명(상세페이지 본문)
  • price — INT — NOT NULL — 판매가
  • original_price — INT — 정상가(할인 표시용, 없으면 NULL)
  • material_text — TEXT — 소재/혼용률 원문 텍스트
  • release_date — DATE — 출시일(없으면 NULL)
  • categories — JSON — NOT NULL — 카테고리(다중 선택) - 예: ["남성","여성"]
  • season — ENUM('사계절', '여름', '겨울') — NOT NULL — 계절감(단일선택)
  • stretch — ENUM('적음', '적당함', '좋음') — NOT NULL — 신축성(단일선택)
  • thickness — ENUM('얇음', '적당함', '두꺼움') — NOT NULL — 두께감(단일선택)
  • length — ENUM('덧신', '발목', '중목', '장목', '니삭스') — NOT NULL — 길이(단일선택)
  • status — ENUM('DRAFT', 'ACTIVE', 'HIDDEN') — NOT NULL — 상태: 임시/노출/숨김
  • archived_at — DATETIME — 소프트 삭제 시각(NULL이면 활성)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각' ) undefined='상품 기본 정보(카테고리/필터 포

상품 공통 이미지 (product_images)

  • id — BIGINT — 기본 키 — 내부 PK
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 UUID
  • product_id — BIGINT — NOT NULL — products.id FK
  • type — ENUM('MAIN', 'DETAIL') — NOT NULL — 이미지 타입: MAIN(대표)/DETAIL(상세)
  • image_url — VARCHAR(500) — NOT NULL — 이미지 URL(S3 등)
  • sort_order — INT — NOT NULL — 정렬 순서(작을수록 먼저 노출)
  • created_at — DATETIME — NOT NULL — 생성 시각

색상별 이미지 (variant_images)

  • id — BIGINT — 기본 키 — 내부 PK
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 UUID
  • product_variant_id — BIGINT — NOT NULL — product_variants.id FK (색상별 이미지 연결)
  • image_url — VARCHAR(500) — NOT NULL — 이미지 URL(S3 등)
  • sort_order — INT — NOT NULL — 정렬 순서
  • created_at — DATETIME — NOT NULL — 생성 시각

옵션+재고 (product_variants)

  • id — BIGINT — 기본 키 — 내부 PK
  • product_id — BIGINT — NOT NULL — products.id FK
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 UUID(옵션 단위)
  • color — VARCHAR(50) — NOT NULL — 색상(예: 블랙/화이트)
  • size — VARCHAR(50) — NOT NULL — 사이즈(예: S/M/L, 남260~290, 아동M 등)
  • stock_qty — INT — NOT NULL — 재고 수량(초기값 0)
  • is_active — BOOLEAN — NOT NULL — 옵션 노출 여부
  • archived_at — DATETIME — 옵션 소프트 삭제 시각(NULL이면 활성)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각