From 89226629eb58a74b20a6940425e09106099fbdb0 Mon Sep 17 00:00:00 2001
From: pro <lightone2017@codebridge-x.com>
Date: Thu, 22 Jan 2026 08:18:13 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20Docker=20=ED=99=98=EA=B2=BD=20=ED=95=84?=
 =?UTF-8?q?=EC=88=98=20=EC=9D=B8=EC=A7=80=20=EA=B7=9C=EC=B9=99=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 CLAUDE.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 1ec30bb..d824550 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -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를 통해 실행