ERD_v3

Tables (22)

ACTIVITY

  • activity_id — VARCHAR(36) — Primary key — NOT NULL — 활동 고유 ID
  • child_id — VARCHAR(36) — Foreign key → CHILD.child_id — NOT NULL — 수행 아동
  • goal_id — VARCHAR(36) — NOT NULL — 연결된 학습 목표
  • scenario_id — VARCHAR(36) — 배정된 확정 시나리오
  • scenario_source — VARCHAR(30) — 신규 생성분인지 재사용분인지 · ScenarioSource
  • initial_support_level — VARCHAR(30) — 초기 지원 수준(아동별 · SCN-10) · SupportLevel
  • difficulty_fallback_applied — BOOLEAN — NOT NULL — 난이도 기본값 L1/S1 적용(LVL-12)
  • status — VARCHAR(30) — NOT NULL — 진행 상태 · ActivityStatus
  • assigned_at — DATETIME — NOT NULL — 배정 시각
  • started_at — DATETIME — 시작 시각
  • completed_at — DATETIME — 완료 시각
  • reward_issued_at — DATETIME — 스탬프 지급 시각

ACTIVITY_QUIZ

  • activity_quiz_id — VARCHAR(36) — Primary key — NOT NULL — 배정 문항 고유 ID
  • activity_id — VARCHAR(36) — Foreign key → ACTIVITY.activity_id — NOT NULL — 소속 활동
  • item_id — VARCHAR(36) — NOT NULL — 문항풀 문항
  • item_version — INT — NOT NULL — 배정 시점 문항 버전
  • question_order — INT — NOT NULL — 문항 순서

AUDIT_LOG

  • log_id — VARCHAR(36) — Primary key — NOT NULL — 로그 고유 ID
  • actor_type — VARCHAR(30) — NOT NULL — 주체 유형 · ActorType
  • actor_id — VARCHAR(36) — 주체 ID(actor_type으로 해석 · FK 제약 없음)
  • action — VARCHAR(30) — NOT NULL — 수행 동작 · AuditAction
  • target_type — VARCHAR(30) — NOT NULL — 대상 종류 · TargetType
  • target_id — VARCHAR(36) — 대상 ID(target_type으로 해석 · FK 제약 없음)
  • before_json — JSON — 변경 전 값
  • after_json — JSON — 변경 후 값
  • created_at — DATETIME — NOT NULL — 발생 시각

BASE_SCENARIO

  • base_scenario_id — VARCHAR(36) — Primary key — NOT NULL — 기본 시나리오 ID
  • title — VARCHAR(200) — NOT NULL — 제목
  • situation_type — VARCHAR(30) — NOT NULL — 상황 유형 · SituationType
  • content_json — JSON — 기본 사실·등장인물
  • status — VARCHAR(30) — NOT NULL — 승인 상태 · ApprovalStatus
  • version — INT — NOT NULL — 버전

CHILD

  • child_id — VARCHAR(36) — Primary key — NOT NULL — 아동 고유 ID
  • class_id — VARCHAR(36) — Foreign key → CLASSROOM.class_id — NOT NULL — 소속 학급
  • display_name — VARCHAR(100) — NOT NULL — 표시 이름
  • access_code_hash — VARCHAR(255) — NOT NULL — 접속 코드 해시
  • access_code_expires_at — DATETIME — 코드 만료 시각
  • status — VARCHAR(30) — NOT NULL — 아동 상태 · ChildStatus
  • removal_policy — VARCHAR(30) — 학급 제외 시 기록 처리(status=REMOVED일 때만) · RemovalPolicy

CLASSROOM

  • class_id — VARCHAR(36) — Primary key — NOT NULL — 학급 고유 ID
  • instructor_id — VARCHAR(36) — Foreign key → USER_ACCOUNT.user_id — NOT NULL — 담당 강사
  • name — VARCHAR(100) — NOT NULL — 학급 이름
  • status — VARCHAR(30) — NOT NULL — 운영 상태 · ClassroomStatus

CONSENT

  • consent_id — VARCHAR(36) — Primary key — NOT NULL — 동의 고유 ID
  • child_id — VARCHAR(36) — Foreign key → CHILD.child_id — NOT NULL — 대상 아동
  • subject_type — VARCHAR(30) — NOT NULL — 동의 주체 · ConsentSubjectType
  • policy_version — VARCHAR(50) — NOT NULL — 동의한 정책 버전
  • scope_json — JSON — 동의 범위(수집 항목·목적)
  • status — VARCHAR(30) — NOT NULL — 동의 상태 · ConsentStatus
  • recorded_at — DATETIME — NOT NULL — 동의 시각
  • withdrawn_at — DATETIME — 철회 시각

