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