tavga

Tables (16)

Model (AI 모델)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • name (모델명) — NOT NULL
  • slug (Field) — NOT NULL — UNIQUE
  • provider (제공자) — NOT NULL
  • icon_url (Field2) — NULL
  • is_active (활성화 유무) — NOT NULL — true
  • sort_order (정렬 순서) — NOT NULL — 0
  • created_at (생성일) — NOT NULL
  • updated_at (수정일) — NOT NULL
  • aspect_ratios (Field3) — NULL
  • durations (Field4) — NULL
  • capabilities (Field5) — NULL
  • rendering_speeds (Field6) — NULL

characters (캐릭터)

  • id (PK) — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL
  • name (Field)
  • gender (Field2)
  • image_urls (Field3)
  • thumbnail_url (Field4)
  • is_preset (Field5)
  • created_at (Field6)
  • updated_at (Field7)
  • deleted_at (Field8)

credit_balances (크레딧 잔액)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:1, UNIQUE
  • balance (잔액) — NOT NULL — 기본값 0
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

credit_packages (크레딧 상품 목록)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • name (상품명) — NOT NULL — 500 크레딧
  • credits (지급 크레딧) — NOT NULL — 500
  • price (가격) — NOT NULL
  • currency (통화) — NOT NULL — KRW/USD
  • is_active (판매 여부) — NOT NULL — false면 판매 중지
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

credit_transactions (크레딧 변동 이력)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:N
  • type (변동 유형) — NOT NULL
  • amount (변동량) — NOT NULL — +충전, -차감
  • balance_after (변동 후 잔액) — NOT NULL — 정합성 검증용
  • reference_type (참조 대상) — NULL — PAYMENT, GENERATION
  • reference_id (참조 ID) — NULL — payments.id, generations.id
  • description (설명) — NULL — "이미지 생성 1회 차감"
  • created_at (생성일자) — NOT NULL

custom_voices (커스텀 보이스)

  • id (PK) — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL
  • name (Field)
  • gender (Field2)
  • language (Field3)
  • Field4 (accent)
  • previewImageUrl (Field4)
  • externalVoiceId (Field5)
  • previewAudioUrl (Field6)
  • created_at (Field7)
  • updated_at (Field8)

generations (생성)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:N
  • type (생성 유형) — NOT NULL — TEXT/IMAGE/VIDEO
  • model (모델명) — NOT NULL — gpt-4o, claude-3.5
  • prompt (프롬프트) — NOT NULL
  • result_text (결과 텍스트) — NULL
  • result_url (결과 URL) — NULL — 이미지/파일 URL
  • thumbnail_url (썸네일 URL) — NULL
  • duration_sec (소요 시간) — NULL
  • cost_usd (AI API 원가) — NULL
  • job_id (비동기 작업 ID) — NULL — API가 결과 대신 작업 ID 내려줌
  • job_status (작업 상태) — NULL
  • is_starred (즐겨찾기) — NOT NULL — 기본값 false
  • share_token (공유 토큰) — NULL — UNIQUE
  • share_token_expires_at (공유 만료일) — NULL
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL
  • deleted_at (삭제일자) — NULL — soft delete

inquiries (고객문의)

  • id (PK) — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL
  • title (Field)
  • content (Field2)
  • status (Field3)
  • answer (Field4)
  • answered_at (Field5)
  • answered_by_id (Field6)
  • created_at (Field7)
  • updated_at (Field8)

inquiry_attachments (고객문의 첨부파일)

  • id (PK) — Primary key — NOT NULL
  • inquiry_id (고객문의 ID) — Foreign key → inquiries.id — NOT NULL
  • file_url (Field)
  • file_name (Field2)
  • file_size (Field3)
  • created_at (Field4)

monthly_usages (월별 한도 카운팅 | UNIQUE(user_id, year_month))

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:N
  • year_month (년월) — NOT NULL — 2026-02
  • text_count (텍스트 횟수) — NOT NULL — 기본값 0
  • image_count (이미지 횟수) — NOT NULL — 기본값 0
  • video_count (영상 횟수) — NOT NULL — 기본값 0
  • music_count (음악 횟수) — NOT NULL — 기본값 0
  • stt_count (STT 횟수) — NOT NULL — 기본값 0
  • tts_count (TTS 횟수) — NOT NULL — 기본값 0
  • bg_remove_count (배경제거 횟수) — NOT NULL — 기본값 0
  • total_cost_usd (AI API 원가) — NOT NULL — 기본값 0
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

