0.6v
테이블 (8)
AI 리포트 (ai_report)
- 리포트 ID (report_id) — BIGINT — 기본 키 — NOT NULL
- 대상 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — 개인 리포트일 때만 사용, 팀 피드백이면 NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
- 리포트 유형 (report_type) — VARCHAR(10) — NOT NULL — GROWTH / FEEDBACK
- 피드백 유형 (feedback_type) — VARCHAR(10) — report_type=FEEDBACK일 때 PERSONAL / TEAM
- 진영 (side) — VARCHAR(10) — feedback_type=TEAM일 때 PRO / CON
- 내용 (content) — TEXT — NOT NULL — AI가 생성한 리포트 원문
- 생성 시각 (created_at) — DATETIME — NOT NULL — 성장추이 그래프 x축, 목록 정렬
교사 인증 코드 (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
- 발급 시각 (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 — 참여/탈퇴 시 갱신
유저 (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) — 온보딩 시 입력
- 닉네임 (nickname) — VARCHAR(255) — 카카오 가입 시 자동 생성, 마이페이지에서 수정 가능
- 이메일 (email) — VARCHAR(255) — NOT NULL — 카카오 OAuth2.0에서 받아옴
- 핸드폰 번호 (phone_number) — VARCHAR(255) — 010-1234-1234 형식
- 프로필 이미지 ID (profile_image_id) — INT — 프리셋 캐릭터 이미지 1~8
- 리프레시 토큰 해시 (refresh_token_hash) — VARCHAR(255) — 원문이 아닌 해시값 저장, 재로그인 시 덮어씀
- 리프레시 토큰 만료 시각 (refresh_token_expires_at) — DATETIME
유저 그룹 (group_member)
- 유저 ID (user_id) — BIGINT — 기본 키 — 외래 키 → 유저.유저 ID — NOT NULL — 유저 FK이자 복합 PK
- 그룹 ID (group_id) — BIGINT — 기본 키 — 외래 키 → 그룹.그룹 ID — NOT NULL — 그룹 FK이자 복합 PK
토론 발언 기록 (debate_transcript)
- 발언 기록 ID (transcript_id) — BIGINT — 기본 키 — NOT NULL
- 발언 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
- 발언 내용 (transcript_content) — TEXT — NOT NULL — STT로 기록된 발언 원문
- 발언 시각 (spoken_at) — DATETIME(3) — NOT NULL
- 발언 시간(ms) (speaking_duration_ms) — INT — NOT NULL
토론방 (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, 영구 이력용
토론방 역할 설정 (debate_room_role)
- 토론방 역할 ID (debate_room_role_id) — BIGINT — 기본 키 — NOT NULL
- 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL — UNIQUE(debate_room_id, user_id)
- 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — 역할 배정 전 NULL 가능, 한 유저는 한 토론방에 하나의 역할
- 역할 번호 (role_number) — INT — NOT NULL — 발언 순서
- 진영 (position) — VARCHAR(10) — NOT NULL — PRO / CON / OBSERVER
- 역할명 (role_name) — VARCHAR(50) — 예: 1번 토론자
- 발언 가능 시간(초) (speaking_seconds) — INT — NOT NULL — 관전자는 0초