docs:데이터베이스 아키텍처 규칙 추가

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
pro
2026-01-26 12:54:23 +09:00
parent 6041e4d211
commit 3d80c1307c

View File

@@ -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가 필요한 페이지