양말바보
양말바보_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 — 수정 시각