자율

테이블 (15)

GCS 저장 파일 메타데이터 (media_files)

  • pk (id) — primary key — 기본 키 — NOT NULL
  • FK (user_id) — int — 외래 키 → 유저.PK — NOT NULL — 유저 pk
  • "user_123/audio/abc.wav" 형식의 키 (경로) (object_key) — VARCHAR(256) — NOT NULL
  • 미디어 종류 (media_type) — VARCHAR(20) — NOT NULL
  • 파일 이름 (file_name) — VARCHAR(255) — NOT NULL
  • 파일 용량 (file_size_bytes) — BIGINT — NOT NULL
  • 확장자 (format) — VARCHAR(50) — NOT NULL
  • 오디오/비디오 길이 (duration_ms) — INTEGER
  • 이미지/비디오 넓이 (width_px) — INTEGER
  • 이미지/비디오 높이 (height_px) — INTEGER
  • 상태 (status) — VARCHAR(20)
  • 공개 여부 (is_public) — BOOLEAN — 공개일 경우 True
  • 생성일 (created_at) — TIMESTAMP — NOT NULL
  • 수정일 (updated_at) — TIMESTAMP

JWT refresh token 관리 (refresh_tockens)

  • PK (id) — integer — 기본 키 — NOT NULL — 토큰 PK
  • FK (user_id) — integer — 외래 키 → 유저.PK — NOT NULL — 유저 PK
  • 해쉬토큰 (tocken_hash) — str — NOT NULL — 해쉬된토큰
  • 만료일 (expires_at) — datetime — NOT NULL — 만료 시간

Praat 추출 (praat_features)

  • PK (id) — int — 기본 키 — NOT NULL — praat PK
  • FK (media_file_id) — int — 외래 키 → GCS 저장 파일 메타데이터.pk — NOT NULL
  • 성대 진동 시간적 불안정성 (jitter_local) — float
  • 성대 떨림의 음량적 불안정성 (shimmer_local) — float
  • 목소리 노이즈 비율(높으면 정상) (hnr) — float
  • 목소리 노이즈 비율(낮으면 정상) (nhr) — float
  • 성대 진동수 (f0) — float
  • 최대 기본 주파수 (max_f0) — float
  • 최소 기본 주파수 (min_f0) — float
  • 음성의 명료도 (cpp) — float
  • 음성 장애 종합 점수 (csid) — float
  • 저주파 에너지 대비 고주파 애너지 평균 비율 (lh_ratio_mean_db) — float
  • 발성 중 주파수 에너지의 안정성 (lh_ratio_sd_db) — float
  • 혀의 높낮이와 관련 (f1) — float
  • 혀의 전후 위치와 관련 (f2) — float
  • 발성 구간의 평균 음량 (intensity_mean) — float

ai 모델 (ai_models)

  • PK (id) — integer — 기본 키 — NOT NULL — 모델 PK
  • 모델 버전 (version) — varchar — NOT NULL — GPT-5-nano
  • 모델 추가 일시 (created_at) — datetime — NOT NULL

alembic 버전관리 (alembic_version)

  • 버전 번호 (version_num) — varchar — NOT NULL — 마이그레이션 버전 번호

세션 별 LLM 피드백 (train_session_praat_feedback)

  • PK (id) — integer — 기본 키 — NOT NULL — 통합 LLM 피드백 PK
  • FK (ai_model_id) — integer — 외래 키 → ai 모델.PK — NOT NULL — 모델 PK
  • FK (session_praat_result_id) — integer — NOT NULL — 세션 별 평균 praat FK
  • 피드백 내용 (feedback_text) — text — NOT NULL
  • 생성일 (created_at) — timestamp — NOT NULL

세션 별 praat 평균값(반정규화) (session_praat_results)

  • PK (id) — integer — 기본 키 — NOT NULL — praat 평균값 PK
  • FK (training_session_id) — integer — 외래 키 → 연습/평가 저장용 세션.PK — NOT NULL — 연습 세션 PK
  • FK (praat_id) — integer — 외래 키 → Praat 추출.PK — NOT NULL — praat PK
  • 세션 평균 성대 떨림의 음량적 불안정성 (avg_shimmer_local) — double
  • 세션 평균 목소리 노이즈 비율(낮으면 정상) (avg_nhr) — double
  • 세션 평균 목소리 노이즈 비율(높으면 정상) (avg_hnr) — double
  • 세션 평균 저주파 에너지 대비 고주파 애너지 평균 비율 (avg_lh_ratio_mean_db) — double
  • 세션 평균 발성 중 주파수 에너지의 안정성 (avg_lh_ratio_sd_db) — double
  • 세션 평균 최대 기본 주파수 (avg_max_f0) — double
  • 세션 평균 최소 기본 주파수 (avg_min_f0) — double
  • 세션 평균 발성 구간의 평균 음량 (avg_intensity_mean) — double
  • 세션 평균 성대 진동수 (avg_f0) — double
  • 세션 평균 혀의 높낮이와 관련 (avg_f1) — double
  • 세션 평균 혀의 전후 위치와 관련 (avg_f2) — double
  • 생셩일 (created_at) — timestamp — NOT NULL
  • 수정일 (updated_at) — timestamp — NOT NULL
  • 세션 평균 성대 진동 시간적 불안정성 (avg_jitter_local) — double
  • 세션 평균 음성의 명료도 (avg_cpp) — double
  • 세션 평균 음성 장애 종합 점수 (avg_csid) — double

