피드백받은 ERD (26.04.20)
테이블 (33)
AI 분석 문제 구간 (ai_analysis_region)
- id — INT — 기본 키 — NOT NULL — 분석 구간 ID
- jobId — INT — 외래 키 → AI 분석 작업.id — NOT NULL — AI 분석 작업 ID
- regionTypeCode — INT — NOT NULL — 구간 유형 코드
- startMs — BIGINT — NOT NULL — 시작 시각(ms)
- endMs — BIGINT — NOT NULL — 종료 시각(ms)
- severityCode — INT — NOT NULL — 심각도 코드
- evidenceJson — JSON — NOT NULL — 유형별 세부 근거
- analysisSummary — VARCHAR(500) — 분석 요약
- createdAt — DATETIME — NOT NULL — 생성 시각
AI 분석 작업 (ai_analysis_job)
- id — INT — 기본 키 — NOT NULL — AI 분석 작업 ID
- projectId — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트 ID
- requestedBy — BIGINT — NOT NULL — 요청 사용자 ID
- timelineSnapshotId — INT — 외래 키 → AI 분석 타임라인 스냅샷.id — 분석 기준 타임라인 스냅샷 ID
- langgraphThreadId — VARCHAR(100) — NOT NULL — LangGraph 스레드 ID
- statusCode — INT — NOT NULL — 작업 상태 코드
- progress — TINYINT — NOT NULL — 진행률 0~100
- currentNode — VARCHAR(100) — 현재 LangGraph 노드
- errorCode — VARCHAR(100) — 오류 코드
- errorMessage — VARCHAR(1000) — 오류 메시지
- startedAt — DATETIME — 작업 시작 시각
- completedAt — DATETIME — 작업 완료 시각
- createdAt — DATETIME — NOT NULL — 생성 시각
- updatedAt — DATETIME — NOT NULL — 수정 시각
AI 분석 타임라인 스냅샷 (ai_timeline_snapshot)
- id — INT — 기본 키 — NOT NULL — AI 분석 타임라인 스냅샷 ID
- projectId — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트 ID
- snapshotTypeCode — VARCHAR(50) — NOT NULL — 스냅샷 유형 코드
- timelineVersion — BIGINT — 타임라인 버전
- snapshotJson — JSON — NOT NULL — 분석 시점 타임라인 전체 상태
- createdBy — BIGINT — NOT NULL — 생성 사용자 ID
- createdAt — DATETIME — NOT NULL — 생성 시각
LLM 답변 평가 로그 (ai_llm_evaluation)
- id — INT — 기본 키 — NOT NULL — LLM 평가 로그 ID
- modelName — VARCHAR(100) — NOT NULL — 평가 모델명
- verdictCode — INT — NOT NULL — 평가 결과 코드
- score — DECIMAL(6, 5) — 평가 점수
- reasonJson — JSON — 평가 근거
- inputCredit — DECIMAL(12, 4) — 입력 사용 크레딧
- outputCredit — DECIMAL(12, 4) — 출력 사용 크레딧
- totalCredit — DECIMAL(12, 4) — 총 사용 크레딧
- createdAt — DATETIME — NOT NULL — 생성 시각
- jobId — NOT NULL — AI 분석 작업 ID
- suggestionId — INT — NOT NULL — 수정안 ID
RAG 검색 결과 문서 (ai_rag_retrieval_doc)
- id — INT — 기본 키 — NOT NULL — RAG 검색 결과 문서 ID
- rankNo — TINYINT — NOT NULL — 검색 순위
- score — DECIMAL(8, 6) — 검색 점수
- snippet — TEXT — 사용 문단
- retrievalId — INT — NOT NULL — RAG 검색 로그 ID
- ragDocumentId — INT — NOT NULL — RAG 문서 ID
RAG 검색 로그 (ai_rag_retrieval)
- id — INT — 기본 키 — NOT NULL — RAG 검색 로그 ID
- jobId — INT — NOT NULL — AI 분석 작업 ID
- regionId — INT — 분석 구간 ID
- queryText — TEXT — NOT NULL — 검색 쿼리
- topK — TINYINT — NOT NULL — 검색 문서 수
- qualityScore — DECIMAL(6, 5) — 검색 품질 점수
- usedWebFallback — BOOLEAN — NOT NULL — 웹검색 사용 여부
- createdAt — DATETIME — NOT NULL — 생성 시각
RAG 문서 (ai_rag_document)
- id — INT — 기본 키 — NOT NULL — RAG 문서 ID
- title — VARCHAR(255) — NOT NULL — 문서 제목
- body — TEXT — NOT NULL — 문서 본문
- genreMain — VARCHAR(50) — 주 장르
- genreSub — VARCHAR(50) — 세부 장르
- conflictBand — VARCHAR(50) — 충돌 대역
- conflictType — VARCHAR(80) — 충돌 유형
- clipCharacter — VARCHAR(80) — 클립 성격
- actionType — VARCHAR(80) — 수정 방식
- strengthLevelCode — INT — 수정 강도 코드
- appliesWhen — TEXT — 적용 조건
- avoidWhen — TEXT — 피해야 할 조건
- source — VARCHAR(255) — 출처
- vectorStore — VARCHAR(50) — 벡터 저장소 종류
- vectorRef — VARCHAR(255) — 벡터 저장소 참조값
- createdAt — DATETIME — NOT NULL — 생성 시각
- updatedAt — DATETIME — NOT NULL — 수정 시각
개별 수정안 (ai_suggestion)
- id — INT — 기본 키 — NOT NULL — 수정안 ID
- groupId — INT — 외래 키 → 수정안 그룹.id — NOT NULL — 수정안 그룹 ID
- rankNo — TINYINT — NOT NULL — 추천 순위
- summary — VARCHAR(500) — NOT NULL — 수정안 요약
- explanation — TEXT — 수정안 설명
- validationStatusCode — INT — NOT NULL — 수정안 검증 상태 코드
- judgeScore — DECIMAL(6, 5) — 평가 점수
- createdAt — DATETIME — NOT NULL — 생성 시각
공통코드그룹 (common_code_group)
- code — INTEGER — 기본 키 — NOT NULL — 그룹코드ID
- name — VARCHAR(50) — NOT NULL — 그룹코드명
- decription (description) — VARCHAR(255) — 설명
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
공통코드상세 (common_code_detail)
- code — INTEGER — 기본 키 — NOT NULL — 상세코드ID
- group_code (groupCode) — INTEGER — 외래 키 → 공통코드그룹.code — NOT NULL — 그룹코드ID
- name — VARCHAR(50) — NOT NULL — 상세코드명
- description — VARCHAR(255) — 설명
- is_active (isActive) — BOOLEAN — NOT NULL — 사용 여부
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
댓글 (comment)
- id — BIGINT — 기본 키 — NOT NULL — 댓글id
- track_id (trackId) — BIGINT — 외래 키 → 트랙.id — NOT NULL — 트랙id
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 회원id
- content — TEXT — NOT NULL — 댓글 내용
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- updated_at (updatedAt) — DATETIME — NOT NULL — 수정일시
- deleted_at (deletedAt) — DATETIME — 삭제일시
댓글 멘션 (comment_mention)
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 회원id
- comment_id (idcommentId) — BIGINT — 외래 키 → 댓글.id — NOT NULL — 댓글id
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
메인 클립 선택 (ai_main_clip_selection)
- id — INT — 기본 키 — NOT NULL — 메인 클립 선택 ID
- regionId — INT — 외래 키 → AI 분석 문제 구간.id — NOT NULL — 분석 구간 ID
- selectedClipId — BIGINT — NOT NULL — 선택한 메인 클립 ID
- selectedBy — BIGINT — NOT NULL — 선택 사용자 ID
- selectedAt — DATETIME — NOT NULL — 선택 시각
분석 구간 관련 클립 (ai_region_clip)
- id — INT — 기본 키 — NOT NULL — 분석 구간 관련 클립 ID
- regionId — INT — 외래 키 → AI 분석 문제 구간.id — NOT NULL — 분석 구간 ID
- clipId — BIGINT — NOT NULL — 클립 ID
- roleCode — INT — NOT NULL — 구간 내 클립 역할 코드
- energySummaryJson — JSON — 클립 에너지 요약 정보
- createdAt — DATETIME — NOT NULL — 생성 시각
수정 액션 (ai_suggestion_action)
- id — INT — 기본 키 — NOT NULL — 수정 액션 ID
- suggestionId — INT — 외래 키 → 개별 수정안.id — NOT NULL — 수정안 ID
- actionTypeCode — INT — NOT NULL — 수정 액션 유형 코드
- clipId — BIGINT — NOT NULL — 대상 클립 ID
- startMs — BIGINT — 적용 시작 시각
- endMs — BIGINT — 적용 종료 시각
- bandLowHz — INT — 적용 대역 시작 주파수
- bandHighHz — INT — 적용 대역 끝 주파수
- gainDeltaDb — DECIMAL(6, 3) — 볼륨 변화량
- moveDeltaMs — INT — 클립 이동량
- paramsJson — JSON — 추가 파라미터
- createdAt — DATETIME — NOT NULL — 생성 시각
수정안 그룹 (ai_suggestion_group)
- id — INT — 기본 키 — NOT NULL — 수정안 그룹 ID
- jobId — INT — 외래 키 → AI 분석 작업.id — NOT NULL — AI 분석 작업 ID
- regionId — INT — 외래 키 → AI 분석 문제 구간.id — 분석 구간 ID
- groupTypeCode — INT — NOT NULL — 수정안 그룹 유형 코드
- startMs — BIGINT — 그룹 시작 시각
- endMs — BIGINT — 그룹 종료 시각
- title — VARCHAR(255) — NOT NULL — 그룹 제목
- summary — TEXT — 그룹 설명
- createdAt — DATETIME — NOT NULL — 생성 시각
오디오 파일 (audio_metadata)
- id — BIGINT — 기본 키 — NOT NULL — 오디오메타데이터id
- bucket — VARCHAR(50) — S3_bucket
- key — VARCHAR(50) — NOT NULL — S3_key
- original_filename (originalFilename) — VARCHAR(255) — 파일명
- mime_type (mimeType) — VARCHAR(100) — 'audio/mpeg', 'audio/wav'
- size_bytes (sizeBytes) — BIGINT
- duration_ms (durationMs) — BIGINT — NOT NULL — 오디오 길이
- status — VARCHAR(30) — NOT NULL — 상태(업로드진행중,업로드완료,변환전,파형 추출 전 등)
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- deleted_at (deletedAt) — DATETIME — 삭제일시(soft delete)
웹검색 결과 문서 (ai_web_search_result)
- id — INT — 기본 키 — NOT NULL — 웹검색 결과 ID
- queryText — TEXT — NOT NULL — 웹검색 쿼리
- title — VARCHAR(500) — 문서 제목
- url — VARCHAR(1000) — 문서 URL
- snippet — TEXT — 요약
- trusted — BOOLEAN — NOT NULL — 신뢰 가능 여부
- createdAt — DATETIME — NOT NULL — 생성 시각
- jobId — INT — AI 분석 작업 ID
- regionId — INT — 분석 구간 ID
장르 후보 (ai_genre_candidate)
- id — INT — 기본 키 — NOT NULL — 장르 후보 ID
- trackId — BIGINT — 외래 키 → 트랙.id — NOT NULL — 트랙 ID
- label — VARCHAR(100) — NOT NULL — 장르 라벨
- score — DECIMAL(8, 6) — NOT NULL — 유사도 점수
- rankNo — TINYINT — NOT NULL — 순위
- modelName — VARCHAR(100) — NOT NULL — 모델명
- createdAt — DATETIME — NOT NULL — 생성 시각
적용된 수정안 (ai_applied_suggestion)
- id — INT — 기본 키 — NOT NULL — 적용 수정안 ID
- projectId — BIGINT — NOT NULL — 프로젝트 ID
- jobId — INT — 외래 키 → AI 분석 작업.id — NOT NULL — AI 분석 작업 ID
- suggestionId — INT — 외래 키 → 개별 수정안.id — NOT NULL — 수정안 ID
- appliedBy — BIGINT — NOT NULL — 적용 사용자 ID
- beforeSnapshotId — INT — 외래 키 → AI 분석 타임라인 스냅샷.id — 적용 전 스냅샷 ID
- afterSnapshotId — INT — 외래 키 → AI 분석 타임라인 스냅샷.id — 적용 후 스냅샷 ID
- statusCode — INT — NOT NULL — 적용 상태 코드
- createdAt — DATETIME — NOT NULL — 생성 시각
- updatedAt — DATETIME — NOT NULL — 수정 시각
채팅방 (dm_room)
- id — BIGINT — 기본 키 — NOT NULL — 채팅방id
클립 (clip)
- id — BIGINT — 기본 키 — NOT NULL — 클립id
- track_id (trackId) — BIGINT — 외래 키 → 트랙.id — NOT NULL — 트랙id
- audio_metadata_id (audioMetadataId) — BIGINT — 외래 키 → 오디오 파일.id — NOT NULL — 오디오 메타데이터id
- color_hex (color) — VARCHAR(7) — NOT NULL — 클립색상
- clip_start (start) — DECIMAL(11, 7) — NOT NULL — 시작점
- clip_duration (duration) — DECIMAL(11,7) — NOT NULL — 클립길이
- audio_start_ms (audioStartMs) — BIGINT — NOT NULL — 오디오 시작점
- audio_duration_ms (audioDurationMs) — BIGINT — NOT NULL — 오디오 길이
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- updated_at (updatedAt) — DATETIME — NOT NULL — 수정일시
트랙 (track)
- id — BIGINT — 기본 키 — NOT NULL — 트랙id
- project_id (projectId) — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트id
- order_index (orderIndex) — SMALLINT UNSIGNED — NOT NULL — 트랙 순서
- type — VARCHAR(10) — NOT NULL — 트랙타입(audio, midi)
- name — VARCHAR(255) — 트랙명
- is_soloed (isSoloed) — BOOLEAN — NOT NULL — 솔로 활성화 여부
- is_muted (isMuted) — BOOLEAN — NOT NULL — 음소거 활성화 여부
- volume — TINYINT — NOT NULL — 음량
- pan — TINYINT — NOT NULL — 패닝
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- updated_at (updatedAt) — DATETIME — NOT NULL — 수정일시
트랙 단위 보컬 판별 결과 (ai_track_vocal_prediction)
- id — INT — 기본 키 — NOT NULL — 트랙 보컬 판별 결과 ID
- trackId — BIGINT — 외래 키 → 트랙.id — NOT NULL — 트랙 ID
- vocalScore — DECIMAL(6, 5) — NOT NULL — 보컬성 점수
- isVocal — BOOLEAN — NOT NULL — 보컬 트랙 여부
- confidence — DECIMAL(6, 5) — 판별 신뢰도
- evidenceJson — JSON — 샘플링 근거 정보
- modelName — VARCHAR(100) — 사용 모델명
- createdAt — DATETIME — NOT NULL — 생성 시각
- updatedAt — DATETIME — NOT NULL — 수정 시각
포지션 그룹 (position_group)
- code — INT — 기본 키 — NOT NULL — 그룹코드
- name — VARCHAR(50) — NOT NULL — 코드명
- order — INT — NOT NULL — 정렬 순서
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
포지션 상세 (position_detail)
- code — INT — 기본 키 — NOT NULL — 상세코드
- group_code (groupCode) — INT — 외래 키 → 포지션 그룹.code — NOT NULL — 그룹코드
- name — VARCHAR(50) — NOT NULL — 코드명
- order — INT — NOT NULL — 정렬 순서
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
프로젝트 (project)
- id — BIGINT — 기본 키 — NOT NULL — 프로젝트id
- root_note (rootNote) — VARCHAR(2) — NOT NULL — 근음 (전조가 있는 경우, 가장 첫 부분을 기준)
- mode — VARCHAR(10) — NOT NULL — 조성 (전조가 있는 경우, 가장 첫 부분을 기준)
- tempo — DECIMAL(6, 2) — NOT NULL — 빠르기 (일정하지 않은 경우, 가장 첫 부분을 기준)
- time_sig_numerator (timeSigNumerator) — TINYINT UNSIGNED — NOT NULL — 박자표의 분자 (변박의 경우, 가장 첫 부분을 기준)
- time_sig_denominator (timeSigDenominator) — TINYINT UNSIGNED — NOT NULL — 박자표의 분모 (변박의 경우, 가장 첫 부분을 기준)
- total_bar_count (totalBarCount) — SMALLINT UNSIGNED — NOT NULL — 프로젝트의 총 마디 수
- total_play_time (totalPlayTime) — SMALLINT UNSIGNED — NOT NULL — 프로젝트의 총 재생시간
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- updated_at (updatedAt) — DATETIME — NOT NULL — 수정일시
- deleted_at (deletedAt) — DATETIME — 삭제일시
프로젝트 마스터 오디오 버전(export audio) (project_master_audio_version)
- id — BIGINT — 기본 키 — NOT NULL — 버전id
- project_id (projectId) — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트id
- audio_metadata_id (audioMetadataId) — BIGINT — 외래 키 → 오디오 파일.id — NOT NULL — 오디오메타데이터id
- order — TINYINT — NOT NULL — 정렬순서
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
프로젝트 수정 이벤트 로그 (project_edit_event_log)
- id (logId) — BIGINT — 기본 키 — NOT NULL — 로그id
- project_id (projectId) — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트id
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 유저id
- event_type (eventType) — ENUM — NOT NULL — 이벤트타입 (enum or 공통코드)
- payload — JSON — NOT NULL — 변경내용
- seq — BIGINT — NOT NULL — 프로젝트 내 편집 순서(cusor 이동 시 사용)
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- deleted_at (deletedAt) — DATETIME — 삭제일시
프로젝트 참여 회원 (project_members)
- project_id (projectId) — BIGINT — 외래 키 → 프로젝트.id — NOT NULL — 프로젝트id
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 회원id
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
회원 (user)
- id — BIGINT — 기본 키 — NOT NULL — 회원id
- email — VARCHAR(255) — NOT NULL — 이메일(로그인 식별자)
- provider — VARCHAR(20) — NOT NULL — 인증수단(google, kakao, naver)
- provider_id (providerId) — VARCHAR(100) — NOT NULL — oauth 인증id
- profile_img_url (profileImgUrl) — VARCHAR(255) — oauth 프로필 이미지
- nickname — VARCHAR(20) — NOT NULL — 닉네임
- last_login_at (lastLoginAt) — DATETIME — NOT NULL — 마지막 로그인 일시
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
- deleted_at (deletedAt) — DATETIME — 삭제일시
회원-채팅방 (dm_room_member)
- dm_room_id (roomId) — BIGINT — 외래 키 → 채팅방.id — NOT NULL — 채팅방id
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 회원id
- created_at (createdAt) — DATETIME — NOT NULL — 생성일시
회원-포지션 (user_position)
- user_id (userId) — BIGINT — 외래 키 → 회원.id — NOT NULL — 회원id
- position_code (positionCode) — INT — 외래 키 → 포지션 상세.code — NOT NULL — 포지션 상세코드
- created_at (createdAi) — DATETIME — NOT NULL — 생성일시