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 — 수정 시각