미니

테이블 (9)

analyses

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • recording_id — BIGINT — 외래 키 → recordings.id — NOT NULL
  • status — VARCHAR(20) — NOT NULL
  • attempt_no — INTEGER — NOT NULL — 최초 실행 1, 사용자 수동 재실행마다 +1, 최대 4. 각 회차 auto_retry_count는 0으로 초기화.
  • auto_retry_count — INTEGER — NOT NULL — 현재 수동 회차에서 추가로 시작한 자동 재시도 횟수 0~3. 최초 호출은 0.
  • failure_code — VARCHAR(50) — FAILED에서만 설정. retryable은 status=FAILED AND attempt_no<4로 계산하며 저장하지 않음.
  • worker_id — UUID — 접수 인스턴스 UUID. heartbeat 5초, lease 30초. 결과 저장 시 회차·자동횟수·소유자·상태를 함께 비교.
  • lease_expires_at — TIMESTAMPTZ
  • execution_deadline_at — TIMESTAMPTZ — NOT NULL — 현재 수동 회차 접수 시각 +600초. 자동 재시도는 이 기한을 연장하지 않음.
  • started_at — TIMESTAMPTZ
  • finished_at — TIMESTAMPTZ — 현재 회차의 성공 또는 최종 실패 확정 시각. 수동 재시도 시 NULL로 초기화.
  • speech_duration_ms — INTEGER — COMPLETED에서만 존재. 발화+침묵=recordings.duration_ms는 서비스 저장 트랜잭션에서 검증.
  • silence_duration_ms — INTEGER
  • filler_total_count — INTEGER
  • long_silence_count — INTEGER
  • repeated_expression_count — INTEGER
  • algorithm_version — VARCHAR(32) — NOT NULL
  • engine_type — VARCHAR(10) — NOT NULL
  • engine_version — VARCHAR(100) — NOT NULL
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL

analysis_pro_results

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • analysis_id — BIGINT — 외래 키 → analyses.id — NOT NULL
  • words_per_minute — INTEGER — round(total_word_count*60000/analyses.speech_duration_ms), 0.5 올림. 발화시간 0이면 NULL.
  • total_word_count — INTEGER — NOT NULL
  • speech_intervals — JSONB — NOT NULL — startMs/endMs 객체 배열. 오름차순, 반열린 구간, 비중첩, 녹음 길이 안. 무음이면 빈 배열.
  • waveform — JSONB — NOT NULL — 100ms 간격 RMS 점 배열. 각 점은 timeMs, amplitude(0~1), type(SPEECH/SILENCE). 최대 600점. 마지막 구간은 짧을 수 있음.
  • coaching_summary — TEXT — NOT NULL
  • coaching_practice_recommendation — TEXT — NOT NULL
  • created_at — TIMESTAMPTZ — NOT NULL

api_idempotency_keys

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL
  • idempotency_key — UUID — NOT NULL
  • operation — VARCHAR(20) — NOT NULL
  • request_fingerprint — VARCHAR(64) — NOT NULL — UTF-8 문자열 operation + LF + targetAnalysisId(생성은 -) + LF + audioSha256의 SHA-256. multipart boundary와 filename 제외.
  • recording_id — BIGINT — 외래 키 → recordings.id — 삭제 시 NULL이 되어 24시간 동안 410 RESOURCE_GONE을 반환하는 tombstone 역할. 삭제된 작업 재생성 금지.
  • analysis_id — BIGINT — 외래 키 → analyses.id
  • response_status — INTEGER — NOT NULL
  • response_body — JSONB — NOT NULL — 최초 202 응답 전체 envelope. 원본 음성/전사문 없음. 같은 요청이면 이 스냅샷을 그대로 반환.
  • created_at — TIMESTAMPTZ — NOT NULL
  • expires_at — TIMESTAMPTZ — NOT NULL

coaching_action_items

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • pro_result_id — BIGINT — 외래 키 → analysis_pro_results.id — NOT NULL
  • sort_order — INTEGER — NOT NULL
  • content — TEXT — NOT NULL

filler_breakdowns

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • analysis_id — BIGINT — 외래 키 → analyses.id — NOT NULL
  • expression — VARCHAR(50) — NOT NULL
  • occurrence_count — INTEGER — NOT NULL

filler_timeline_events

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • analysis_id — BIGINT — 외래 키 → analyses.id — NOT NULL
  • event_index — INTEGER — NOT NULL
  • time_ms — INTEGER — NOT NULL
  • expression — VARCHAR(50) — NOT NULL

recordings

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL
  • duration_ms — INTEGER — NOT NULL — 서버가 원본을 mono 16kHz PCM으로 디코딩하여 확인한 길이. 1000~60000ms. 초과분 자동 잘라내기 없음.
  • mime_type — VARCHAR(50) — NOT NULL
  • file_size_bytes — BIGINT — NOT NULL
  • audio_sha256 — VARCHAR(64) — NOT NULL — 최초 audio 파트 바이트의 SHA-256 소문자 hex. 재시도 시 바이트 동일성을 검증.
  • submitted_at — TIMESTAMPTZ — NOT NULL — 서버 최초 접수 UTC 시각. 화면의 제출일 및 통계 날짜 기준. 수동 재시도로 변경하지 않음.

segment_analyses

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • analysis_id — BIGINT — 외래 키 → analyses.id — NOT NULL
  • segment — VARCHAR(10) — NOT NULL
  • filler_count — INTEGER — NOT NULL
  • habit_word_count — INTEGER — NOT NULL

users

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • email — VARCHAR(254) — NOT NULL — 앞뒤 공백 제거 후 ASCII 소문자로 정규화한 이메일. 형식 검증은 서비스에서 수행.
  • password_hash — VARCHAR(255) — NOT NULL — BCrypt cost 12 해시. 원문 비밀번호 미보관.
  • name — VARCHAR(50) — NOT NULL
  • profile_image_url — VARCHAR(500)
  • plan — VARCHAR(10) — NOT NULL
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL