진로온

테이블 (28)

ai_feedbacks

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 유저.id — NOT NULL
  • result_ai_explanation_id — BIGINT — 외래 키 → result_ai_explanations.id — 전공 추천 설명 피드백
  • consultation_log_id — BIGINT — 외래 키 → consultation_logs.id — 상담 답변 피드백
  • rating — ENUM('up', 'down') — NOT NULL
  • feedback_text — TEXT
  • created_at — DATETIME — NOT NULL

ai_inference_logs

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 유저.id
  • diagnosis_session_id — BIGINT — 외래 키 → diagnosis_sessions.id
  • prompt_template_id — BIGINT — 외래 키 → ai_prompt_templates.id
  • model_id — BIGINT — 외래 키 → ai_models.id
  • feature_type — ENUM('essay_keyword','major_reason','chat_consulting','weekly_plan','rag') — NOT NULL
  • request_json — JSON
  • response_json — JSON
  • prompt_tokens — INT
  • completion_tokens — INT
  • total_tokens — INT
  • latency_ms — INT
  • estimated_cost_usd — DECIMAL(10,6)
  • status — ENUM('succeeded','failed','blocked') — NOT NULL
  • error_code — VARCHAR(100)
  • created_at — DATETIME — NOT NULL
  • INDEX — idx_ai_log_user
  • INDEX — idx_ai_log_session
  • INDEX — idx_ai_log_feature

ai_models

  • id — BIGINT — 기본 키 — NOT NULL
  • 제공사 (provider) — ENUM('openai', 'anthropic', 'google', 'local') — NOT NULL
  • 모델명 (model_name) — VARCHAR(100) — NOT NULL — 예: claude-sonnet-4-20250514
  • 모델버전 (model_version) — VARCHAR(50)
  • 컨텍스트윈도우 (context_window) — INT — 최대 컨텍스트 토큰 수
  • 활성여부 (is_active) — BOOLEAN — NOT NULL
  • 생성일시 (created_at) — DATETIME — NOT NULL

ai_prompt_templates

  • id — BIGINT — 기본 키 — NOT NULL
  • 기능유형 (feature_type) — ENUM('essay_keyword', 'major_reason', 'chat_consulting', 'weekly_plan') — NOT NULL
  • 템플릿명 (template_name) — VARCHAR(100) — NOT NULL
  • 템플릿버전 (template_version) — VARCHAR(20) — NOT NULL — 예: v1.0
  • system_prompt — TEXT — NOT NULL
  • user_prompt_template — TEXT — NOT NULL — {{변수}} 형태 치환
  • 활성여부 (is_active) — BOOLEAN — NOT NULL
  • created_at — DATETIME — NOT NULL

competency_eval_results

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_session_id — BIGINT — 외래 키 → diagnosis_sessions.id — NOT NULL
  • math_logic — FLOAT — NOT NULL — 수리논리 0~1
  • problem_solving — FLOAT — NOT NULL — 문제해결 0~1
  • info_tech — FLOAT — NOT NULL — 정보기술 0~1
  • implementation — FLOAT — NOT NULL — 구현력 0~1
  • system_understanding — FLOAT — NOT NULL — 시스템이해 0~1
  • data_analysis — FLOAT — NOT NULL — 데이터분석 0~1
  • communication — FLOAT — NOT NULL — 의사소통 0~1
  • collaboration — FLOAT — NOT NULL — 협업윤리 0~1
  • self_management — FLOAT — NOT NULL — 자기관리 0~1
  • created_at — DATETIME — NOT NULL

consultation_logs

  • id — BIGINT — 기본 키 — NOT NULL
  • consultation_session_id — BIGINT — 외래 키 → consultation_sessions.id — NOT NULL
  • role — ENUM('user', 'assistant') — NOT NULL
  • content — TEXT — NOT NULL
  • inference_log_id — BIGINT — 외래 키 → ai_inference_logs.id — AI 응답인 경우 호출 로그 연결
  • created_at — DATETIME — NOT NULL

consultation_sessions

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 유저.id — NOT NULL
  • diagnosis_result_id — BIGINT — 외래 키 → diagnosis_results.id
  • title — VARCHAR(200) — 상담 제목 (자동 또는 사용자 입력)
  • started_at — DATETIME — NOT NULL
  • ended_at — DATETIME

