superstructure
테이블 (36)
design_thumbnails
- design_id — UUID — 기본 키 — NOT NULL — PK+FK designs(id), 디자인 삭제 시 CASCADE. 디자인당 썸네일 1개
- design_updated_at — TIMESTAMP(3) — NOT NULL — 생성 기준 저장 시각 — 생성에 읽은 designs.updated_at, 현재 값과 같을 때만 표시
- edit_area_id — UUID — NOT NULL — FK product_edit_areas(id), 편집영역 삭제 RESTRICT, INDEX(edit_area_id). 상품 최신 버전과 다르면 재생성 대상
- file_key — TEXT — NOT NULL — UNIQUE, 썸네일 S3 키
- created_at — TIMESTAMP(3) — NOT NULL
감사 로그 (audit_logs)
- 로그 id (id) — UUID — 기본 키 — NOT NULL — PK
- 행위 (action) — TEXT — NOT NULL
- 행위자 id (actor_id) — UUID — 액션을 누가 했는가
- 타겟 id (target_id) — UUID — 액션을 누구에게 했는가
- IP 주소 (ip_address) — TEXT
- 사용자 에이전트 (user_agent) — TEXT — 요청을 보낸 클라이언트 User-Agent 정보
- 요청 id (request_id) — TEXT — 요청 상관 관계
- 성공 상태 (succeeded) — BOOLEAN — NOT NULL
- detail — JSONB
- 발생 시각 (occurred_at) — TIMESTAMP(3) — NOT NULL — 1년 보존 후 매일 04시 삭제
검증 토큰 (verification_tokens)
- 토큰id (id) — UUID — 기본 키 — NOT NULL — PK
- 회원id (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL — FK
- 토큰 타입 (type) — ENUM — NOT NULL — ENUM(EMAIL_VERIFICATION, PASSWORD_RESET)
- 토큰 해시 (token_hash) — TEXT — NOT NULL
- 만료 일시 (expires_at) — TIMESTAMP(3) — NOT NULL
- 소비 일시 (consumed_at) — TIMESTAMP(3)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
기획전 (exhibitions)
- 기획전 id (id) — UUID — 기본 키 — NOT NULL — PK
- 카테고리id (purpose_id) — UUID — 외래 키 → 기획전 카테고리.카테고리id — NOT NULL — FK
- 제목 (title) — TEXT — NOT NULL
- 납기 문구 (lead_time_note) — TEXT — NOT NULL
- 노출 순서 (display_order) — INT — NOT NULL
- 대표이미지키 (image_key) — TEXT
- 공개 여부 (is_visible) — BOOLEAN — NOT NULL — CHECK(NOT is_visible OR image_key IS NOT NULL)
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
기획전 카테고리 (exhibition_purposes)
- 카테고리id (id) — UUID — 기본 키 — NOT NULL — PK
- 카테고리 명 (name) — TEXT — NOT NULL
- 노출 순서 (display_order) — INT — NOT NULL
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
디자인 참조 에셋 (design_asset_refs)
- 참조id (id) — UUID — 기본 키 — NOT NULL
- 디자인id (design_id) — UUID — 외래 키 → 사용자 디자인.디자인id
- 에셋ID (asset_id) — UUID — 외래 키 → 사용자 업로드 에셋.에셋ID — NOT NULL
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL — DEFAULT now()
- 삭제 시각 (remove_at) — TIMESTAMP — NULL 이면 살아 있는 참조
랜딩페이지_이미지 (landing_images)
- 이미지id (id) — UUID — 기본 키 — NOT NULL — PK
- 구역 (section) — ENUM — NOT NULL — ENUM(HERO)
- 이미지키 (image_key) — TEXT — NOT NULL
- 노출 순서 (display_order) — INT — NOT NULL
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
본인인증 (identities)
- 본인인증 id (id) — UUID — 기본 키 — NOT NULL — PK
- 회원id (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL — FK+UNIQUE
- 인증대행사 (provider) — ENUM — NOT NULL — ENUM(MOCK, NICE, KCB, DANAL)
- CI 검색해시 (ci_hash) — TEXT — NOT NULL — UNIQUE
- CI 암호문 (ci_encrypted) — TEXT — NOT NULL
- DI 암호문 (di_encrypted) — TEXT
- 실명 암호문 (name_encrypted) — TEXT — NOT NULL
- 생년월일 암호문 (birth_date_encrypted) — TEXT — NOT NULL
- 휴대폰 검색 해시 (phone_hash) — TEXT — NOT NULL — INDEX()
- 휴대폰 암호문 (phone_encrypted) — TEXT — NOT NULL
- 인증 완료 일시 (verified_at) — TIMESTAMP(3) — NOT NULL
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
사용자 디자인 (designs)
- 디자인id (id) — UUID — 기본 키 — NOT NULL
- 디자인 소유자 (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL
- 선택 색상 옵션 (color_option_id) — UUID — NOT NULL
- 디자인 이름 (name) — TEXT — NOT NULL
- 문서 스키마 버전 (schema_version) — INT — NOT NULL
- 디자인 문서 (body) — JSONB — NOT NULL
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
사용자 업로드 에셋 (design_assets)
- 에셋ID (id) — UUID — 기본 키 — NOT NULL
- 회원id (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL
- 내용 해시 (sha256) — TEXT — NOT NULL — 소문자 hex 64자, ready_at 이 있으면 필수
- 파일 키 (file_key) — TEXT — NOT NULL
- 콘텐츠 타입 (content_type) — TEXT — NOT NULL
- 원본 가로 px (width_px) — INT
- 원본 세로 px (height_px) — INT
- 준비 시각 (ready_at) — TIMESTAMP
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
상품 (products)
- 상품id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품 상태 (status) — ENUM — NOT NULL — ENUM(DRAFT, PUBLISHED, HIDDEN), 발행 가드: 편집영역+소분류 연결 1개 이상+가격 필수
- 상품명 (name) — TEXT — NOT NULL
- 최소 주문 수량 (min_order_qty) — INT — NOT NULL — 최소 주문 수량
- 실측 넓이 (width_mm) — DECIMAL(9,2) — NOT NULL
- 실측 높이 (height_mm) — DECIMAL(9,2) — NOT NULL
- 실측 깊이 (depth_mm) — DECIMAL(9,2) — NOT NULL
- 납기 안내 (lead_time_note) — TEXT — NOT NULL — 납기 안내
- 소재 정보 (material_note) — TEXT — NOT NULL — 소재 정보
- 제작 조건 안내 (production_note) — TEXT — NOT NULL — 제작 조건 안내
- 상세페이지 이미지 (detail_image_key) — TEXT — 상세페이지 이미지, 최대 1장이라 컬럼
- 대표 단가 (base_unit_price) — DECIMAL(18, 2) — 파생: 최소수량 구간 단가 사본, 정렬·필터용, 가격 수정 트랜잭션에서 재계산, INDEX(status, base_unit_price)
- 추천 순위 (recommended_rank) — INT — 추천순 정렬(기준 미확정), 낮을수록 앞
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
- 삭제 일시 (deleted_at) — TIMESTAMP(3)
상품 가격 구간 (product_price_tiers)
- 가격 구간id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK, 상품 삭제 시 CASCADE, 복합 UNIQUE(product_id, min_qty)
- 최소수량 (min_qty) — INT — NOT NULL — 적용 구간 = min_qty<=주문수량 중 최대, 첫 구간=min_order_qty(앱 검증)
- 개당 단가 (unit_price) — DECIMAL(18, 2) — NOT NULL — 개당 단가
- 생성 일시 (created_at) — TIMESTAMP — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP — NOT NULL
상품 대표 이미지 (product_images)
- 이미지id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK, 상품 삭제 시 CASCADE
- 이미지주소 (image_key) — TEXT — NOT NULL
- 노출 순서 (display_order) — INT — NOT NULL — 대표사진 최대 5장(앱 검증), INDEX(product_id, display_order)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
상품 색상 옵션 (product_color_options)
- 색상 옵션id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK, 상품 삭제 시 CASCADE
- 색상명 (name) — TEXT — NOT NULL — 운영자 자유 입력 색상명
- 색상코드 (color_code) — TEXT — NOT NULL — HEX, 스와치 렌더링용
- 색상군 (color_family) — ENUM — NOT NULL — ENUM(BLACK, WHITE, GRAY, RED, ORANGE, YELLOW, GREEN, BLUE, PURPLE, PINK, BROWN, BEIGE, MULTI), 사용자 색상 필터 전용, INDEX(colo…
- 수급가능여부 (is_available) — BOOLEAN — NOT NULL — 수급 가능 여부, 재고 없음 — 유일한 가용성 관리
- 미리보기 이미지 주소 (preview_image_key) — TEXT — 색상 선택 시 미리보기 전환용(소속 미확정)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
상품 편집 영역 (product_edit_areas)
- 편집 영역id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK, 복합 UNIQUE(product_id, version)
- 버전 (version) — INT — NOT NULL — 불변 버전 행 — 수정=version+1 INSERT, UPDATE 금지, 최신=max(version)
- 정의 스키마 버전 (schema_version) — INT — NOT NULL
- 영역 정의 (definition) — JSONB — NOT NULL — 캔버스·인쇄 가능 영역 정의, editor 모듈 소유(catalog 는 읽지 않음)
- 생성 일시 (created_by) — TIMESTAMP — NOT NULL
상품 허용 잉크 색상 (product_ink_colors)
- 연결id (id) — UUID — 기본 키 — NOT NULL
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — PK
- 잉크 색상 id (ink_color_id) — UUID — 외래 키 → 잉크 색상 마스터.잉크 색상 id — NOT NULL
- 생성시각 (created_at) — TIMESTAMP — NOT NULL
상품 허용 폰트 (product_fonts)
- 연결id (id) — UUID — 기본 키 — NOT NULL
- 상품id (product_id2) — UUID — 외래 키 → 상품.상품id — NOT NULL
- 폰트id (font_id) — UUID — 외래 키 → 폰트 마스터.폰트id — NOT NULL
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
상품-기획전 링크 (exhibition_products)
- 상품-기획전 링크id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK
- 기획전id (exhibition_id) — UUID — 외래 키 → 기획전.기획전 id — NOT NULL — FK
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
상품-인쇄 방식 연결 (product_print_methods)
- 상품-인쇄 방식 연결id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK
- 인쇄 방식id (print_method_id) — UUID — 외래 키 → 인쇄 방식.인쇄 방식id — NOT NULL — FK
- 생성 일시 (created_at) — TIMESTAMP — NOT NULL
상품-카테고리 연결 (product_categories)
- 연결 id (id) — UUID — 기본 키 — NOT NULL — PK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK, 상품 삭제 시 CASCADE, 복합 UNIQUE(product_id, category_id)
- 카테고리id (category_id) — UUID — 외래 키 → 카테고리.카테고리id — NOT NULL — FK, 카테고리 삭제 시 CASCADE, 소분류만 허용(앱 검증), INDEX(category_id)
- 대표 카테고리 여부 (is_primary) — BOOLEAN — NOT NULL — 대표 카테고리(브레드크럼 경로용), 상품당 정확히 1개(앱 검증)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
소셜계정연결 (social_accounts)
- 소셜연결id (id) — UUID — 기본 키 — NOT NULL — PK
- 회원id (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL — FK
- 소셜제공자 (provider) — ENUM — NOT NULL — ENUM(NAVER, KAKAO)
- 제공자 회원 번호 (provider_account_id) — TEXT — NOT NULL
- 연결 일시 (linked_at) — TIMESTAMP(3) — NOT NULL
약관동의이력 (user_agreements)
- 동의이력id (id) — UUID — 기본 키 — NOT NULL — PK
- 회원id (user_id) — UUID — 외래 키 → 회원.회원id — NOT NULL — FK
- 동의항목 (type) — ENUM — NOT NULL — ENUM(TERMS_OF_SERVICE, PRIVACY_POLICY, AGE_OVER_19, MARKETING_EMAIL, MARKETING_SMS)
- 약관버전 (version) — TEXT — NOT NULL
- 동의여부 (agreed) — BOOLEAN — NOT NULL
- 동의일시 (agreed_at) — TIMESTAMP(3) — NOT NULL
- 접속IP (ip_address) — TEXT
- 접속환경 (user_agent) — TEXT
인쇄 방식 (print_methods)
- 인쇄 방식id (id) — UUID — 기본 키 — NOT NULL — PK
- (name) — TEXT — NOT NULL — UNIQUE
- 생성 일시 (created_at) — TIMESTAMP — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP — NOT NULL
잉크 색상 마스터 (ink_colors)
- 잉크 색상 id (id) — UUID — 기본 키 — NOT NULL
- 잉크 색상 명 (name) — TEXT — NOT NULL
- HEX (color_code) — TEXT — NOT NULL
- 삭제 시각 (deleted_at) — TIMESTAMP
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
추천 설정 (recommendation_settings)
- 설정id (id) — INT — 기본 키 — NOT NULL — PK
- 인기 집계 기간 (popularity_window_days) — INT — NOT NULL — 양수
- 조회 가중치 (view_weight) — INT — NOT NULL — 0이상
- 견적 가중치 (quote_weight) — INT — NOT NULL — 0이상
- 주문 가중치 (order_weight) — INT — NOT NULL — 0이상
- 부모 규칙 (parent_rules) — JSONB — NOT NULL
- 생성 일시 (created_at) — TIJMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
추천 스냅샷 (recommendation_snapshots)
- 스냅샷id (id) — UUID — 기본 키 — NOT NULL — PK
- 상태 (status) — ENUM — NOT NULL — ENUM(BUILDING, ACTIVE, ARCHIVED)
- 계산 시작 일시 (calculation_started_at) — TIMESTAMP(3) — NOT NULL
- 계산 완료 일시 (generated_at) — TIMESTAMP(3)
- 활성화 일시 (activated_at) — TIMESTAMP(3)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
추천 스냅샷 상품 (recommendation_snapshot_items)
- 스냅샷id (snapshot_id) — UUID — 외래 키 → 추천 스냅샷.스냅샷id — NOT NULL — PK,FK
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — PK,FK
- 인기도 점수 (populartiy_score) — BIGINT — NOT NULL
- store순위 (store_rank) — INT — NOT NULL
- home순위 (home_rank) — INT
- 선정 출처 (source) — ENUM — NOT NULL — ENUM(PINNED,AUTOMATIC)
카테고리 (categories)
- 카테고리id (id) — UUID — 기본 키 — NOT NULL — PK
- 부모 카테고리 id (parent_id) — UUID — 외래 키 → 카테고리.카테고리id — FK(자기참조), NULL=대분류, 부모 삭제 시 CASCADE
- 카테고리 명 (name) — TEXT — NOT NULL
- 노출 순서 (display_order) — INT — NOT NULL — 같은 부모 아래 형제 간 순서, INDEX(parent_id, display_order)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
탈퇴 사용자 정보 (withdrawn_identities)
- 탈퇴 사용자 id (id) — UUID — 기본 키 — NOT NULL — PK
- CI 해시 (ci_hash) — TEXT — NOT NULL — UNIQUE
- 탈퇴 시각 (withdrawn_at) — TIMESTAMP(3) — NOT NULL
포트폴리오 (portfolio_items)
- 포트폴리오id (id) — UUID — 기본 키 — NOT NULL — PK
- 제목 (title) — TEXT — NOT NULL
- 고객사 이름 (client_name) — TEXT — ??아직미정
- 브랜드로고 경로 (brand_logo_key) — TEXT — ??아직미정
- 회사소개 (company_introduction) — TEXT — NOT NULL
- 제작배경 (production_background) — TEXT — NOT NULL
- 공개 여부 (is_visible) — BOOLEAN — NOT NULL — DEFAULT false
- 목록 순서 (display_order) — INT — NOT NULL
- 홈 노출 순서 (home_display_order) — INT — NULL이면 홈 미선택
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
포트폴리오 사진 (portfolio_images)
- 사진id (id) — UUID — 기본 키 — NOT NULL — PK
- 포트폴리오id (portfolio_id) — UUID — 외래 키 → 포트폴리오.포트폴리오id — NOT NULL — FK
- 사진 경로 (image_key) — TEXT — NOT NULL — UNIQUE
- 사진 순서 (display_order) — INT — NOT NULL — 첫 사진이 대표사진
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
포트폴리오 카테고리 (portfolio_categories)
- 카테고리id (id) — UUID — 기본 키 — NOT NULL — PK
- 카테고리명 (name) — TEXT — NOT NULL — UNIQUE
- 노출 순서 (display_order) — INT — NOT NULL
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
포트폴리오-상품 연결 (portfolio_products)
- 연결id (id) — UUID — 기본 키 — NOT NULL — PK
- 포트폴리오id (protfolio_id) — UUID — 외래 키 → 포트폴리오.포트폴리오id — NOT NULL — FK, 복합 UNIQUE(protolio_id, product_id)
- 상품id (product_id) — UUID — 외래 키 → 상품.상품id — NOT NULL — FK
- 상품 순서 (display_order) — INT — NOT NULL
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
포트폴리오-카테고리 연결 (portfolio_category_links)
- 연결id (id) — UUID — 기본 키 — NOT NULL — PK
- 포트폴리오id (portfolio_id) — UUID — 외래 키 → 포트폴리오.포트폴리오id — NOT NULL — FK, 복합 UNIQUE(portfolio_id, category_id)
- 카테고리id (category_id) — UUID — 외래 키 → 포트폴리오 카테고리.카테고리id — NOT NULL — FK
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
폰트 마스터 (fonts)
- 폰트id (id) — UUID — 기본 키 — NOT NULL
- 폰트 패밀리 명 (family_name) — TEXT — NOT NULL
- 폰트 파일 (file_key) — TEXT — NOT NULL
- 파일 포맷 (format) — TEXT — NOT NULL
- 내용 해시 (sha256) — TEXT — NOT NULL
- 삭제 시각 (deleted_at) — TIMESTAMP
- 생성 시각 (created_at) — TIMESTAMP — NOT NULL
- 수정 시각 (updated_at) — TIMESTAMP — NOT NULL
회원 (users)
- 회원id (id) — UUID — 기본 키 — NOT NULL — PK
- 유저 이메일 (email) — TEXT — NOT NULL — UNIQUE, INDEX
- 패스워드 (password_hash) — TEXT
- 이름 (name) — TEXT — NOT NULL
- 역할 (role) — ENUM — NOT NULL — ENUM(ADMIN, USER)
- 차단사유 (blocked_reason) — TEXT
- 이메일 인증 완료 시각 (email_verified_at) — TIMESTAMP(3)
- 본인인증 완료 시각 (identity_verified_at) — TIMESTAMP(3)
- 생성 일시 (created_at) — TIMESTAMP(3) — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMP(3) — NOT NULL
- 탈퇴 일시 (deleted_at) — TIMESTAMP(3) — softDelete()
- 차단 일시 (blocked_at) — TIMESTAMP(3) — INDEX