diff --git a/CLAUDE.md b/CLAUDE.md index 5aa91f85..e044f6f9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -169,6 +169,27 @@ ### 현재 파일 현황 ## 데이터베이스 아키텍처 (필수 규칙) > **codebridge 서버 분리 이후, MNG는 자체 DB 마이그레이션을 관리합니다.** +> **2026-03-17~**: 로컬 MySQL 컨테이너 폐기. 모든 환경에서 개발서버 DB(`sam`)를 사용한다. + +### DB 환경 분리 + +| 환경 | DB명 | 호스트 | 포트 | 계정 | 접속 방식 | +|------|------|--------|------|------|----------| +| 로컬 (Docker) | `sam` | `114.203.209.83` | `3306` | `codebridge` | docker-compose environment로 개발서버 직접 연결 | +| 로컬 (WSL) | `sam` | `127.0.0.1` | `3307` | `codebridge` | SSH 터널 경유 (`3307→개발서버:3306`) | +| 개발 서버 | `sam` | `127.0.0.1` | `3306` | `codebridge` | localhost 직접 | +| 운영 서버 | `sam_prod` | `127.0.0.1` | `3306` | — | localhost 직접 | + +> **주의**: Docker 컨테이너 내부에서는 `docker-compose.yml`의 `environment:` 섹션이 `.env` 파일의 DB 설정을 **덮어씀**. +> `.env`의 `DB_HOST=127.0.0.1`, `DB_PORT=3307`은 Docker 밖(WSL 직접 접속)에서만 유효하다. + +### 추가 DB 연결 (`config/database.php`) + +| Connection | DB명 | 환경변수 | 용도 | +|------------|------|---------|------| +| `mysql` (기본) | `sam` | `DB_*` | SAM 메인 DB | +| `codebridge` | `codebridge` | `CODEBRIDGE_DB_*` (미설정 시 메인 DB 호스트/계정 공유) | 코드브릿지엑스 내부 관리 | +| `sam_stat` | `sam_stat` | `STAT_DB_*` (개발서버만 명시 설정) | 통계/알림 전용 | ### 핵심 원칙 @@ -237,9 +258,8 @@ ### 기본 Docker 컨테이너 ```bash sam-mng-1 # Laravel MNG 앱 sam-api-1 # Laravel API 앱 -sam-mysql-1 # MySQL 데이터베이스 sam-nginx-1 # Nginx 웹서버 -sam-phpmyadmin-1 # phpMyAdmin +# MySQL 컨테이너 없음 — 개발서버 DB 직접 사용 (2026-03-17~) ``` ### Artisan 명령어 실행