v1.4.3: 관리자 UI·홈·미디어 개선

- 관리자 라이트 테마 격리, 대시보드 활성 링크, 로그인 우측 정렬
- 대시보드 통계 추이 차트·툴팁, 홈 Latest/Featured 보정
- 미디어 종류·미사용 필터, 비디오 프레임 썸네일
- NAS 운영 업데이트 절차 문서 추가

docs/deploy.md

@@ -147,6 +147,45 @@ sh scripts/migrate-production-db.sh baseline
 sh scripts/migrate-production-db.sh migrate
 ```
 
+### 운영 업데이트 (코드 반영)
+
+이미 한 번 올려 둔 NAS에서 **새 커밋을 받아 반영**할 때는 보통 아래 순서를 따른다. 최초 설치 절차와 달리 `git clone`은 하지 않는다.
+
+```bash
+# 프로젝트 루트로 이동 (경로는 NAS 환경에 맞게 조정)
+cd /volume1/docker/projects/apps/sori.studio
+
+# 원격 저장소 최신 코드 받기
+git pull
+
+# DB 스키마 변경이 포함된 배포면 미적용 SQL만 적용 (npm 없이 실행 가능)
+sh scripts/migrate-production-db.sh status
+sh scripts/migrate-production-db.sh migrate
+
+# 앱 이미지 재빌드 후 컨테이너 재기동
+docker compose --env-file .env.production up -d --build
+```
+
+| 단계 | 설명 |
+|------|------|
+| `git pull` | 애플리케이션·Dockerfile·`db/migrations` 등 Git에 있는 변경을 받는다. |
+| `migrate` | `db/migrations/`에 새 SQL이 있으면 운영 DB에만 적용한다. 스키마 변경이 없으면 생략해도 된다. |
+| `up -d --build` | Nuxt 프로덕션 빌드가 Docker 이미지 안에서 수행되므로, **NAS 호스트에 Node/npm이 없어도** 앱 코드 반영이 가능하다. |
+
+주의:
+
+- `.env.production`은 Git에 포함하지 않는다. `git pull`로 덮어쓰이지 않는다. 값을 바꿀 때만 파일을 직접 수정한다.
+- `public/uploads/` 업로드 파일은 Docker 볼륨(`./public/uploads`)에 있으므로, **이미지 파일만 추가·수정한 경우** 앱 재빌드 없이도 URL로 바로 보인다.
+- 로컬에서 미리 확인하려면 `npm run verify` 후 NAS에서 위 명령을 실행하면 된다.
+
+컨테이너만 재시작하고 이미지는 그대로 두려면(환경 변수만 바꾼 경우 등):
+
+```bash
+docker compose --env-file .env.production up -d
+```
+
+코드 변경 없이 `.env.production`만 수정했다면 `--build` 없이 `up -d`만으로 충분하다.
+
 ### Docker 네트워크 충돌 대응
 
 NAS에 Docker 컨테이너가 많이 실행 중이면 `could not find an available, non-overlapping IPv4 address pool` 오류가 날 수 있다. 이 프로젝트는 기본 `DOCKER_SUBNET=10.250.50.0/24`를 사용한다. 해당 대역도 NAS 내부망 또는 다른 Docker 네트워크와 겹치면 `.env.production`에서 예를 들어 아래처럼 바꾼 뒤 다시 실행한다.