# D3RO Voice — NAS Docker Deployment Guide

D3RO Voice의 클라우드 백엔드 및 관리자 백오피스를 Synology, QNAP, Linux NAS에 Docker로 배포하는 빠른 안내입니다.

## 🚀 빠른 시작 (3단계)

### 1단계: 배포 패키지 생성 (개발 PC)
```powershell
# Windows
.\scripts\deploy-nas.ps1

# Linux / Mac
./scripts/deploy-nas.sh
```
`out/nas-package/` 폴더에 `d3ro-voice-api.tar`, `docker-compose.yml`, `.env`, `nas-control.sh`가 생성됩니다.

### 2단계: NAS에 배포 및 실행
`out/nas-package/`의 모든 파일을 NAS의 작업 폴더(예: `/volume1/docker/d3ro`)에 복사한 후 실행합니다:
```bash
cd /volume1/docker/d3ro
docker load < d3ro-voice-api.tar
docker compose up -d
```

### 3단계: 접속 및 설정
- 🌐 **메인 포털**: `http://<NAS_IP>:5000/`
- ⚙️ **관리자 백오피스**: `http://<NAS_IP>:5000/admin` (첫 가입자에게 최고 관리자 권한 자동 부여)
- 📖 **API 문서**: `http://<NAS_IP>:5000/swagger`
- 🩺 **헬스체크**: `http://<NAS_IP>:5000/health`

---

## 🛠️ NAS 제어 스크립트 (`nas-control.sh`)
- `./nas-control.sh start` — 서비스 시작
- `./nas-control.sh stop` — 서비스 중지
- `./nas-control.sh status` — 상태 및 헬스체크 확인
- `./nas-control.sh logs` — 실시간 로그 조회
- `./nas-control.sh backup` — SQLite DB 및 설정 백업 (tar.gz)
- `./nas-control.sh update <새파일.tar>` — 컨테이너 업데이트 및 재시작

자세한 시놀로지/큐냅 GUI 설정 가이드는 [docs/deployment/nas-deployment-guide.md](docs/deployment/nas-deployment-guide.md)를 참고하세요.