환경 설정
환경 목록
| 환경 | Base URL | 설명 |
|---|---|---|
| Production | https://www.nabi-jam.com/api | 운영 서버 |
| Staging | https://stg.nabi-jam.com/api | 스테이징 서버 |
| Local | http://localhost:8080/api | 로컬 개발 |
도메인 주의
nabi-jam.com(www 없이)은 www.nabi-jam.com으로 301 리다이렉트됩니다. POST 요청 시 body가 유실되므로 반드시 www.nabi-jam.com을 사용하세요.
설정 파일
| 파일 | 용도 |
|---|---|
application.yml | 공통 설정 (카카오 알림톡, Slack, Discord 등) |
application-local.yml | 로컬 개발 (DB 직접 연결) |
application-stg.yml | 스테이징 (환경변수 참조) |
application-prod.yml | 운영 (환경변수 참조) |
Context Path
모든 API 엔드포인트는 /api 접두사를 가집니다.
server.servlet.context-path=/api
배포
| 브랜치 | 대상 환경 | 트리거 |
|---|---|---|
stg | 스테이징 | push 시 자동 |
main | 운영 | push 시 자동 |
- CI/CD: GitLab CI/CD + Harbor (Docker Registry)
- 배포 방식: Blue-Green (무중단)
- 인프라: Docker Compose + Nginx upstream 전환
주요 외부 서비스
| 서비스 | 용도 |
|---|---|
| PostgreSQL | 메인 데이터베이스 |
| Redis Sentinel | 세션 저장소, 예약 상태 관리, Pub/Sub |
| 토스페이먼츠 | 결제 승인/취소, 가상계좌 |
| 카카오 알림톡 (NCP SENS) | 결제 완료, 이용 종료 알림 |
| 네이버 스마트플레이스 | 예약 동기화 (크롤러) |
| HomeAssistant | 도어락 제어, 카메라 스냅샷 |
| Discord Bot | 배터리/초과체류 알림 |
| Slack Webhook | 예외/운영 알림 |