ICT_AI_ERD

Tables (10)

attempt_item (사용자의 문항별_풀이_로그 (문제별 상세 결과))

  • attempt_item_id (Key) — Primary key — NOT NULL
  • quiz_attempt_id (ID) — Foreign key → quiz_attempt.quiz_attempt_id — NOT NULL
  • question_bank_id (ID2) — Foreign key → question_banks.question_bank_id — NOT NULL
  • user_answer (사용자의 응답)
  • is_correct (채점 결과)
  • time_ms (해당 문항 풀이 시간)
  • created_at (Field)

chat_sessions (Q&A 세션(최근대화기록))

  • chat_session_id (Key) — Primary key — NOT NULL
  • user_id (유저ID) — INT — Foreign key → users.user_id — NOT NULL
  • document_id (자료ID) — Foreign key → documents.document_id — NOT NULL
  • title (Field)
  • created_at (Field2)

chunks (청크/근거)

  • chunk_id (청크ID) — Primary key — NOT NULL
  • document_id (자료ID) — Foreign key → documents.document_id — NOT NULL
  • ord (문서 내 청크 순번(0부터)))
  • content (이 청크의 텍스트 (근거 표시용)))
  • token_count (길이/비용 관리)
  • embedding (임베딩 (모델 차원 맞추기))
  • char_start (워문 내 시작/끝 오프셋 (텍스트 업로드 시))
  • char_end (Field)
  • page_start (PDF면 페이지 범위 (텍스트면 NULL))
  • page_end (Field2)
  • content_hash (동일 청크 재계산 방지 (옵션))
  • created_at (Field3)

documents (자료(문서))

  • document_id (자료ID) — Primary key — NOT NULL
  • user_id (유저ID) — INT — Foreign key → users.user_id — NOT NULL
  • title (제목)
  • source_type (Field) — ENUM('PDF', 'TEXT')
  • file_url (원본 파일 저장 경로)
  • text_hash (Field2)
  • status (단계 표시 (UI 로딩바/재시도)) — ENUM('uploaded', 'parsed', indexed')
  • pages (PDF 총 페이지 수)
  • bytes (몇 바이트인지)
  • created_at (업로드일)

qa_turns (1개의 Q&A)

  • qa_turn_id (qa_turn ID) — Primary key — NOT NULL
  • chat_session_id (Key) — Foreign key → chat_sessions.chat_session_id — NOT NULL
  • question (Field)
  • answer (Field2)
  • has_answer (임계치 미만이면 false -> "자료에 없음")
  • citations (출처) — JSONB
  • model (사용 모델/버전)
  • created_at (Field3)

question_banks (생성된 문제 1개)

  • question_bank_id (ID) — Primary key — NOT NULL
  • quiz_id (퀴즈_id) — Foreign key → quizzes.quiz_id — NOT NULL
  • qtype (Field) — ENUM('객관식', '단답형', '주관식')
  • difficulty (난이도) — ENUM('쉬움', '보통', '어려움')
  • stem (문제 지문)
  • optons (선택지)
  • correct_text (정답 (진짜 문제의 정답))
  • explanation (해설)
  • citations (출처) — JSONB
  • created_at (Field2)

quiz_attempt (한 사용자가 세트 한번 푼 기록 (결과의 상단 데이터원천))

  • quiz_attempt_id (ID) — Primary key — NOT NULL
  • started_at
  • finished_at (제출 시점)
  • correct_count (정답 개수)
  • accuracy (정답률)
  • grade (성적) — ENUM('A', ~ 'F')
  • created_at (Field2)

quizzes ("문제 생성하기" 때 생기는 문제세트)

  • quiz_id (퀴즈_id) — Primary key — NOT NULL
  • user_id (유저ID) — INT — Foreign key → users.user_id — NOT NULL
  • document_id (자료ID) — Foreign key → documents.document_id — NOT NULL
  • title (제목)
  • requested_count (사용자가 선택한 개수)
  • difficulty (난이도) — ENUM'쉬움', '보통, '어려움')
  • type (유형) — JSONB
  • status (상태) — ENUM('creating', 'ready', 'error')
  • created_at (생성일)

summarys (요약)

  • summary_id (요약 ID) — Primary key — NOT NULL
  • document_id (자료ID) — Foreign key → documents.document_id — NOT NULL
  • type (Field) — ENUM('overall', 'traps', 'concept_areas', 'three_lines'
  • content_md (마크다운 그대로 렌더링)
  • model (사용 모델/버전)
  • created_at (Field2)

users (사용자)

  • user_id (유저ID) — INT — Primary key — NOT NULL
  • email (이메일)
  • name (Field) — TEXT
  • created_at — TIMESTAMP