docs: [CLAUDE.md] DB 환경 설정 실제에 맞게 수정

- samdb → sam (실제 DB명 반영)
- sam-mysql-1, sam-phpmyadmin-1 컨테이너 참조 제거 (MySQL 컨테이너 폐기됨)
- DB 환경 분리 테이블 추가 (로컬Docker/로컬WSL/개발/운영 4환경)
- codebridge, sam_stat 추가 DB 연결 정보 명시
- docker-compose environment가 .env를 덮어쓰는 동작 설명 추가
This commit is contained in:
김보곤
2026-03-19 19:32:40 +09:00
parent e314a46f42
commit 9fd3dacd20

View File

@@ -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 명령어 실행