CONVERSATION_TURN

  • turn_id — VARCHAR(36) — Primary key — NOT NULL — 턴 고유 ID
  • session_id — VARCHAR(36) — Foreign key → ROLEPLAY_SESSION.session_id — NOT NULL — 소속 세션
  • turn_number — INT — NOT NULL — 턴 번호
  • input_type — VARCHAR(30) — NOT NULL — 입력 방식 · InputType
  • standardized_utterance — TEXT — 표준 발화
  • input_quality_status — VARCHAR(30) — NOT NULL — 분석 가능 상태 · InputQualityStatus
  • safety_status — VARCHAR(30) — NOT NULL — 안전검사 결과 · SafetyStatus
  • agent_response_text — TEXT — 아동에게 전달된 응답 문장
  • delivered_at — DATETIME — 전달 시각
  • safe_template_id — VARCHAR(36) — 사용한 기본 문구
  • retry_count — INT — NOT NULL — 시스템 자동 재시도 횟수
  • voice_retry_count — INT — NOT NULL — 아동이 다시 말한 횟수
  • expires_at — DATETIME — 삭제 예정 시각(릴리즈는 세션 종료, MVP는 검증 기간)

LEARNING_GOAL

  • goal_id — VARCHAR(36) — Primary key — NOT NULL — 목표 고유 ID
  • child_id — VARCHAR(36) — Foreign key → CHILD.child_id — NOT NULL — 대상 아동
  • instructor_id — VARCHAR(36) — NOT NULL — 설정한 강사
  • parent_goal_id — VARCHAR(36) — 이전 목표(계보)
  • source_recommendation_id — VARCHAR(36) — 근거가 된 추천
  • title — VARCHAR(200) — NOT NULL — 목표 제목
  • situation_type — VARCHAR(30) — 추가 상황 유형 · SituationType
  • characters_json — JSON — 등장인물·관계
  • required_elements_json — JSON — 필수 포함 요소
  • forbidden_expressions_json — JSON — 피해야 할 표현
  • content_hash — VARCHAR(64) — NOT NULL — 재사용 매칭용 해시(situation_type+characters+required+forbidden)
  • created_at — DATETIME — NOT NULL — 설정 시각

LEARNING_RECORD

  • record_id — VARCHAR(36) — Primary key — NOT NULL — 기록 고유 ID
  • activity_id — VARCHAR(36) — Foreign key → ACTIVITY.activity_id — NOT NULL — 대상 활동
  • duration_seconds — INT — 실제 수행 시간(일시정지 제외)
  • retry_count — INT — NOT NULL — 시스템 자동 재시도 횟수 합계
  • safe_fallback_used_count — INT — NOT NULL — 기본 응답 사용 횟수
  • stt_failure_count — INT — NOT NULL — STT 실패 횟수
  • technical_error_count — INT — NOT NULL — 기술 오류 횟수
  • summary_text — TEXT — 강사용 학습 요약
  • instructor_comment — TEXT — 강사 의견·수정 내용
  • next_difficulty_decision — VARCHAR(30) — 다음 역할극 난이도 판정 · DifficultyDecision
  • next_scenario_level — VARCHAR(30) — 다음 역할극 시나리오 난이도 · ScenarioLevel
  • achievement_score_rate — DECIMAL(5, 2) — 유효 마이크로 목표 기준 도달 점수율(0~100)
  • up_candidate_streak — INT — NOT NULL — 연속 상향 후보 충족 횟수
  • difficulty_policy_version — VARCHAR(50) — 적용 난이도 정책 버전
  • created_at — DATETIME — NOT NULL — 생성 시각

QUIZ_ATTEMPT

  • attempt_id — VARCHAR(36) — Primary key — NOT NULL — 응답 고유 ID
  • activity_quiz_id — VARCHAR(36) — Foreign key → ACTIVITY_QUIZ.activity_quiz_id — NOT NULL — 대상 배정 문항
  • first_response — VARCHAR(255) — 첫 응답
  • first_response_correct — BOOLEAN — 첫 응답 판정(유형별 라벨 또는 이미지 선택)
  • expression_match_result — VARCHAR(30) — 표정-감정 일치 판정(SELF_EMOTION_SITUATION 전용) · ExpressionMatchResult
  • used_hint_types_json — JSON — 사용한 힌트 유형 · HintType 배열
  • final_response — VARCHAR(255) — 힌트 후 최종 응답
  • resolved_after_hint — BOOLEAN — 힌트 후 해결 여부
  • item_correct — BOOLEAN — 문항 최종 판정(QUIZ-07·QUIZ-13)
  • excluded_from_scoring — BOOLEAN — NOT NULL — 기술 오류로 정답률·하향근거에서 제외(QUIZ-12)
  • responded_at — DATETIME — 응답 시각

