본문 이미지 최적화 및 백필 보정

docs/history.md

@@ -1,5 +1,17 @@
 # 의사결정 이력
 
+## 2026-07-01 v1.10.7 — 본문 이미지는 720px와 1600px를 함께 제공한다
+
+본문 이미지가 모두 1600px 표시용 WebP만 사용하면 모바일 화면이나 갤러리 작은 셀에서도 필요 이상의 이미지를 내려받을 수 있다. 원본은 라이트박스용으로 유지하고, 공개 본문 표시에는 720px와 1600px WebP를 `srcset`으로 함께 제공해 브라우저가 화면 폭에 맞는 파일을 고르게 한다. 기존 게시물은 백필 명령이 두 파생 이미지의 누락 여부를 함께 확인하도록 정리한다.
+
+## 2026-07-01 v1.10.6 — 운영 백필은 NAS 호스트 npm에 의존하지 않는다
+
+NAS 배포는 Docker 이미지 안에서 Node 런타임을 실행하므로 호스트에 npm이 없을 수 있다. 이미지 백필 역시 호스트 npm 명령이 아니라 `sh` 래퍼가 실행 중인 앱 컨테이너의 Node로 처리해야 운영 절차와 맞다. 또한 Nuxt 빌드 산출물에는 source repository 파일이 그대로 포함되지 않으므로, 백필 스크립트는 DB를 직접 조회하고 운영 이미지의 `.output/server` 아래에 필요한 최소 스크립트와 이미지 유틸만 포함하는 방식으로 정리한다.
+
+## 2026-07-01 v1.10.5 — 기존 본문 이미지는 백필 명령으로 일괄 전환한다
+
+본문 표시용 WebP 이미지는 새로 저장되는 게시물에는 자동 생성되지만, 운영 DB에 이미 있는 게시물까지 관리자 화면에서 개별 처리하는 것은 글 수가 늘수록 비현실적이다. 따라서 기존 게시물 본문을 스캔해 누락된 `thumbs/*-body.webp`만 생성하는 백필 명령을 별도로 두고, 운영에서는 배포 후 필요할 때 한 번 실행하는 방식으로 정리한다.
+
 ## 2026-07-01 v1.10.3 — 공개 목록 페이지네이션은 직접 이동을 기본으로 한다
 
 이전/다음만 있는 페이지네이션은 글이 수십 개씩 추가되는 기간에 원하는 구간으로 이동하기 어렵다. 공개 게시물 목록과 태그 목록은 서버 페이지네이션을 이미 사용하므로, UI는 처음·끝 페이지와 현재 위치 주변 번호를 보여 주고 중간 구간은 `...`으로 접는 방식으로 바꾼다. 모바일에서는 번호가 많을 때 한 줄 가로 스크롤을 허용해 레이아웃 깨짐을 피한다.