미디어 사용 현황 표시 추가

docs/history.md

@@ -1,5 +1,13 @@
 # 의사결정 이력
 
+## 2026-05-01 v0.0.16
+
+### 미디어 사용처 표시와 삭제 보호 결정
+
+미디어 라이브러리에서 파일명 변경과 삭제를 제공하면, 해당 이미지가 글 본문이나 대표 이미지에 사용 중인지 먼저 보여줘야 한다. 현재 콘텐츠는 이미지 URL을 게시물/페이지의 `content`와 `featuredImage`에 직접 저장하므로, 사용 중인 파일을 변경하거나 삭제하면 공개 화면의 이미지가 깨진다.
+
+따라서 1차 사용처 추적은 게시물과 페이지를 대상으로 본문, 대표 이미지 위치를 표시한다. 사용 중인 미디어의 파일명 변경과 삭제는 차단하고, 미사용 파일만 정리할 수 있도록 한다. 프로필이나 사이트 설정 이미지는 아직 해당 데이터 모델이 없으므로 설정 기능 구현 시 사용처 추적에 추가한다.
+
 ## 2026-05-01 v0.0.15
 
 ### 미디어 라이브러리 1차 범위 결정

docs/spec.md

@@ -250,7 +250,9 @@ components/content/
 - 로컬 개발 업로드 파일은 `public/uploads/posts/YYYY/MM/` 아래 저장하고 `/uploads/posts/YYYY/MM/filename` URL로 제공한다.
 - 관리자 미디어 화면은 업로드 이미지 목록, 검색, 파일명 변경, 개별 삭제를 제공한다.
 - 글쓰기 미디어 선택 창은 업로드 미디어 목록에서 이미지를 선택해 단일 이미지 또는 갤러리에 삽입한다.
-- 향후 미디어 라이브러리는 카테고리 분류와 이미지 사용처 추적을 제공한다.
+- 미디어 사용 현황은 게시물/페이지의 대표 이미지와 본문 내 URL을 기준으로 표시한다.
+- 사용 중인 미디어는 저장된 콘텐츠 URL이 깨지지 않도록 파일명 변경과 삭제를 차단한다.
+- 향후 미디어 라이브러리는 카테고리 분류와 프로필/사이트 설정 이미지 사용처 추적을 제공한다.
 
 ---
 

docs/todo.md

@@ -15,7 +15,7 @@
 - [ ] 사이트 설정
 - [ ] 메뉴/네비게이션 관리
 - [ ] 미디어 라이브러리 카테고리 분류
-- [ ] 미디어 라이브러리 이미지 사용처 추적
+- [ ] 미디어 라이브러리 프로필/사이트 설정 이미지 사용처 추적
 
 ## 3차 관리자 개발
 

docs/update.md

@@ -1,5 +1,13 @@
 # 업데이트 이력
 
+## v0.0.16
+
+- 관리자 미디어 목록에 게시물/페이지 사용 현황 표시 추가.
+- 미디어 사용처를 대표 이미지와 본문 위치로 구분해 표시.
+- 사용 중인 미디어의 파일명 변경과 삭제를 차단하도록 수정.
+- 미디어 검색 대상에 사용 중인 게시물/페이지 제목 추가.
+- 패키지 버전을 0.0.16으로 갱신.
+
 ## v0.0.15
 
 - 관리자 블록 에디터 `/` 메뉴 항목 제목 색상을 진한 본문색으로 수정.