[Docs] infra/db/ERD.md Mermaid ERD 추가 (#28)

infra/db/ERD.md

@@ -0,0 +1,97 @@
+# HuMix DB ERD
+
+JPA 엔티티(`src/main/java/com/humix/api/domain/*/entity`) 기준 스키마입니다.
+스키마를 바꾸는 PR에서는 이 문서도 함께 갱신합니다.
+
+```mermaid
+erDiagram
+    MEMBER ||--o{ HUMMING : "records"
+    MEMBER ||--o{ MUSIC_GENERATION : "creates"
+    HUMMING ||--o{ MELODY_SCORE : "extracted to"
+    MELODY_SCORE ||--o{ MUSIC_GENERATION : "based on"
+    MUSIC_GENERATION |o--o{ MUSIC_GENERATION : "parent of"
+
+    MEMBER {
+        varchar(36) uuid PK
+        datetime created_at
+    }
+
+    HUMMING {
+        bigint humming_id PK
+        varchar(36) uuid FK
+        varchar(512) s3_file_url
+        int duration_seconds
+        datetime created_at
+    }
+
+    MELODY_SCORE {
+        bigint melody_id PK
+        bigint humming_id FK
+        longtext notes_data
+        datetime updated_at
+    }
+
+    MUSIC_GENERATION {
+        bigint generation_id PK
+        varchar(36) uuid FK
+        bigint melody_id FK
+        bigint parent_generation_id FK "nullable"
+        varchar(30) name
+        varchar(30) genre "nullable"
+        varchar(50) atmosphere "nullable"
+        varchar(512) result_s3_url "nullable"
+        varchar(100) task_id UK "nullable"
+        int duration_seconds "nullable"
+        varchar(20) status
+        datetime created_at
+    }
+```
+
+## 테이블 설명
+
+### member
+게스트 사용자. 기기 고유 UUID(`device_id`)를 PK로 사용합니다.
+
+| 컬럼 | 설명 |
+|---|---|
+| uuid | 기기 고유 식별자 (PK, 36자) |
+| created_at | 가입 시각 |
+
+### humming
+사용자가 업로드한 허밍 오디오 메타데이터.
+
+| 컬럼 | 설명 |
+|---|---|
+| humming_id | PK |
+| uuid | 소유자 (`member.uuid`) |
+| s3_file_url | S3에 업로드된 오디오 URL |
+| duration_seconds | 허밍 길이 (초) |
+| created_at | 저장 시각 |
+
+### melody_score
+허밍에서 추출한 멜로디 벡터(악보). 웹 에디터에서 수정되면 `notes_data`가 갱신됩니다.
+
+| 컬럼 | 설명 |
+|---|---|
+| melody_id | PK |
+| humming_id | 원본 허밍 (`humming.humming_id`) |
+| notes_data | 노트 배열 JSON 문자열 (`pitch`, `onset_seconds`, `duration_seconds`) |
+| updated_at | 마지막 수정 시각 |
+
+### music_generation
+AI 음악 생성 결과. 수정(재생성)하면 원본을 바꾸지 않고 `parent_generation_id`가 원본을 가리키는 새 행이 추가됩니다.
+
+| 컬럼 | 설명 |
+|---|---|
+| generation_id | PK |
+| uuid | 생성한 사용자 (`member.uuid`) |
+| melody_id | 생성에 사용한 멜로디 (`melody_score.melody_id`) |
+| parent_generation_id | 수정 원본 (`music_generation.generation_id`). 최초 생성이면 NULL |
+| name | 곡 제목 (기본값 "나의 허밍곡") |
+| genre | 장르 |
+| atmosphere | 분위기 (API의 `mood`) |
+| result_s3_url | 생성된 오디오 S3 URL. 완료 전에는 NULL |
+| task_id | 비동기 작업 ID (유니크) |
+| duration_seconds | 곡 길이 (초) |
+| status | `PROCESSING` / `COMPLETED` / `FAILED` / `CANCELED` |
+| created_at | 요청 시각 |