diagnosis_essay_analyses

  • id — BIGINT — 기본 키 — NOT NULL
  • 서술형답변기본키 (diagnosis_essay_answer_id) — BIGINT — 외래 키 → diagnosis_essay_answers.id — NOT NULL
  • 프롬프트템플릿기본키 (prompt_template_id) — BIGINT — 외래 키 → ai_prompt_templates.id — NOT NULL
  • AI모델기본키 (model_id) — BIGINT — 외래 키 → ai_models.id — NOT NULL
  • 분석상태 (status) — ENUM('queued','running','succeeded','failed') — NOT NULL
  • 추출키워드JSON (extracted_keywords_json) — JSON
  • 분석요약문 (summary_text) — TEXT
  • 신뢰도점수 (confidence_score) — FLOAT
  • 요청일시 (requested_at) — DATETIME — NOT NULL
  • 완료일시 (completed_at) — DATETIME

diagnosis_essay_answers

  • id — BIGINT — 기본 키 — NOT NULL
  • 진단세션기본키 (diagnosis_session_id) — BIGINT — 외래 키 → diagnosis_sessions.id — NOT NULL
  • 문항번호 (question_no) — INT — NOT NULL — 문항 번호
  • 서술형답변원문 (answer_text) — TEXT — NOT NULL
  • LLM키워드결과 (llm_keywords) — JSON — LLM이 추출한 키워드 결과
  • created_at — DATETIME — NOT NULL

diagnosis_exam_answers

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_session_id — BIGINT — 외래 키 → diagnosis_sessions.id — NOT NULL
  • exam_question_id — BIGINT — 외래 키 → exam_questions.id — NOT NULL
  • selected_answer — CHAR(1) — a~d, NULL=건너뜀
  • is_correct — BOOLEAN — NOT NULL
  • response_sec — INT — 실제 풀이 시간(초)
  • created_at — DATETIME — NOT NULL

diagnosis_results

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_session_id — BIGINT — 외래 키 → diagnosis_sessions.id — NOT NULL
  • user_id — BIGINT — 외래 키 → 유저.id — NOT NULL
  • competency_vector — JSON — NOT NULL — 역량 9축 벡터 원본
  • tendency_vector — JSON — NOT NULL — 성향 9축 벡터 원본
  • top_majors_json — JSON — TOP5 전공 요약 (빠른 조회용)
  • share_token — VARCHAR(128) — 공유 URL용 고유 토큰
  • created_at — DATETIME — NOT NULL

diagnosis_sessions

  • id — BIGINT — 기본 키 — NOT NULL
  • 유저 Id (user_id) — BIGINT — 외래 키 → 유저.id — NOT NULL
  • 진단상태 (status) — ENUM('in_progress', 'completed', 'abandoned') — NOT NULL
  • 현재단계 (current_step) — INT — NOT NULL — 1~5단계
  • 중간저장데이터 (input_snapshot) — JSON — 단계별 중간 저장 데이터 (이탈 복구용)
  • 진단시작일시 (started_at) — DATETIME — NOT NULL
  • 진단완료일시 (completed_at) — DATETIME

email_verifications

  • id — BIGINT — 기본 키 — NOT NULL
  • 이메일 (email) — VARCHAR(255) — NOT NULL
  • 인증토큰 (token) — VARCHAR(128) — NOT NULL
  • 사용여부 (is_used) — BOOLEAN — NOT NULL
  • 만료일시 (expires_at) — DATETIME — NOT NULL
  • 생성일시 (created_at) — DATETIME — NOT NULL
  • INDEX — idx_email_verif_email

exam_questions

  • id — BIGINT — 기본 키 — NOT NULL
  • competency_category — ENUM('math_logic', 'problem_solving', 'info_tech', 'implementation', 'system_understanding', 'data_analysis', 'communication', 'collaboration', 'self_management') — NOT NULL
  • question_text — TEXT — NOT NULL
  • option_a — TEXT — NOT NULL
  • option_b — TEXT — NOT NULL
  • option_c — TEXT — NOT NULL
  • option_d — TEXT — NOT NULL
  • correct_answer — CHAR(1) — NOT NULL — a~d
  • time_limit_sec — INT — NOT NULL
  • w_math_logic — FLOAT — NOT NULL
  • w_problem_solving — FLOAT — NOT NULL
  • w_info_tech — FLOAT — NOT NULL
  • w_implementation — FLOAT — NOT NULL
  • w_system_understanding — FLOAT — NOT NULL
  • w_data_analysis — FLOAT — NOT NULL
  • w_communication — FLOAT — NOT NULL
  • w_collaboration — FLOAT — NOT NULL
  • w_self_management — FLOAT — NOT NULL
  • created_at — DATETIME — NOT NULL

