관리자 기능과 태그 표시 설정 추가

docs/deploy.md

@@ -1,6 +1,6 @@
 # 배포 가이드
 
-> 현재 프로젝트는 Nuxt 3 초기 스캐폴딩 상태다. Docker 설정은 초안이며 운영 DB 확정 후 NAS에서 검증한다.
+> 현재 프로젝트는 Nuxt 3 초기 스캐폴딩 상태다. Docker 설정은 파일 기준 초안이 있으며 운영 DB 확정 후 NAS에서 검증한다.
 
 ## 빌드 유형
 
@@ -15,7 +15,7 @@
 
 ### 필수 조건
 
-- Node.js 20+ 권장
+- Node.js 22 LTS 권장
 - npm 9+
 - 개발 DB
 
@@ -42,6 +42,27 @@ openssl rand -hex 32
 npm run dev
 ```
 
+### 로컬 개발 DB
+
+로컬 개발 DB는 Docker Compose의 `sori-studio-db` 서비스만 실행한다.
+
+```bash
+# Docker daemon 시작
+colima start
+
+# 개발 DB 컨테이너 실행
+ENV_FILE=.env.development docker compose --env-file .env.development up -d sori-studio-db
+
+# 개발 DB 마이그레이션 실행
+npm run db:migrate:dev
+
+# DB 준비 상태 확인
+docker exec sori-studio-db pg_isready -U sori_studio -d sori_studio
+
+# 시드 데이터 확인
+docker exec sori-studio-db psql -U sori_studio -d sori_studio -c 'SELECT count(*) AS posts_count FROM posts;'
+```
+
 ### 확인 주소
 
 - 개발 서버: http://127.0.0.1:43117
@@ -51,7 +72,7 @@ npm run dev
 
 ## UGREEN NAS Docker 배포
 
-> Dockerfile과 docker-compose 설정은 아직 작성 전이다.
+> Dockerfile과 docker-compose 설정은 초안이며 NAS 운영 환경에서는 아직 검증 전이다.
 
 ### SSH 접속
 
@@ -114,6 +135,8 @@ docker run -d -p 3000:3000 sori.studio:latest
 - 운영 DB는 로컬 개발 서버에서 직접 연결하지 않음
 - 관리 도구: CloudBeaver 등으로 추후 연결 가능하게 설계
 - NAS Docker 배포 시 PostgreSQL 초기 스키마는 `db/migrations/`의 SQL로 생성
+- 로컬 개발 Docker Compose 실행 시 `ENV_FILE=.env.development`와 `--env-file .env.development`를 함께 사용
+- 로컬 개발 DB 마이그레이션은 `npm run db:migrate:dev`로 실행
 
 ## 사용자 액션 필요 항목