ringle_ai_tutor

Tables (7)

conversations (대화세션)

  • id (대화세션 ID) — BIGINT — Primary key — NOT NULL
  • user_id (회원 ID) — BIGINT — Foreign key → users.id — NOT NULL
  • topic (대화주제) — VARCHAR(50) — NOT NULL
  • model (사용 LLM 모델명) — VARCHAR(50) — NOT NULL
  • ended_at (종료 시각) — TIMESTAMPTZ
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정 시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제 여부) — BOOLEAN — NOT NULL

memberships (멤버십 상품)

  • id (멤버십 상품 ID) — BIGINT — Primary key — NOT NULL
  • code (상품코드) — VARCHAR(50) — NOT NULL — UNIQUE
  • name (표시 이름) — VARCHAR(100) — NOT NULL
  • description (상품설명) — VARCHAR(500)
  • duration_days (이용기간) — INT — NOT NULL
  • price (가격) — INT — NOT NULL
  • feature_learning (학습 기능 권한) — BOOLEAN — NOT NULL
  • feature_conversation (대화 기능 권한) — BOOLEAN — NOT NULL
  • feature_analysis (분석 기능 권한) — BOOLEAN — NOT NULL
  • created_at (생성시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제 여부) — BOOLEAN — NOT NULL

messages (대화 메시지)

  • id (메시지 ID) — BIGINT — Primary key — NOT NULL
  • conversation_id (대화세션 ID) — BIGINT — Foreign key → conversations.id — NOT NULL — UNIQUE(conversation_id, seq)
  • seq (대화 내 순번) — INT — NOT NULL
  • role (발화 주체) — TEXT — NOT NULL
  • content (생성 텍스트) — TEXT — NOT NULL
  • audio_url (오디오 저장 경로) — VARCHAR(500)
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정 시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제여부) — BOOLEAN — NOT NULL

orders (주문)

  • id (주문 ID) — BIGINT — Primary key — NOT NULL
  • user_id (회원 ID) — BIGINT — Foreign key → users.id — NOT NULL
  • membership_id (멤버십 상품 ID) — BIGINT — Foreign key → memberships.id — NOT NULL
  • amount (확정 결제 금액) — INT — NOT NULL
  • order_number (주문번호) — VARCHAR(64) — NOT NULL — UNIQUE, 서버생성,PG전달용
  • status (주문 상태) — TEXT — NOT NULL — CHECK (status IN ('CREATED', 'PAYMENT_PENDING', 'PAID', 'FAILED', 'CANCELLED'))
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정 시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제여부) — BOOLEAN — NOT NULL

payments (결제 시도)

  • id (결제 시도 ID) — BIGINT — Primary key — NOT NULL
  • order_id (주문 ID) — BIGINT — Foreign key → orders.id — NOT NULL
  • idempotency_key (멱등키) — VARCHAR(255) — NOT NULL — UNIQUE, 클라이언트 발급 UUID
  • provider_payment_key (PG 결제 키) — VARCHAR(200)
  • amount (승인 요청 금액) — INT — NOT NULL
  • status (결제 상태) — TEXT — NOT NULL — CHECK (status IN ('PENDING', 'SUCCESS', 'FAILED'))
  • failure_message (실패사유) — VARCHAR(500)
  • provider_response (PG 응답 원문 전체) — JSONB
  • requested_at (승인 요청 시각) — TIMESTAMPTZ — NOT NULL
  • confirmed_at (승인 완료 시각) — TIMESTAMPTZ
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정 시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제여부) — BOOLEAN — NOT NULL

user_memberships (부여된 멤버십)

  • id (부여 멤버십 ID) — BIGINT — Primary key — NOT NULL
  • user_id (회원 ID) — BIGINT — Foreign key → users.id — NOT NULL
  • membership_id (멤버십 상품 ID) — BIGINT — Foreign key → memberships.id — NOT NULL
  • order_id (주문 ID) — BIGINT — Foreign key → orders.id
  • source (부여경로) — TEXT — NOT NULL — CHECK (source IN ('purchase', 'admin_grant'))
  • starts_at (이용 시작 시각) — TIMESTAMPTZ — NOT NULL
  • expires_at (이용 만료 시각) — TIMESTAMPTZ — NOT NULL
  • revoked_at (회수 시각) — TIMESTAMPTZ
  • created_at (생성 시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정 시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제 여부) — BOOLEAN — NOT NULL

users (사용자)

  • id (회원 ID) — BIGINT — Primary key — NOT NULL
  • public_id (외부노출 id) — UUID — NOT NULL — UNIQUE
  • role (역할) — TEXT — NOT NULL — CHECK (role IN ('USER', 'ADMIN'))
  • email (이메일) — VARCHAR(255) — NOT NULL — UNIQUE
  • name (이름) — VARCHAR(100) — NOT NULL
  • created_at (생성시각) — TIMESTAMPTZ — NOT NULL
  • updated_at (수정시각) — TIMESTAMPTZ — NOT NULL
  • is_deleted (삭제 여부) — BOOLEAN — NOT NULL