oauth_account (소셜 로그인 계정 | UNIQUE(provider, provider_account_id))

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (FK) — NOT NULL — Foreign key → users.id — NOT NULL
  • provider (소셜 제공자) — NOT NULL — google/kakao/naver
  • provider_account_id (소셜 고유 ID) — NOT NULL
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

payment_methods (결제 방식)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (FK) — NOT NULL — Foreign key → users.id — NOT NULL
  • pg_provider (PG사) — NOT NULL — TOSS/STRIPE
  • billing_key (빌링키) — NOT NULL — 토스:billingKey, Stripe:pm_xxx
  • card_last4 (카드 뒤 4자리) — NULL — UI 표시용
  • card_brand (카드 브랜드) — NULL — visa/master/현대 등
  • is_default (기본 결제 수단) — NOT NULL
  • created_at (생성일자) — NOT NULL
  • deleted_at (삭제일자) — NULL — 카드 삭제시 soft delete

payments (결제)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:N
  • payment_method_id (결제 방식 ID) — NULL — Foreign key → payment_methods.id — NOT NULL — 1:N, 무료 크레딧 지급 등은 NULL
  • subscription_id (구독 ID) — NULL — Foreign key → subscriptions.id — NOT NULL — 1:N, 구독 결제일 때만
  • credit_package_id (크레딧 패키지 ID) — NULL — Foreign key → credit_packages.id — NOT NULL — 1:N, 크레딧 구매일 때만
  • order_id (주문 ID) — NOT NULL — UNIQUE
  • type (결제 유형) — NOT NULL — SUBSCRIPTION/CREDIT_PURCHASE/REFUND
  • amount (금액) — NOT NULL
  • currency (통화) — NOT NULL — KRW/USD
  • status (결제 상태) — NOT NULL — SUCCESS/FAILED/REFUNDED/PENDING
  • pg_provider (PG사) — NOT NULL — TOSS/STRIPE
  • pg_transaction_id (PG 거래 ID) — NOT NULL — 토스 orderId / Stripe pi_xxx
  • paid_at (결제일시) — NULL — 결제 성공시
  • created_at (생성일자) — NOT NULL

plans (구독 플랜)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • code (플랜 코드) — NOT NULL — UNIQUE, FREE/STANDARD/PRO/TEAM
  • name (플랜명) — NOT NULL — 무료, 스탠다드,프로,팀
  • price (가격) — NOT NULL — 소수점 두 자리 표시
  • currency (통화) — NOT NULL — KRW/USD
  • billing_interval (결제 주기) — NOT NULL — MONTHLY/YEARLY
  • text_limit (텍스트 한도) — NULL — NULL=무제한
  • image_limit (이미지 한도) — NULL — NULL=무제한
  • document_limit (문서 한도) — NULL — NULL=무제한
  • monthly_credit_grant (월 지급 크레딧) — NOT NULL — 0이면 없음
  • features (부가기능) — NULL — 커스텀 페르소나, API 등
  • is_active (판매 여부) — NOT NULL — false면 신규 가입 불가
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

subscriptions (구독)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • user_id (유저 ID) — NOT NULL — Foreign key → users.id — NOT NULL — 1:N(구독 변경을 처리하기 위해)
  • plan_id (플랜 ID) — NOT NULL — Foreign key → plans.id — NOT NULL — 1:N
  • payment_method_id (결제 방식 ID) — NULL — Foreign key → payment_methods.id — NOT NULL — 1:N(현실적으로 1:1), 무료는 NULL
  • status (구독 상태) — NOT NULL — ACTIVE/CANCELLED/PAST_DUE/EXPIRED
  • current_period_start (현재 구간 시작) — NOT NULL
  • current_period_end (현재 구간 종료) — NOT NULL
  • cancelled_at (해지일) — NULL
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL

users (유저)

  • id (PK) — NOT NULL — Primary key — NOT NULL
  • email (이메일) — NOT NULL — UNIQUE
  • display_name (표시 이름) — NOT NULL
  • password_hash (소셜 로그인은 NULL) — NULL — 소셜 로그인은 NULL
  • role (권한) — NOT NULL
  • email_verfied_at (이메일 인증 일시) — NULL
  • created_at (생성일자) — NOT NULL
  • updated_at (수정일자) — NOT NULL
  • deleted_at (탈퇴 시점, 30일 후 물리 삭제) — NULL — 탈퇴 시점, 30일 후 물리 삭제