hanuri-data

Tables (20)

generation_job_progress

  • id — BIGINT — Primary key — NOT NULL — PK. 시간 순서 = id 순서
  • job_id — BIGINT — NOT NULL — 잡 FK → generation_job.id
  • phase — VARCHAR(48) — NOT NULL — ppt-maker ProgressPhase / GammaProgressPhase 값 (start, draft, critic, done 등)
  • message — VARCHAR(512) — NOT NULL — 교사에게 보여줄 한 줄 (friendlyProgressMessage 결과)
  • detail — TEXT — 부가 줄 (파일명 목록, 장 미리보기, 검수 이슈 요약)
  • loop_no — TINYINT — 검수 루프 회차 1~5. 해당 없는 phase는 NULL
  • meta_json — JSON — slideCount, score, pass 등 UI 부가. 메시지 생성에 필수 아님
  • created_at — DATETIME — NOT NULL — 생성 시각 (append-only)
  • updated_at — DATETIME — NOT NULL — 수정 시각 (append-only라 실질 미변경)

material_global_settings

  • id — BIGINT — Primary key — NOT NULL — PK
  • setting_key — VARCHAR(64) — NOT NULL — 설정 키 (common_system_prompt / school_analysis_prompt / text_tone / text_amount / image_source / image_model / image_styl…
  • value_type — VARCHAR(16) — NOT NULL — TEXT=프롬프트 원문 / OPTION=material_setting_options.option_key / PLAIN=짧은 문자열
  • value_text — LONGTEXT — 값. NULL 또는 빈 문자열이면 코드 기본 문장 사용
  • label — VARCHAR(128) — NOT NULL — 관리자 화면 라벨
  • help_text — VARCHAR(1024) — 도움말. 프롬프트에는 안 들어감
  • sort_order — INT — NOT NULL — 화면 노출 순서
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_hq_files

  • id — BIGINT — Primary key — NOT NULL — PK
  • file_name — VARCHAR(255) — NOT NULL — 원본 파일명 (사용자가 올린 이름)
  • original_s3_key — VARCHAR(512) — NOT NULL — 원본 파일 S3 키
  • md_s3_key — VARCHAR(512) — 변환본(.md) S3 키. 변환 전엔 NULL
  • file_extension — VARCHAR(16) — 원본 확장자
  • file_size — BIGINT — 원본 파일 크기 (byte)
  • content_hash — VARCHAR(64) — 원본 SHA-256. 중복 업로드 경고 조회용
  • md_char_count — INT — 변환 완료 시점 MD 글자 수. digest 예산(40,000자) 판단용
  • convert_status — VARCHAR(16) — NOT NULL — generation_job 처리 상태 캐시: PENDING | RUNNING | READY | FAILED
  • active — TINYINT(1) — NOT NULL — 0이면 소주제 선택 모달에서만 제외. 관리자 목록은 active 무관 전체 표시
  • created_at — DATETIME — NOT NULL — 생성(업로드) 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_outline_items

  • id — BIGINT — Primary key — NOT NULL — PK
  • subtopic_id — BIGINT — Foreign key → material_subtopics.id — NOT NULL — 소속 세부주제 FK → material_subtopics.id
  • sort_order — INT — NOT NULL — 목차 순서 = 슬라이드 장 번호
  • title — VARCHAR(255) — NOT NULL — 목차 제목. SCHOOL이면 파이프라인이 원제목 — 학교명 으로 확장
  • slide_kind — VARCHAR(24) — NOT NULL — 슬라이드 성격 단일값: BODY | SCHOOL | INSTRUCTOR_INSIGHT
  • argument_stage — VARCHAR(255) — 이 장이 맡은 논증 단계. 작성자 내부용 — 화면·title·본문 노출 금지
  • slot_prompt — LONGTEXT — 이 장 전용 작성 지시. 있으면 초안에서 비우고 별도 단계에서 작성
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_project_deliverables

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → material_projects.id — NOT NULL — 프로젝트 FK → material_projects.id
  • generation_job_id — BIGINT — PPT 잡 FK → generation_job.id. PDF lazy export는 잡을 공유하거나 NULL
  • export_format — VARCHAR(8) — NOT NULL — PPTX / PDF
  • status — VARCHAR(16) — NOT NULL — PENDING(잡 큐/실행 중) | READY(file_s3_key 채워짐) | FAILED
  • file_s3_key — VARCHAR(512) — 완성 파일 S3 키. 프리픽스 hanuri-lesson-materials/
  • file_name — VARCHAR(255) — 다운로드 파일명
  • preview_keys_json — JSON — PPTX 행만. 슬라이드 PNG S3 키 배열. 1차는 NULL(다운로드만)
  • gamma_id — VARCHAR(128) — Gamma 문서 ID. PDF 재export·미리보기 요청 키
  • gamma_url — VARCHAR(1000) — Gamma 편집 URL (있으면)
  • gamma_generation_id — VARCHAR(128) — Gamma generationId
  • error_message — VARCHAR(512) — FAILED 사유
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_project_outline_pages

  • id — BIGINT — Primary key — NOT NULL — PK. 재생성 매칭의 안정 키
  • outline_id — BIGINT — Foreign key → material_project_outlines.id — NOT NULL — 개요 헤더 FK → material_project_outlines.id
  • page_no — INT — NOT NULL — 1부터. 표시·Gamma 전송 순서
  • title — VARCHAR(255) — NOT NULL — 슬라이드 제목. school 확장은 원제목 — 학교명
  • summary — VARCHAR(512) — 교사 UI 한 줄 요지. Gamma 본문이 아님
  • body_markdown — LONGTEXT — 슬라이드 문안 (줄글)
  • gamma_instruction — LONGTEXT — 채택구성 / 공간배치 / 시각제한. 본문 반복 금지
  • slide_kind — VARCHAR(24) — NOT NULL — BODY | SCHOOL | INSTRUCTOR_INSIGHT | SOURCES(생성 전용)
  • source — VARCHAR(16) — NOT NULL — STRUCTURE(고정 목차) / SCHOOL(학교 장·부록)
  • role — VARCHAR(16) — NOT NULL — COVER | CLOSING | BODY | SCHOOL. 표지·마무리 빈칸 규칙
  • outline_item_id — BIGINT — Foreign key → material_outline_items.id — 출처 목차 FK → material_outline_items.id. 출처 장·자동 부록은 NULL
  • school_id — BIGINT — 이 장이 다루는 학교 FK → school.id. 비-학교 장은 NULL
  • eval_file_id — BIGINT — 승자 평가계획 파일 FK → school_evaluation_plan_files.id. 출처·디버깅용
  • needs_teacher_confirm — TINYINT(1) — NOT NULL — 평가 데이터 없음 → 교사 확인 필요 카드
  • review_status — VARCHAR(16) — PASS | NEEDS_FIX | SKIPPED. simple·이슈 없는 학교 장은 SKIPPED 또는 NULL
  • edited_by_teacher — TINYINT(1) — NOT NULL — 1이면 이후 AI 초안/검수/Polish/재생성이 이 장의 본문·제목·요지·화면지시를 덮지 않음
  • edited_at — DATETIME — 교사가 저장한 시각
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_project_outlines

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → material_projects.id — NOT NULL — 프로젝트 FK → material_projects.id. UNIQUE (프로젝트당 현재 개요 1벌)
  • generation_job_id — BIGINT — 이 개요를 만든(또는 재생성 중인) 개요 잡 FK → generation_job.id
  • build_mode — VARCHAR(16) — NOT NULL — simple / advanced
  • status — VARCHAR(16) — NOT NULL — EMPTY(행만 있음) | GENERATING(잡 RUNNING) | READY(편집·PPT 가능) | FAILED
  • deck_gamma_instruction — LONGTEXT — 덱 전체 Gamma 지시. 장별 지시와 별개
  • page_count — INT — NOT NULL — 현재 장 수 캐시. 페이지 저장 시 갱신
  • harness_loops — TINYINT — advanced 실제 검수 루프 횟수. simple은 NULL
  • harness_passed — TINYINT(1) — 검수 최종 통과 여부. 5회 소진 후 경고 완료면 0
  • notice — VARCHAR(512) — 교사 안내 문구 (일부 장 확인 미완료 등)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_project_school_grades

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_school_id — BIGINT — NOT NULL — 부모 FK → material_project_schools.id
  • grade_code — VARCHAR(16) — NOT NULL — E1~E6 / M1~M3 / H1~H3 또는 전학년 E_ALL / M_ALL / H_ALL
  • school_level — VARCHAR(32) — NOT NULL — ELEMENTARY / MIDDLE / HIGH
  • grade_label — VARCHAR(16) — NOT NULL — 화면 표시용 라벨 (예: 초4, 초등 전체)
  • grade_number — INT — NOT NULL — 정렬용 숫자 (전학년 코드는 0)
  • created_at — DATETIME — NOT NULL — 연결 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_project_schools

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → material_projects.id — NOT NULL — 프로젝트 FK → material_projects.id
  • school_id — BIGINT — NOT NULL — 학교 FK → school.id (지역 도메인)
  • sort_order — INT — NOT NULL — 선택 순서. 개요·자료집에 학교가 나열되는 순서
  • created_at — DATETIME — NOT NULL — 연결 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_projects

  • id — BIGINT — Primary key — NOT NULL — PK
  • teacher_id — BIGINT — NOT NULL — 작성 교사 FK → users.id
  • topic_id — BIGINT — Foreign key → material_topics.id — 대주제 FK → material_topics.id (①). 소주제 미선택 상태를 표현하려 별도 보관
  • subtopic_id — BIGINT — Foreign key → material_subtopics.id — 세부주제 FK → material_subtopics.id (①). 확정되면 topic_id는 유도 가능(조회 편의상 중복 저장)
  • gamma_theme_id — VARCHAR(64) — 화면분위기(테마). gamma_theme.gamma_theme_id 문자열 비즈니스 키를 값만 복사. FK 제약 없음
  • sido_id — BIGINT — 시·도 FK → sido.id. 2단계 필수지만 1단계 완료 시점엔 NULL 가능
  • sigungu_id — BIGINT — 시·군·구 FK → sigungu.id. 선택
  • region_memo — VARCHAR(100) — 지역메모 (100자 제한)
  • event_date — DATE — 설명회 일시 (날짜만)
  • event_place — VARCHAR(255) — 설명회 장소
  • instructor_name — VARCHAR(100) — 강사명
  • output_format — VARCHAR(16) — NOT NULL — PPT / WORD. WORD는 선택은 가능하나 4단계 실제 생성은 앱이 차단
  • current_step — TINYINT — NOT NULL — 도달한 최대 단계 1~4 (ppt-maker maxReached). 이어하기는 이 값으로 복귀
  • status — VARCHAR(16) — NOT NULL — DRAFT=작성 중 / COMPLETED=위저드 완료. 생성 중·실패는 산출물 엔티티(⑤)가 가짐
  • active — TINYINT(1) — NOT NULL — 교사가 삭제하면 0 (물리 삭제 없음). 목록·배너는 active=1만
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_review_items

  • id — BIGINT — Primary key — NOT NULL — PK
  • title — VARCHAR(512) — NOT NULL — 검수 항목 제목 (보통 질문문)
  • method_text — LONGTEXT — 이 항목을 어떻게 검수할지. 없으면 제목만 투입
  • sort_order — INT — NOT NULL — 검수 목차 순서
  • active — TINYINT(1) — NOT NULL — 0이면 「불러오기」 대상에서 제외
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_setting_options

  • id — BIGINT — Primary key — NOT NULL — PK
  • option_group — VARCHAR(32) — NOT NULL — 선택지 그룹: TEXT_TONE | TEXT_AMOUNT | IMAGE_SOURCE | IMAGE_MODEL
  • option_key — VARCHAR(64) — NOT NULL — 저장·조립에 쓰는 키 (예: parent_trust, medium)
  • label — VARCHAR(128) — NOT NULL — 관리자 화면 표시명 (예: 신뢰·담백 (권장))
  • hint_text — VARCHAR(512) — 화면 보조 설명. 생성에는 안 쓰임
  • value_text — LONGTEXT — 이 선택지가 생성기(Gamma API)에 실제로 넘기는 값 (예: 영문 톤 문구). 비면 option_key 그대로 사용
  • sort_order — INT — NOT NULL — 목록 순서
  • active — TINYINT(1) — NOT NULL — 0이면 목록에서 숨김
  • is_default — TINYINT(1) — NOT NULL — 그룹 안의 권장/초기 선택값 (저장값이 목록에 없을 때 폴백 대상)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_subtopic_inputs

  • id — BIGINT — Primary key — NOT NULL — PK
  • subtopic_id — BIGINT — NOT NULL — 소속 세부주제 FK → material_subtopics.id
  • input_key — VARCHAR(64) — NOT NULL — 조립 로직 식별 키. 기본 인풋은 예약어(category_label 등), 커스텀은 slug
  • builtin — TINYINT(1) — NOT NULL — 1이면 코드가 조립 위치·라벨을 아는 예약 인풋
  • label — VARCHAR(128) — NOT NULL — 화면 라벨 겸 프롬프트 대괄호 머리말 (예: 대상)
  • help_text — VARCHAR(1024) — 물음표 도움말. 프롬프트 본문에는 안 들어감
  • value_text — LONGTEXT — 관리자가 입력한 값
  • value_format — VARCHAR(16) — NOT NULL — TEXT=한 줄 / BULLET=줄바꿈마다 - 자동 보정
  • omitted — TINYINT(1) — NOT NULL — 1이면 화면·프롬프트 양쪽에서 제외. 행은 남기므로 복원 가능
  • sort_order — INT — NOT NULL — 커스텀 인풋의 하단 배치 순서
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_subtopic_review_items

  • id — BIGINT — Primary key — NOT NULL — PK
  • subtopic_id — BIGINT — NOT NULL — 소속 세부주제 FK → material_subtopics.id
  • title — VARCHAR(512) — NOT NULL — 검수 항목 제목
  • method_text — LONGTEXT — 검수 방법. 없으면 제목만 투입
  • sort_order — INT — NOT NULL — 검수 목차 순서
  • active — TINYINT(1) — NOT NULL — 0이면 지시문 조립에서 제외
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_subtopic_sources

  • id — BIGINT — Primary key — NOT NULL — PK
  • subtopic_id — BIGINT — Foreign key → material_subtopics.id — NOT NULL — 세부주제 FK → material_subtopics.id (①)
  • hq_file_id — BIGINT — Foreign key → material_hq_files.id — NOT NULL — 본사 자료 FK → material_hq_files.id
  • sort_order — INT — NOT NULL — 이 소주제 안에서 자료가 나열되는 순서. 프롬프트 조립 시 이 순서로 이어붙임
  • created_at — DATETIME — NOT NULL — 연결 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_subtopics

  • id — BIGINT — Primary key — NOT NULL — PK
  • topic_id — BIGINT — Foreign key → material_topics.id — NOT NULL — 소속 대주제 FK → material_topics.id
  • title — VARCHAR(128) — NOT NULL — 관리자 목록 제목. 세부주제명 인풋이 비면 프롬프트에도 이 값이 들어감
  • active — TINYINT(1) — NOT NULL — 초안/발행 스위치. 0=초안(필수값 검증 스킵), 1=발행(교사 선택·생성 API 허용). 신규는 0
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

material_topics

  • id — BIGINT — Primary key — NOT NULL — PK
  • name — VARCHAR(128) — NOT NULL — 대주제명. 세부주제가 주제분야 인풋을 비우면 이 값이 프롬프트에 들어감
  • description — VARCHAR(512) — 관리자용 설명. 프롬프트에는 안 들어감
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

school_evaluation_plan_file_coverage

  • id — BIGINT — Primary key — NOT NULL — PK
  • file_id — BIGINT — NOT NULL — 평가계획 원본 파일 FK → school_evaluation_plan_files.id
  • school_id — BIGINT — NOT NULL — 학교 FK → school.id. 비정규화(파일에서 insert 시점 복사) — 읽기 핫패스
  • grade_code — VARCHAR(4) — NOT NULL — E1~E6 / M1~M3 / H1~H3. E_ALL 등 통합 코드 금지(학교급별로 펼쳐 저장)
  • grade_number — TINYINT — NOT NULL — 1~6. 정렬·조인용
  • semester — TINYINT — NOT NULL — 0=미상 / 1=1학기 / 2=2학기. 학기 하드 필터용
  • whole_school_file — TINYINT(1) — NOT NULL — 전학년 통합본 여부. 비정규화. 승자 파일 선택 시 학년별 파일 > 전학년 통합본 우선순위 정렬
  • submission_ym — VARCHAR(6) — NOT NULL — YYYYMM 공시년월. 비정규화. 최신 회차 우선 정렬용
  • extract_source — VARCHAR(20) — NOT NULL — filename_hint(A단계, LLM 0) / content_extract(B·C단계)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

school_evaluation_plan_file_extract

  • id — BIGINT — Primary key — NOT NULL — PK
  • file_id — BIGINT — NOT NULL — 파일 FK → school_evaluation_plan_files.id. UNIQUE (1파일:1추출)
  • status — VARCHAR(16) — NOT NULL — PENDING | RUNNING | READY | FAILED. 개요 만들기 때 lazy로 채움
  • source_md_hash — VARCHAR(64) — 추출 시점 school_evaluation_plan_files.md_source_hash 스냅샷 (안전장치)
  • fact_count — INT — NOT NULL — 자식 fact 행 수 캐시 (목록·디버깅용)
  • extracted_at — DATETIME — READY 전이 시각
  • failure_reason — VARCHAR(255) — FAILED일 때 사유 (Gemini 오류 메시지 요약 등)
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

school_evaluation_plan_file_fact

  • id — BIGINT — Primary key — NOT NULL — PK
  • file_id — BIGINT — NOT NULL — 파일 FK → school_evaluation_plan_files.id
  • grade_code — VARCHAR(4) — NOT NULL — 이 사실이 속한 학년. 전학년 통합 MD라도 학년별로 쪼개 저장
  • semester — TINYINT — NOT NULL — 0=미상 / 1 / 2
  • subject — VARCHAR(20) — NOT NULL — 교과. 현재는 국어만 추출(향후 확장 여지로 컬럼화)
  • area — VARCHAR(40) — 국어 영역 (독서/문학/작문/화법과 언어 등)
  • unit_or_theme — VARCHAR(100) — 단원 / 주제
  • evaluation_item — VARCHAR(100) — 평가 항목명
  • evaluation_method — VARCHAR(100) — 평가 방법 (지필/수행 등)
  • timing — VARCHAR(50) — 시기 (예: 1학기 중간)
  • achievement_level — VARCHAR(20) — 성취수준 구분 (예: 상/중/하)
  • achievement_text — TEXT — 성취수준 원문 인용. 우열 비교 금지 원칙상 점수화하지 않고 원문 그대로 저장
  • sort_order — INT — NOT NULL — 같은 파일 안에서 표시 순서
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각