Readle

Tables (13)

content

  • id — BIGINT — Primary key — NOT NULL — 콘텐츠 ID
  • member_id — BIGINT — Foreign key → member.id — NOT NULL — 작성자
  • title — VARCHAR(255) — NOT NULL — 콘텐츠 제목(URL 메타데이터 또는 사용자 입력)
  • input_type — VARCHAR(10) — NOT NULL — 입력 방식
  • original_url — VARCHAR(500) — 원본 URL
  • raw_text — LONGTEXT — 사용자 입력 원문
  • extracted_text — LONGTEXT — 크롤링 추출 본문
  • crawl_status — VARCHAR(20) — NOT NULL — 크롤링 상태
  • created_at — DATETIME — NOT NULL — 콘텐츠 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

content_tag

  • id — BIGINT — Primary key — NOT NULL — 콘텐츠 태그 ID
  • content_id — BIGINT — Foreign key → content.id — NOT NULL
  • tag_id — BIGINT — Foreign key → tag.id — NOT NULL
  • created_at — DATETIME — NOT NULL

content_validation

  • id — BIGINT — Primary key — NOT NULL — 검증 이력 ID
  • content_id — BIGINT — Foreign key → content.id — NOT NULL — 검증 대상 콘텐츠
  • validation_method — VARCHAR(20) — NOT NULL — 적합성 판단 방식 (AI, WHITELIST, STATIC_GUARDRAIL)
  • status — VARCHAR(10) — NOT NULL — 검증 상태
  • validation_score — DECIMAL(5, 2) — AI 적합성 점수(0~100). AI 판단이 아니면 NULL
  • reject_reason_code — VARCHAR(30) — 부적합 사유 코드
  • evidence_snippets — TEXT — 판정 근거(JSON Array)
  • error_code — VARCHAR(30) — 오류 코드
  • created_at — DATETIME — NOT NULL — 검증 요청 시각
  • validated_at — DATETIME — 검증 완료 시각

member

  • id — BIGINT — Primary key — NOT NULL — 회원 고유 식별자 (내부용)
  • uuid — CHAR(36) — NOT NULL — 외부 노출용 식별자 (JWT sub 등)
  • oauth_provider — VARCHAR(20) — NOT NULL — OAuth 제공자 (GOOGLE, KAKAO)
  • oauth_id — VARCHAR(255) — NOT NULL — OAuth Provider 사용자 ID
  • email — VARCHAR(255) — 이메일
  • nickname — VARCHAR(30) — NOT NULL — 닉네임
  • profile_image_url — VARCHAR(300) — 프로필 이미지 URL
  • created_at — DATETIME — NOT NULL — 계정 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각
  • last_login_at — DATETIME — 최근 로그인

member_refresh_token

  • id — BIGINT — Primary key — NOT NULL — Refresh Token 식별자
  • member_id — BIGINT — Foreign key → member.id — NOT NULL — 소유 회원
  • token_hash — VARCHAR(255) — NOT NULL — Refresh Token 해시값
  • expires_at — DATETIME — NOT NULL — 만료 시각
  • created_at — DATETIME — NOT NULL — 발급 시각
  • revoked_at — DATETIME — 무효화 시각(로그아웃/재발급), NULL이면 유효

oauth_authorization_state

  • id — BIGINT — Primary key — NOT NULL — OAuth 인가 state 식별자
  • state_hash — VARCHAR(64) — NOT NULL — CSRF state 해시
  • oauth_provider — VARCHAR(20) — NOT NULL — OAuth 제공자 (GOOGLE, KAKAO)
  • return_to — VARCHAR(2048) — NOT NULL — 인가 완료 후 리다이렉트 경로
  • code_verifier_ciphertext — VARCHAR(1024) — NOT NULL — 암호화된 PKCE code_verifier
  • expires_at — DATETIME — NOT NULL — 만료 시각
  • used_at — DATETIME — 소진 시각
  • created_at — DATETIME — NOT NULL — 생성 시각