아이템 별 LLM 피드백 (train_item_praat_feedback)

  • Key — 기본 키 — NOT NULL
  • pk (id2) — int — 외래 키 → Praat 추출.PK — NOT NULL
  • 모델 번호 (id3) — integer — 외래 키 → ai 모델.PK — NOT NULL — pk
  • 생성일 (created_at) — timestamp — NOT NULL
  • 아이템 별 피드백 내용 (item_feedback) — text — NOT NULL

연습 /평가 아이템 (training_items)

  • PK (id) — integer — 기본 키 — NOT NULL — 연습 아이템 PK
  • FK (word_id) — integer — 외래 키 → 연습/평가용 단어.PK — NOT NULL — 단어 PK
  • FK (sentence_id) — integer — 외래 키 → 연습/평가용 문장.pk — NOT NULL — 문장 PK
  • FK (training_session_id) — integer — 외래 키 → 연습/평가 저장용 세션.PK — NOT NULL — 연습 세션 PK
  • FK (media_file_id) — integer — 외래 키 → GCS 저장 파일 메타데이터.pk — NOT NULL
  • 세션에서 몇번째 아이템인지 확인하기 위한 index (item_index) — integer — NOT NULL
  • 완료 여부 (is_completed) — boolean — NOT NULL
  • 완료일 (completed_at) — timestamp
  • 생성일 (created_at) — timestamp — NOT NULL
  • 수정일 (updated_at) — timestamp — NOT NULL
  • GCS url (video_url) — character
  • 피드백 (feedback) — character

연습/평가 저장용 세션 (training_sessions)

  • PK (id) — integer — 기본 키 — NOT NULL — 연습 세션 PK
  • FK (user_id) — integer — 외래 키 → 유저.PK — NOT NULL — 유저 pk
  • 발성 / 단어 / 문장 확인 (type) — ENUM — NOT NULL
  • 진행 상황 파악 (status) — ENUM — NOT NULL
  • 총 아이템들의 갯수 (total_items) — integer — NOT NULL
  • 완료된 아이템들의 갯수 (completed_items) — integer — NOT NULL
  • 현재 진행중인 아이템의 index (current_item_index) — integer — NOT NULL
  • 생성일 (created_at) — timestamp — NOT NULL
  • 수정일 (updated_at) — timestamp — NOT NULL
  • 완료일 (completed_at) — timestamp
  • 연습/평가 세션 이름 (session_name) — character — NOT NULL
  • 훈련 진행도 (progress_percentage) — double — NOT NULL
  • 세션에 대한 메타데이터 (session_metadata) — json

연습/평가용 단어 (training_words)

  • PK (id) — integer — 기본 키 — NOT NULL — 단어 pk
  • 단어 (word) — varchar — NOT NULL
  • 단어 추가 일시 (created_at) — datetime — NOT NULL
  • 단어 수정 일시 (updated_at) — datetime

연습/평가용 문장 (training_sentences)

  • pk (id) — int — 기본 키 — NOT NULL — 문장 pk
  • 문장 (sentence) — varchar — NOT NULL
  • 문장 추가 일시 (created_at) — datetime — NOT NULL
  • 문장 수정 일시 (updated_at) — datetime

유저 (users)

  • PK (id) — integer — 기본 키 — NOT NULL — 유저 PK
  • 이메일 (username) — varchar — NOT NULL — 이메일이 ID
  • 비밀번호 (password) — varchar
  • 이름 (name) — varchar — NOT NULL
  • 권한 (role) — varchar — NOT NULL — USER,TERAFIST,ADMIN
  • 회원가입 일시 (created_at) — datetime — NOT NULL
  • 정보 수정 일시 (updated_at) — datetime

음성 STT 결과 (training_item_stt_results)

  • PK (id) — integer — 기본 키 — NOT NULL — STT PK
  • FK (training_item_id) — integer — 외래 키 → 연습 /평가 아이템.PK — NOT NULL — 연습 아이템 PK
  • FK (ai_model_id) — integer — 외래 키 → ai 모델.PK — NOT NULL — 모델 PK
  • STT 결과 추출물 (stt_result) — varchar — NOT NULL
  • 생성일 (created_at) — timestamp — NOT NULL

합성 음성 (user_voice)

  • pk (id) — integer — 기본 키 — NOT NULL — 유저pk
  • 유저fk (user_id) — integer — 외래 키 → 유저.PK — NOT NULL — 유저 fk
  • 일레븐랩스번호 (voice_id) — varchar — NOT NULL
  • 갱신 횟수 (update_count) — integer — NOT NULL
  • 오디오 길이 (sourcePaudeio_duration_ms) — integer — NOT NULL
  • 정보 생성 일시 (created_at) — datetime — NOT NULL
  • 정보 깅샌 일시 (updated_at) — datetime — NOT NULL