미니
테이블 (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