quiz_answer

  • id — BIGINT — Primary key — NOT NULL — 문제별 사용자 답안 및 채점 결과 ID
  • attempt_id — BIGINT — Foreign key → quiz_attempt.id — NOT NULL
  • question_id — BIGINT — Foreign key → quiz_question.id — NOT NULL
  • submitted_answer_text — TEXT — 주관식 / 코드빈칸 답안
  • submitted_choice_id — BIGINT — Foreign key → quiz_choice.id — 객관식 답안
  • is_correct — BOOLEAN — NOT NULL — 채점 결과
  • ai_feedback — TEXT — 오답 AI 피드백
  • evaluated_at — DATETIME — NOT NULL — 채점 완료 시각

quiz_attempt

  • id — BIGINT — Primary key — NOT NULL — 퀴즈 풀이 진행 상태 ID
  • quiz_set_id — BIGINT — Foreign key → quiz_set.id — NOT NULL
  • member_id — BIGINT — Foreign key → member.id — NOT NULL
  • status — VARCHAR(20) — NOT NULL — IN_PROGRESS | GRADING | SUBMITTED
  • started_at — DATETIME — NOT NULL
  • submitted_at — DATETIME

quiz_choice

  • id — BIGINT — Primary key — NOT NULL — 객관식 문제 선택지 ID
  • question_id — BIGINT — Foreign key → quiz_question.id — NOT NULL
  • order_no — SMALLINT — NOT NULL
  • choice_text — TEXT — NOT NULL
  • is_correct — BOOLEAN — NOT NULL — 정답 여부

quiz_question

  • id — BIGINT — Primary key — NOT NULL — 퀴즈 개별 문제 ID
  • quiz_set_id — BIGINT — Foreign key → quiz_set.id — NOT NULL — 소속 퀴즈 세트
  • question_type — VARCHAR(20) — NOT NULL — MULTIPLE_CHOICE | SHORT_ANSWER | CODE_BLANK
  • order_no — SMALLINT — NOT NULL — 문제 순서
  • question_text — TEXT — NOT NULL
  • code_snippet — TEXT — CODE_BLANK 전용
  • correct_answer — TEXT — SHORT_ANSWER / CODE_BLANK 전용
  • explanation — TEXT — 내부 AI 피드백 생성용
  • source_excerpt — TEXT — 문제 생성 근거

quiz_result

  • id — BIGINT — Primary key — NOT NULL — 퀴즈 결과 리포트 ID
  • attempt_id — BIGINT — Foreign key → quiz_attempt.id — NOT NULL
  • accuracy_rate — DECIMAL(5, 2) — NOT NULL — 정답률(%). correct_count / total_count * 100
  • correct_count — SMALLINT — NOT NULL
  • total_count — SMALLINT — NOT NULL
  • solve_duration_seconds — INT — NOT NULL — 사용자 실제 풀이 시간(초)
  • completed_at — DATETIME — NOT NULL

quiz_set

  • id — BIGINT — Primary key — NOT NULL — 퀴즈 세트 ID
  • content_id — BIGINT — Foreign key → content.id — NOT NULL — 퀴즈 생성 대상 콘텐츠
  • status — VARCHAR(20) — NOT NULL — 퀴즈 생성 상태
  • question_count — SMALLINT — 생성된 문제 개수(1~5)
  • created_at — DATETIME — NOT NULL — 퀴즈 생성 요청 시각
  • completed_at — DATETIME — 퀴즈 생성 완료 시각
  • is_bypassed — BOOLEAN — NOT NULL — 검증 우회 생성 여부
  • source_validation_id — BIGINT — Foreign key → content_validation.id — NOT NULL — 이 퀴즈 생성의 근거가 된 검증 이력

tag

  • id — BIGINT — Primary key — NOT NULL — 태그 마스터 ID
  • name — VARCHAR(50) — NOT NULL — 태그명
  • created_at — DATETIME — NOT NULL