QUIZ_ITEM

  • item_id — VARCHAR(36) — Primary key — NOT NULL — 문항 고유 ID
  • quiz_type — VARCHAR(30) — NOT NULL — 문항 유형 · QuizType
  • emotion — VARCHAR(30) — NOT NULL — 문항이 다루는 감정 · Emotion
  • image_url — VARCHAR(500) — 제시 표정 이미지(OTHER_EMOTION_IMAGE 전용)
  • question_text — TEXT — 상황 설명·질문 내용
  • choices_json — JSON — 선택지 목록
  • correct_answer — VARCHAR(255) — NOT NULL — 대표 정답
  • acceptable_answers_json — JSON — 문맥상 유효한 대체 정답
  • hints_json — JSON — 힌트 · HintType(OBSERVABLE_FACE_CUE/OBSERVABLE_BODY_CUE/CHOICE_REDUCTION) + 내용
  • status — VARCHAR(30) — NOT NULL — 승인 상태 · ApprovalStatus
  • version — INT — NOT NULL — 문항 버전

RAW_INPUT

  • raw_input_id — VARCHAR(36) — Primary key — NOT NULL — 원본 고유 ID
  • turn_id — VARCHAR(36) — Foreign key → CONVERSATION_TURN.turn_id — NOT NULL — 대상 턴
  • audio_uri — VARCHAR(500) — 음성 원본 위치
  • stt_text — TEXT — STT 원문
  • expires_at — DATETIME — 삭제 예정 시각

RECOMMENDATION

  • recommendation_id — VARCHAR(36) — Primary key — NOT NULL — 추천 고유 ID
  • record_id — VARCHAR(36) — Foreign key → LEARNING_RECORD.record_id — NOT NULL — 근거 학습기록
  • rec_type — VARCHAR(30) — NOT NULL — 추천 유형 · RecommendationType
  • title — VARCHAR(200) — NOT NULL — 추천 목표 제목
  • reason — TEXT — 추천 이유
  • evidence_json — JSON — 근거 관찰 결과
  • evidence_sufficiency — VARCHAR(30) — 근거 충분성 · EvidenceSufficiency
  • decision_status — VARCHAR(30) — NOT NULL — 강사 결정 상태 · RecommendationDecision
  • rejection_reason — VARCHAR(30) — 미채택 이유 · RejectionReason
  • created_at — DATETIME — NOT NULL — 추천 생성 시각

ROLEPLAY_SESSION

  • session_id — VARCHAR(36) — Primary key — NOT NULL — 세션 고유 ID
  • activity_id — VARCHAR(36) — Foreign key → ACTIVITY.activity_id — NOT NULL — 소속 활동
  • current_subgoal_id — VARCHAR(36) — 현재 작은목표
  • current_support_level — VARCHAR(30) — 실시간 지원 수준 · SupportLevel
  • max_turn — INT — NOT NULL — 최대 턴 수
  • status — VARCHAR(30) — NOT NULL — 세션 진행 상태 · SessionStatus
  • closing_template_id — VARCHAR(36) — 마무리에 사용한 기본 문구
  • last_checkpoint_at — DATETIME — 마지막 체크포인트

SAFETY_INCIDENT

  • incident_id — VARCHAR(36) — Primary key — NOT NULL — 사건 고유 ID
  • child_id — VARCHAR(36) — Foreign key → CHILD.child_id — NOT NULL — 관련 아동
  • activity_id — VARCHAR(36) — 발생 활동
  • session_id — VARCHAR(36) — 발생 세션
  • turn_id — VARCHAR(36) — 발생 턴
  • source — VARCHAR(30) — NOT NULL — 발생원 · IncidentSource
  • incident_type — VARCHAR(30) — NOT NULL — 사건 유형 · IncidentType
  • action_taken — VARCHAR(30) — 대응 내용 · IncidentAction
  • handled_by — VARCHAR(36) — 대응한 강사·운영자
  • handled_at — DATETIME — 대응 시각
  • retention_until — DATETIME — 별도 보관 만료

SAFE_RESPONSE_TEMPLATE

  • template_id — VARCHAR(36) — Primary key — NOT NULL — 문구 고유 ID
  • usage_type — VARCHAR(30) — NOT NULL — 용도 · SafeTemplateUsage
  • text — TEXT — NOT NULL — 고정 문구
  • status — VARCHAR(30) — NOT NULL — 승인 상태 · ApprovalStatus
  • version — INT — NOT NULL — 버전