major_weekly_plan_items

  • id — BIGINT — 기본 키 — NOT NULL
  • weekly_plan_id — BIGINT — 외래 키 → major_weekly_plans.id — NOT NULL
  • week_no — INT — NOT NULL — 주차 번호 (1~N)
  • goal — VARCHAR(300) — NOT NULL — 주차 목표
  • tasks_json — JSON — 과제/할 일 목록
  • resources_json — JSON — 학습 리소스 링크 목록
  • checkpoint — VARCHAR(300) — 완료 기준

major_weekly_plan_risk_notes

  • id — BIGINT — 기본 키 — NOT NULL
  • weekly_plan_id — BIGINT — 외래 키 → major_weekly_plans.id — NOT NULL
  • note — VARCHAR(500) — NOT NULL — 리스크 또는 주의사항

major_weekly_plans

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_result_id — BIGINT — 외래 키 → diagnosis_results.id — NOT NULL
  • result_major_score_id — BIGINT — 외래 키 → result_major_scores.id — NOT NULL
  • inference_log_id — BIGINT — 외래 키 → ai_inference_logs.id
  • plan_id — VARCHAR(100) — 외부 식별용 UUID
  • version_no — INT — NOT NULL
  • source_type — ENUM('ai_generated') — NOT NULL
  • parent_plan_id — BIGINT — 외래 키 → major_weekly_plans.id — 이전 버전 계획 참조
  • overview — TEXT — 전체 계획 개요
  • fallback — BOOLEAN — NOT NULL — AI 실패 시 기본 계획 여부
  • active_version — BOOLEAN — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

majors

  • id — BIGINT — 기본 키 — NOT NULL
  • name — VARCHAR(100) — NOT NULL — 전공명
  • category — VARCHAR(50) — NOT NULL — 계열 (인문/사회/공학 등)
  • difficulty — ENUM('low', 'mid', 'high') — NOT NULL
  • description — TEXT
  • career_paths — TEXT — 졸업 후 진로
  • req_math_logic — FLOAT — NOT NULL
  • req_problem_solving — FLOAT — NOT NULL
  • req_info_tech — FLOAT — NOT NULL
  • req_implementation — FLOAT — NOT NULL
  • req_system_understanding — FLOAT — NOT NULL
  • req_data_analysis — FLOAT — NOT NULL
  • req_communication — FLOAT — NOT NULL
  • req_collaboration — FLOAT — NOT NULL
  • req_self_management — FLOAT — NOT NULL
  • tend_logical_inquiry — FLOAT — NOT NULL
  • tend_practical_tech — FLOAT — NOT NULL
  • tend_art_creative — FLOAT — NOT NULL
  • tend_social_cooperation — FLOAT — NOT NULL
  • tend_life_health — FLOAT — NOT NULL
  • tend_education_guide — FLOAT — NOT NULL
  • tend_theory_academic — FLOAT — NOT NULL
  • tend_data_analytics — FLOAT — NOT NULL
  • tend_system_operation — FLOAT — NOT NULL
  • thr_math_logic — FLOAT — 수리논리 최소 기준
  • thr_info_tech — FLOAT — 정보기술 최소 기준
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • INDEX — idx_majors_category

notices

  • id — BIGINT — 기본 키 — NOT NULL
  • created_by — BIGINT — 외래 키 → 유저.id — NOT NULL — 관리자 user_id
  • title — VARCHAR(200) — NOT NULL
  • content — TEXT — NOT NULL
  • display_type — ENUM('banner', 'popup') — NOT NULL
  • start_at — DATETIME — NOT NULL
  • end_at — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL

rag_knowledge_chunks

  • id — BIGINT — 기본 키 — NOT NULL
  • domain_type — ENUM('major', 'notice', 'policy', 'faq') — NOT NULL
  • source_ref_id — BIGINT — majors.id 등 원본 레코드 참조
  • source_title — VARCHAR(200)
  • chunk_text — TEXT — NOT NULL — 청크 원문
  • embedding_model — VARCHAR(100) — 임베딩 모델명
  • embedding_vector — VECTOR(1536) — MySQL 9 벡터 타입 (임베딩 차원)
  • token_count — INT
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • INDEX — idx_rag_chunk_domain
  • VECTOR — INDEX

