피드백받은 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 — 생성일시