미디어 카테고리 관리 추가

docs/history.md

@@ -1,5 +1,13 @@
 # 의사결정 이력
 
+## 2026-05-02 v0.0.26
+
+### 미디어 카테고리 저장 방식 결정
+
+미디어 카테고리는 실제 파일 경로나 URL을 변경하지 않고 `media_metadata` 테이블에 URL별 메타데이터로 저장한다. 업로드 파일을 폴더별로 이동하면 이미 게시물이나 페이지에 저장된 이미지 URL이 깨질 수 있기 때문이다.
+
+파일명 변경은 사용 중인 미디어에서 차단되어 있지만, 미사용 파일명을 변경할 때는 기존 URL의 메타데이터도 새 URL로 옮긴다. 삭제 시에는 남은 메타데이터가 쌓이지 않도록 함께 정리한다.
+
 ## 2026-05-02 v0.0.25
 
 ### 빈 문단 placeholder 표시와 네비게이션 관리 범위 결정

docs/map.md

@@ -143,6 +143,7 @@
 | db/migrations/003_add_tag_display_fields.sql | 태그 표시 순서와 색상 필드 추가 |
 | db/migrations/004_add_site_settings.sql | 사이트 설정 테이블 추가 |
 | db/migrations/005_add_navigation_items.sql | 네비게이션 항목 테이블 추가 |
+| db/migrations/006_add_media_metadata.sql | 미디어 메타데이터 테이블 추가 |
 
 ## 설정/배포
 

docs/spec.md

@@ -179,6 +179,15 @@ components/content/
 | created_at | DateTime | 생성일 |
 | updated_at | DateTime | 수정일 |
 
+### MediaMetadata
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| url | String | 업로드 미디어 URL |
+| category | String | 관리자 분류명 |
+| created_at | DateTime | 생성일 |
+| updated_at | DateTime | 수정일 |
+
 ### PostTags (다대다)
 
 | 필드 | 타입 | 설명 |
@@ -332,11 +341,13 @@ components/content/
 - 업로드 파일 크기 제한은 `MAX_FILE_SIZE` 환경 변수를 따른다.
 - 로컬 개발 업로드 파일은 `public/uploads/posts/YYYY/MM/` 아래 저장하고 `/uploads/posts/YYYY/MM/filename` URL로 제공한다.
 - 관리자 미디어 화면은 고밀도 썸네일 갤러리, 검색, 파일명 변경, 개별 삭제를 제공한다.
+- 관리자 미디어 화면은 카테고리 필터와 미디어별 카테고리 수정을 제공한다.
 - 미디어 파일 경로, 사용 현황, 용량 등 세부 정보는 썸네일 클릭 시 열리는 상세 모달에서 표시한다.
+- 미디어 카테고리는 파일 경로를 옮기지 않고 `media_metadata` 테이블에 URL별로 저장한다.
 - 글쓰기 미디어 선택 창은 업로드 미디어 목록에서 이미지를 선택해 단일 이미지 또는 갤러리에 삽입한다.
 - 미디어 사용 현황은 게시물/페이지의 대표 이미지와 본문 내 URL을 기준으로 표시한다.
 - 사용 중인 미디어는 저장된 콘텐츠 URL이 깨지지 않도록 파일명 변경과 삭제를 차단한다.
-- 향후 미디어 라이브러리는 카테고리 분류와 프로필/사이트 설정 이미지 사용처 추적을 제공한다.
+- 향후 미디어 라이브러리는 프로필/사이트 설정 이미지 사용처 추적을 제공한다.
 
 ---
 

docs/todo.md

@@ -18,7 +18,7 @@
 - [ ] 페이지 관리 브라우저 수동 QA: 생성, 수정, 삭제, 공개 보기 확인
 - [ ] 사이트 설정 브라우저 수동 QA: 저장, 공개 헤더/사이드바 반영, 잘못된 URL 실패 확인
 - [ ] 메뉴/네비게이션 브라우저 수동 QA: 항목 추가, 삭제, 숨김, 정렬, 공개 사이드바 반영 확인
-- [ ] 미디어 라이브러리 카테고리 분류
+- [ ] 미디어 라이브러리 카테고리 브라우저 수동 QA: 카테고리 저장, 필터, 파일명 변경 후 유지 확인
 - [ ] 미디어 라이브러리 프로필/사이트 설정 이미지 사용처 추적
 
 ## 3차 관리자 개발

docs/update.md

@@ -1,5 +1,14 @@
 # 업데이트 이력
 
+## v0.0.26
+
+- 미디어 메타데이터 테이블 추가.
+- 미디어 URL별 카테고리 저장 기능 추가.
+- 관리자 미디어 목록에 카테고리 필터 추가.
+- 관리자 미디어 상세 모달에 카테고리 수정 기능 추가.
+- 미디어 파일명 변경/삭제 시 메타데이터도 함께 갱신하도록 수정.
+- 패키지 버전을 0.0.26으로 갱신.
+
 ## v0.0.25
 
 - 관리자 블록 에디터에서 빈 문단 placeholder를 마지막 보조 입력 블록에만 표시하도록 수정.