SCENARIO

  • scenario_id — VARCHAR(36) — Primary key — NOT NULL — 시나리오 고유 ID
  • class_id — VARCHAR(36) — Foreign key → CLASSROOM.class_id — NOT NULL — 재사용 범위 학급
  • goal_content_hash — VARCHAR(64) — NOT NULL — 재사용 키 · LEARNING_GOAL.content_hash 값
  • scenario_level — VARCHAR(30) — NOT NULL — 재사용 키 · 생성 시점 결정 난이도 · ScenarioLevel
  • base_scenario_id — VARCHAR(36) — 출발점이 된 기본 시나리오
  • title — VARCHAR(200) — NOT NULL — 제목
  • summary — TEXT — 상황 설명
  • characters_json — JSON — 등장인물·역할
  • scenario_facts_json — JSON — 고정된 시나리오 사실
  • prohibited_inferences_json — JSON — 금지 추론
  • expected_flow_json — JSON — 예상 대화 흐름
  • achievement_examples_json — JSON — 목표 달성 응답 예시
  • origin — VARCHAR(30) — NOT NULL — AI 생성본 그대로인지 강사가 고쳤는지 · ContentOrigin
  • prompt_version — VARCHAR(50) — 생성 프롬프트 버전
  • policy_version — VARCHAR(50) — 적용 안전 정책 버전
  • created_at — DATETIME — NOT NULL — 확정 시각

SESSION_GOAL_STATUS

  • status_id — VARCHAR(36) — Primary key — NOT NULL — 상태 고유 ID
  • session_id — VARCHAR(36) — Foreign key → ROLEPLAY_SESSION.session_id — NOT NULL — 소속 세션
  • subgoal_id — VARCHAR(36) — NOT NULL — 대상 작은목표
  • status — VARCHAR(30) — NOT NULL — 실시간 달성 상태 · GoalObservationStatus
  • start_support_level — VARCHAR(30) — 목표 시작 지원 수준 · SupportLevel
  • updated_turn_id — VARCHAR(36) — 갱신 근거 턴
  • reached_level — VARCHAR(30) — 목표 도달 시점의 지원 수준(S3=정답 제공) · SupportLevel
  • turns_to_reach — INT — 이 목표 도달까지 걸린 턴 수
  • guidance_count — INT — 이 목표에 사용된 유도 질문 횟수
  • excluded_from_scoring — BOOLEAN — NOT NULL — 채점·지원수준 조정 근거에서 제외(LVL-15)
  • outcome_status — VARCHAR(40) — 난이도 계산용 최종 결과 · GoalOutcomeStatus
  • evidence_text — TEXT — 관찰된 학습 증거 문장(강사 리포트용)

SUB_GOAL

  • subgoal_id — VARCHAR(36) — Primary key — NOT NULL — 작은목표 고유 ID
  • scenario_id — VARCHAR(36) — Foreign key → SCENARIO.scenario_id — NOT NULL — 소속 시나리오
  • order_no — INT — NOT NULL — 순서
  • description — TEXT — NOT NULL — 설명
  • required_evidence_json — JSON — 판단 근거 학습 증거
  • opening_prompts_json — JSON — S0~S3별 시작 질문

SUPPORT_LEVEL_CHANGE

  • change_id — VARCHAR(36) — Primary key — NOT NULL — 변경 고유 ID
  • session_id — VARCHAR(36) — Foreign key → ROLEPLAY_SESSION.session_id — NOT NULL — 소속 세션
  • turn_id — VARCHAR(36) — NOT NULL — 변경 시점 턴
  • from_level — VARCHAR(30) — NOT NULL — 변경 전 수준 · SupportLevel
  • to_level — VARCHAR(30) — NOT NULL — 변경 후 수준 · SupportLevel
  • reason_code — VARCHAR(30) — NOT NULL — 변경 이유 · SupportChangeReason
  • changed_at — DATETIME — NOT NULL — 변경 시각

USER_ACCOUNT

  • user_id — VARCHAR(36) — Primary key — NOT NULL — 계정 고유 ID
  • role — VARCHAR(30) — NOT NULL — 역할 · UserRole
  • email — VARCHAR(255) — NOT NULL — 이메일
  • name — VARCHAR(100) — NOT NULL — 이름
  • org_name — VARCHAR(200) — 소속 기관
  • status — VARCHAR(30) — NOT NULL — 계정 상태 · AccountStatus