rag_retrieval_logs

  • id — BIGINT — 기본 키 — NOT NULL
  • consultation_log_id — BIGINT — 외래 키 → consultation_logs.id
  • inference_log_id — BIGINT — 외래 키 → ai_inference_logs.id
  • query_text — TEXT — NOT NULL — 검색에 사용된 질의
  • top_k — INT — NOT NULL
  • retrieved_chunk_ids — JSON — 검색된 청크 ID 목록
  • rerank_scores — JSON — 재순위 점수
  • created_at — DATETIME — NOT NULL

result_ai_explanations

  • id — BIGINT — 기본 키 — NOT NULL
  • result_major_score_id — BIGINT — 외래 키 → result_major_scores.id — NOT NULL
  • inference_log_id — BIGINT — 외래 키 → ai_inference_logs.id
  • version_no — INT — NOT NULL
  • explanation_text — TEXT — NOT NULL
  • evidence_json — JSON — 근거 데이터 (점수, 강약점 등)
  • status — ENUM('generated', 'edited', 'discarded') — NOT NULL
  • created_at — DATETIME — NOT NULL

result_major_scores

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_result_id — BIGINT — 외래 키 → diagnosis_results.id — NOT NULL
  • major_id — BIGINT — 외래 키 → majors.id — NOT NULL
  • tendency_score — FLOAT — 성향 유사도 점수
  • competency_score — FLOAT — 역량 유사도 점수 (가우시안)
  • final_score — FLOAT — 최종 적합도 점수
  • rank — INT — 1~5위 (과락 제외)
  • is_failed — BOOLEAN — NOT NULL — 과락 여부
  • ai_comment — TEXT — EXT NULL COMMENT 'LLM 추천 코멘트

sessions

  • id — BIGINT — 기본 키 — NOT NULL
  • 유저 id (user_id) — BIGINT — 외래 키 → 유저.id — NOT NULL
  • refresh_token — VARCHAR(512) — NOT NULL
  • 기기정보 (device_info) — VARCHAR(255)
  • 만료일시 (expires_at) — DATETIME — NOT NULL
  • 생성일시 (created_at) — DATETIME — NOT NULL

tendency_eval_results

  • id — BIGINT — 기본 키 — NOT NULL
  • diagnosis_session_id — BIGINT — 외래 키 → diagnosis_sessions.id — NOT NULL
  • logical_inquiry — FLOAT — NOT NULL — 논리탐구형 0~1
  • practical_tech — FLOAT — NOT NULL — 실용기술형 0~1
  • art_creative — FLOAT — NOT NULL — 예술창의형 0~1
  • social_cooperation — FLOAT — NOT NULL — 사회협력형 0~1
  • life_health — FLOAT — NOT NULL — 생명보건형 0~1
  • education_guide — FLOAT — NOT NULL — 교육지도형 0~1
  • theory_academic — FLOAT — NOT NULL — 이론학구형 0~1
  • data_analytics — FLOAT — NOT NULL — 데이터분석형 0~1
  • system_operation — FLOAT — NOT NULL — 시스템운용형 0~1
  • created_at — DATETIME — NOT NULL

user_consents

  • id — BIGINT — 기본 키 — NOT NULL
  • 유저 id (user_id) — BIGINT — 외래 키 → 유저.id — NOT NULL
  • 개인정보동의 (privacy_agreed) — BOOLEAN — NOT NULL
  • 이용약관동의 (terms_agreed) — BOOLEAN — NOT NULL
  • 약관버전 (terms_version) — VARCHAR(20) — NOT NULL — 약관 버전 (예: v2.0)
  • 동의일시 (agreed_at) — DATETIME — NOT NULL

user_favorites

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → 유저.id — NOT NULL
  • major_id — BIGINT — 외래 키 → majors.id — NOT NULL
  • created_at — DATETIME — NOT NULL

유저 (users)

  • id — BIGINT — 기본 키 — NOT NULL
  • 이메일 (email) — VARCHAR(255) — NOT NULL
  • 비밀번호 (password_hash) — VARCHAR(255) — 소셜 로그인은 NULL
  • 닉네임 (nickname) — VARCHAR(50) — NOT NULL
  • 프로필 이미지 (profile_image_url) — VARCHAR(500)
  • role — ENUM('member', 'admin') — NOT NULL
  • 로그인 타입 (login_type) — ENUM('email', 'google') — NOT NULL
  • 상태 (status) — ENUM('active', 'withdrawn', 'suspended') — NOT NULL
  • 이메일 인증 시간 (email_verified_at) — DATETIME
  • 마지막 로그인 시간 (last_login_at) — DATETIME
  • 생성 시간 (created_at) — DATETIME — NOT NULL
  • 수정 시간 (updated_at) — DATETIME — NOT NULL