From 3d80c1307cc55990a57ec52b05f7fb6e8e9eb46d Mon Sep 17 00:00:00 2001
From: pro <lightone2017@codebridge-x.com>
Date: Mon, 26 Jan 2026 12:54:23 +0900
Subject: [PATCH] =?UTF-8?q?docs:=EB=8D=B0=EC=9D=B4=ED=84=B0=EB=B2=A0?=
 =?UTF-8?q?=EC=9D=B4=EC=8A=A4=20=EC=95=84=ED=82=A4=ED=85=8D=EC=B2=98=20?=
 =?UTF-8?q?=EA=B7=9C=EC=B9=99=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- MNG에서 마이그레이션 파일 생성 금지 명시
- 모든 DB 작업은 API 프로젝트에서 수행
- MNG database 폴더 상태 및 허용/금지 사항 정리

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

diff --git a/CLAUDE.md b/CLAUDE.md
index 609b4e2c..07cc8080 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -84,6 +84,49 @@ ## 프로젝트 기술 스택
 - **React 페이지**: React 18 + Babel (브라우저 트랜스파일링)
 - **Database**: MySQL 8
 
+---
+
+## 데이터베이스 아키텍처 (필수 규칙)
+
+> **경고: MNG 프로젝트에서는 마이그레이션 파일을 생성하지 않습니다!**
+
+### 핵심 원칙
+
+| 작업 | 올바른 위치 | MNG에서 |
+|------|------------|---------|
+| 마이그레이션 생성 | `/home/aweso/sam/api/database/migrations/` | ❌ 금지 |
+| 마이그레이션 실행 | `docker exec sam-api-1 php artisan migrate` | ❌ 금지 |
+| 테이블 생성/수정 | API 프로젝트에서만 | ❌ 금지 |
+
+### MNG database 폴더 상태
+
+```
+/home/aweso/sam/mng/database/
+├── migrations/     ← 비어있음 (파일 생성 금지!)
+├── seeders/        ← MNG 전용 시더만 허용 (예: MngMenuSeeder)
+└── factories/      ← 사용 안 함
+```
+
+### MNG에서 허용되는 것
+
+- ✅ 컨트롤러, 뷰, 라우트 작성
+- ✅ 모델 작성 (API의 테이블 사용)
+- ✅ MNG 전용 시더 (MngMenuSeeder 등)
+
+### MNG에서 금지되는 것
+
+- ❌ `database/migrations/` 에 파일 생성
+- ❌ `docker exec sam-mng-1 php artisan migrate` 실행
+- ❌ 테이블 구조 변경 관련 작업
+
+### 새 테이블이 필요할 때
+
+1. API 프로젝트에서 마이그레이션 생성
+2. `docker exec sam-api-1 php artisan migrate` 실행
+3. MNG에서 해당 테이블의 모델만 작성
+
+---
+
 ## HTMX 네비게이션 규칙
 
 ### HX-Redirect가 필요한 페이지