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일 후 물리 삭제