PostgreSQL 데이터 계층 추가

docs/deploy.md

@@ -34,6 +34,7 @@ npm install
 # 개발 환경 변수 설정
 cp .env.example .env.development
 # .env.development 파일에 개발 DB 연결 정보 입력
+# 로컬 DB 컨테이너를 호스트에서 접근할 때는 127.0.0.1:43119 사용
 
 # 개발 서버 실행 (127.0.0.1:43117)
 npm run dev
@@ -71,9 +72,10 @@ cd sori.studio
 # 운영 환경 변수 설정
 cp .env.example .env.production
 # .env.production 파일에 운영 DB 연결 정보와 APP_PORT=43118 입력
+# Docker 내부 앱에서 PostgreSQL에 접근할 때는 sori-studio-db:5432 사용
 
 # Docker 빌드 및 실행
-docker-compose up -d
+docker compose --env-file .env.production up -d
 ```
 
 ### 프로덕션 빌드 (NAS에서)
@@ -92,6 +94,7 @@ docker run -d -p 3000:3000 sori.studio:latest
 - 로컬 개발: 43117
 - NAS Docker 외부: 43118
 - 컨테이너 내부: 3000
+- PostgreSQL 외부: 43119
 - HTTPS: 3001 (SSL 설정 시)
 
 ---
@@ -100,9 +103,12 @@ docker run -d -p 3000:3000 sori.studio:latest
 
 - 로컬 개발: `.env.development`의 `DATABASE_URL`
 - NAS 운영: `.env.production`의 `DATABASE_URL`
+- 로컬 개발 예시: `postgres://sori_studio:비밀번호@127.0.0.1:43119/sori_studio`
+- NAS Docker 예시: `postgres://sori_studio:비밀번호@sori-studio-db:5432/sori_studio`
 - 개발 DB와 운영 DB는 반드시 별도 인스턴스 또는 별도 데이터베이스로 분리
 - 운영 DB는 로컬 개발 서버에서 직접 연결하지 않음
 - 관리 도구: CloudBeaver 등으로 추후 연결 가능하게 설계
+- NAS Docker 배포 시 PostgreSQL 초기 스키마는 `db/migrations/`의 SQL로 생성
 
 ## 사용자 액션 필요 항목