v1.4
테이블 (18)
AI 리포트 (ai_report)
- 리포트 ID (report_id) — BIGINT — 기본 키 — NOT NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
- 생성 시각 (created_at) — DATETIME
AI 리포트 기준별 평가 (ai_report_criterion)
- 리포트 기준 평가 ID (report_criterion_id) — BIGINT — 기본 키 — NOT NULL
- AI 리포트 ID (report_id) — BIGINT — 외래 키 → AI 리포트.리포트 ID — NOT NULL
- 평가 기준 코드 (criterion_code) — VARCHAR(10) — NOT NULL — 팀 T1~T4 또는 개인 P1~P4
- 기준별 발언 판정 (speech_score) — ENUM('잘함','부분수행','개선필요','판단불가') — NOT NULL — 종합점수가 아닌 개별 기준 판정
- 관찰점 (observation) — TEXT — NOT NULL
- 개선점 (improvement) — TEXT — NOT NULL
개인 리포트 (individual_report)
- 리포트 ID (report_id) — BIGINT — 기본 키 — 외래 키 → AI 리포트.리포트 ID — NOT NULL — AI 리포트 ID를 참조하는 공유 PK
- 토론방 역할 ID (debate_room_role_id) — BIGINT — 외래 키 → 토론방 역할 설정.토론방 역할 ID — INDIVIDUAL 리포트에서 필수
- 우선 개선점 (priority_improvement) — TEXT
교사 인증 코드 (teacher_invite_code)
- 코드 ID (code_id) — BIGINT — 기본 키 — NOT NULL
- 코드 (code) — VARCHAR(20) — NOT NULL — 공문에 적히는 값, UNIQUE
- 학교/기관명 (school_name) — VARCHAR(255) — 어느 학교에 발급했는지, 관리·검색용
- 최대 사용 인원 (max_uses) — INT — null이면 무제한
- 사용된 인원 (used_count) — INT — NOT NULL — 가입 완료 시마다 +1, max_uses와 비교해 유효성 검증
- 발급 시각 (issued_at) — DATETIME — NOT NULL — 코드 유효성 검증에 필요
- 만료 시각 (expires_at) — DATETIME — 공문에 유효기한이 있는 경우
그룹 (learning_group)
- 그룹 ID (group_id) — BIGINT — 기본 키 — NOT NULL
- 관리자 유저 ID (owner_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
- 참여용 코드 (invite_code) — VARCHAR(20) — NOT NULL — UNIQUE
- 그룹명 (group_name) — VARCHAR(100) — NOT NULL
- 그룹 설명 (group_description) — VARCHAR(500)
- 그룹 인원 (member_count) — INT — NOT NULL — 참여/탈퇴 시 트랜잭션으로 갱신
금칙어 (banned)
- 금칙어 id (banned_id) — BIGINT — 기본 키 — NOT NULL
- 금칙어 (banned_word) — VARCHAR(30)
발언 기록 AI 리포트 (transcript_ai_report)
- 발언 기록 AI 리포트 ID (transcript_report_id) — BIGINT — 기본 키 — NOT NULL
- 발언 기록 ID (transcript_id) — BIGINT — 외래 키 → 토론 발언 기록.발언 기록 ID — NOT NULL
- 리포트 기준 평가 ID (report_criterion_id) — BIGINT — 외래 키 → AI 리포트 기준별 평가.리포트 기준 평가 ID — NOT NULL
- 근거 인용문 (quoted_text) — TEXT — NOT NULL
- 관찰 내용 (observation) — TEXT — NOT NULL
- 개선점 (improvement) — TEXT — NOT NULL
- 개선 발언 예시 (suggested_phrase) — TEXT
- 생성 시각 (created_at) — DATETIME — NOT NULL
선생님 호출 이력 (help_request_log)
- 호출 이력 ID (request_id) — BIGINT — 기본 키 — NOT NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL — 호출이 발생한 토론방
- 요청 유저 ID (requester_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL — 호출한 학생
- 처리 유저 ID (handled_by_user_id) — BIGINT — 외래 키 → 유저.유저 ID — 응답(처리)한 선생님, 미처리 시 NULL
- 사유 (reason) — VARCHAR(20) — NOT NULL — CONFLICT(친구와 다툼)/TECH_ISSUE(화면·소리 이상)/ETC(기타)
- 기타 사유 내용 (etc_text) — VARCHAR(255) — reason=ETC일 때만
- 호출 시각 (created_at) — DATETIME — NOT NULL — 호출이 발생한 시각
알림 내역 (notifications)
- 알림 ID (notification_id) — BIGINT — 기본 키 — NOT NULL
- 수신자 유저 ID (recipient_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL — 알림 받는 사람(선생님)
- 알림 유형 (type) — VARCHAR(30) — NOT NULL — HELP_REQUEST(선생님 호출)/GROWTH_INSIGHT(학생 성장 알림)
- 참조 ID (reference_id) — BIGINT — type=HELP_REQUEST면 help_request_log.request_id. 타입별 참조 테이블이 달라 DB FK로 강제하지 않고 애플리케이션에서 관리
- 메시지 (message) — VARCHAR(255) — NOT NULL — 알림에 표시될 텍스트
- 읽음 여부 (is_read) — BOOLEAN — NOT NULL
- 생성 시각 (created_at) — DATETIME — NOT NULL
유저 (users)
- 유저 ID (user_id) — BIGINT — 기본 키 — NOT NULL
- 카카오 ID (kakao_id) — BIGINT — NOT NULL — 카카오 OAuth2.0에서 받아옴, 중복 가입 방지용 UNIQUE
- 유저 역할 (role) — VARCHAR(255) — NOT NULL — ROLE_NO_INFO/ROLE_STUDENT/ROLE_TEACHER/ROLE_ADMIN
- 실명 (real_name) — VARCHAR(255) — 온보딩 시 입력
- 이메일 (email) — VARCHAR(255) — NOT NULL — 카카오 OAuth2.0에서 받아옴
- 프로필 이미지 ID (profile_image_id) — INT — 프리셋 캐릭터 이미지 8종 중 선택(1~8)
- 리프레시 토큰 해시 (refresh_token_hash) — VARCHAR(255) — 원문이 아닌 해시값 저장, 재로그인 시 덮어씀(1:1)
- 리프레시 토큰 만료 시각 (refresh_token_expires_at) — DATETIME
- 탈퇴 시각 (withdrawn_at) — DATETIME — NULL이면 활성 계정, 값이 있으면 해당 시각에 탈퇴한 계정
유저 AI 리포트 (user_ai_report)
- 유저 AI 리포트 ID (user_report_id) — BIGINT — 기본 키 — NOT NULL
- 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL — 분석 대상 유저
- 내용 (content) — TEXT — NOT NULL — AI가 생성한 발언 기록 분석 리포트 원문
- 생성 시각 (created_at) — DATETIME — NOT NULL — 리포트 생성 시각
유저 그룹 (group_member)
- 유저 ID (user_id) — BIGINT — 기본 키 — 외래 키 → 유저.유저 ID — NOT NULL — 유저 FK이자 복합 PK
- 그룹 ID (group_id) — BIGINT — 기본 키 — 외래 키 → 그룹.그룹 ID — NOT NULL — 그룹 FK이자 복합 PK
최종 리포트 (final_report)
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
- 리포트 전문 (total_report) — JSON
- 생성 시각 (created_at) — DATETIME
토론 발언 기록 (debate_transcript)
- 발언 기록 ID (transcript_id) — BIGINT — 기본 키 — NOT NULL
- 토론방 역할 ID (debate_room_role_id) — BIGINT — 외래 키 → 토론방 역할 설정.토론방 역할 ID — NOT NULL
- 발언 내용 (transcript_content) — LONGTEXT — NOT NULL
- 발화 시작 시각 (spoken_at) — DATETIME(3) — NOT NULL
- 발화 종료 시각 (ended_at) — DATETIME(3) — NOT NULL
- 생성 시각 (created_at) — DATETIME — NOT NULL
토론 역할 정의 (debate_role_definition)
- 토론 역할 정의 ID (debate_role_definition_id) — BIGINT — 기본 키 — NOT NULL
- 토론 유형 (debate_type) — VARCHAR(30) — NOT NULL — 토론 형식별 역할 정의
- 진영 (team_side) — VARCHAR(10) — NOT NULL — PRO/CON/OBSERVER
- 역할명 (role_name) — VARCHAR(50) — NOT NULL
- 진행 순서 (stage_order) — INT — NOT NULL — 토론 유형과 진영 안에서의 발언 단계 순서
- 발언 제한 시간(초) (speech_seconds) — INT
토론방 (debate_room)
- 토론방 ID (debate_room_id) — BIGINT — 기본 키 — NOT NULL
- 방장 유저 ID (host_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL — 토론방 방장
- 그룹 ID (group_id) — BIGINT — 외래 키 → 그룹.그룹 ID — NOT NULL
- 방 이름 (room_name) — VARCHAR(100) — NOT NULL
- 토론 주제 (debate_topic) — VARCHAR(500) — NOT NULL
- 토론 종류 (debate_type) — VARCHAR(30) — NOT NULL
- 생성 시각 (created_at) — DATETIME — NOT NULL — 목록 정렬·완료방 자동 정리 기준
- 종료 시각 (ended_at) — DATETIME — 실시간 status는 Redis, 이건 영구 이력용
- 사이사이 준비시간 사용여부 (prerp_between_enable) — BOOLEAN
- 사이사이 준비시간 (prep_between_seconds) — BIGINT
- 최종발언 준비시간 사용여부 (prep_final_enabled) — BOOLEAN
- 최종발언 준비시간 (prep_final_seconds) — BIGINT
토론방 역할 설정 (debate_room_role)
- 토론방 역할 ID (debate_room_role_id) — BIGINT — 기본 키 — NOT NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL — 같은 토론방 내 역할 번호는 중복 불가
- 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — 역할 배정 전에는 NULL 가능
- 토론 역할 정의 ID (debate_role_definition_id) — BIGINT — 외래 키 → 토론 역할 정의.토론 역할 정의 ID — NOT NULL
팀 리포트 (team_report)
- 리포트 ID (report_id) — BIGINT — 기본 키 — 외래 키 → AI 리포트.리포트 ID — NOT NULL — AI 리포트 ID를 참조하는 공유 PK
- 팀 이름 (team_name) — VARCHAR(20)
- 대상 진영 (side) — VARCHAR(10) — TEAM 리포트에서 필수
- 전략 요약 (strategy_summary) — TEXT
- 우선 개선점 (priority_improvement) — TEXT