docs: Docker 환경 필수 인지 규칙 추가

- 로컬 개발 환경이 Docker 기반임을 명시
- Docker 컨테이너 구조 설명
- php artisan, composer 등 명령어는 docker exec로 실행
- 체크리스트 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
pro
2026-01-22 08:18:13 +09:00
parent a28a4ef2f2
commit 89226629eb

View File

@@ -53,3 +53,49 @@
| `/home/aweso/sam/api` | API 서버 (Laravel) | 독립 저장소 |
**각 폴더는 독립적인 Git 저장소입니다. 해당 폴더에서 git 명령을 실행해야 합니다.**
---
## Docker 환경 (필수 인지)
> **중요: 로컬 개발 환경은 Docker 기반입니다!**
### 왜 Docker를 통해 실행하나?
PHP, Laravel, Node.js 등이 **Docker 컨테이너 안에** 설치되어 있습니다.
로컬 PC(WSL)에는 이런 도구들이 없으므로, 반드시 Docker 컨테이너를 통해 실행해야 합니다.
```
로컬 PC (WSL)
└── Docker
├── sam-mng-1 ← PHP + Laravel (MNG 앱)
├── sam-api-1 ← PHP + Laravel (API 앱)
├── sam-mysql-1 ← MySQL DB
└── sam-nginx-1 ← Nginx 웹서버
```
### Docker 명령어 패턴
```bash
# MNG 앱에서 artisan 명령 실행
docker exec sam-mng-1 php artisan <명령어>
# API 앱에서 artisan 명령 실행
docker exec sam-api-1 php artisan <명령어>
# 예시: 시더 실행
docker exec sam-mng-1 php artisan db:seed --class=MngMenuSeeder
# 예시: 마이그레이션 실행
docker exec sam-mng-1 php artisan migrate
# 예시: 캐시 클리어
docker exec sam-mng-1 php artisan cache:clear
```
### 체크리스트 (명령 실행 시)
- [ ] `php artisan` 명령 → `docker exec sam-mng-1 php artisan` 사용
- [ ] `composer` 명령 → `docker exec sam-mng-1 composer` 사용
- [ ] DB 시더 실행 필요 시 → Docker를 통해 실행
- [ ] 마이그레이션 필요 시 → Docker를 통해 실행