feat: [attendance] attendance_requests 마이그레이션 MNG에 추가
- API 운영 배포 중지 기간 동안 MNG에서 마이그레이션 관리 - Schema::hasTable() 가드로 중복 실행 방지 - CLAUDE.md DB 아키텍처 정책 업데이트
This commit is contained in:
58
CLAUDE.md
58
CLAUDE.md
@@ -128,42 +128,52 @@ ### Tailwind 기본 클래스는 그대로 사용
|
||||
|
||||
## 데이터베이스 아키텍처 (필수 규칙)
|
||||
|
||||
> **경고: MNG 프로젝트에서는 마이그레이션 파일을 생성하지 않습니다!**
|
||||
> **2026-02-27 정책 변경**: API/React 운영 배포 중지 기간 동안 MNG에서 마이그레이션 생성 및 실행을 허용한다.
|
||||
|
||||
### 핵심 원칙
|
||||
|
||||
| 작업 | 올바른 위치 | MNG에서 |
|
||||
|------|------------|---------|
|
||||
| 마이그레이션 생성 | `/home/aweso/sam/api/database/migrations/` | ❌ 금지 |
|
||||
| 마이그레이션 실행 | `docker exec sam-api-1 php artisan migrate` | ❌ 금지 |
|
||||
| 테이블 생성/수정 | API 프로젝트에서만 | ❌ 금지 |
|
||||
| 작업 | MNG에서 | 비고 |
|
||||
|------|---------|------|
|
||||
| 마이그레이션 생성 | ✅ 허용 | 운영 배포에 필요한 테이블 |
|
||||
| 마이그레이션 실행 | ✅ 허용 | `php artisan migrate` |
|
||||
| 모델 작성 | ✅ 허용 | |
|
||||
| 시더 | ⚠️ MNG 전용만 | MngMenuSeeder 등 |
|
||||
| 팩토리 | ❌ 금지 | |
|
||||
|
||||
### MNG database 폴더 상태
|
||||
### MNG 마이그레이션 작성 규칙
|
||||
|
||||
```
|
||||
/home/aweso/sam/mng/database/
|
||||
├── migrations/ ← 비어있음 (파일 생성 금지!)
|
||||
├── seeders/ ← MNG 전용 시더만 허용 (예: MngMenuSeeder)
|
||||
└── factories/ ← 사용 안 함
|
||||
1. API develop에 동일 마이그레이션이 있으면 **파일명을 동일하게** 유지
|
||||
2. `Schema::hasTable()` 가드 **필수** — 중복 실행 방지
|
||||
|
||||
```php
|
||||
public function up(): void
|
||||
{
|
||||
if (Schema::hasTable('table_name')) {
|
||||
return;
|
||||
}
|
||||
Schema::create('table_name', function (Blueprint $table) {
|
||||
// ...
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### MNG에서 허용되는 것
|
||||
### 마이그레이션 실행
|
||||
|
||||
- ✅ 컨트롤러, 뷰, 라우트 작성
|
||||
- ✅ 모델 작성 (API의 테이블 사용)
|
||||
- ✅ MNG 전용 시더 (MngMenuSeeder 등)
|
||||
```bash
|
||||
# 로컬 (Docker)
|
||||
docker exec sam-mng-1 php artisan migrate
|
||||
|
||||
### MNG에서 금지되는 것
|
||||
# 개발 서버
|
||||
cd /home/webservice/mng && php artisan migrate
|
||||
|
||||
- ❌ `database/migrations/` 에 파일 생성
|
||||
- ❌ `docker exec sam-mng-1 php artisan migrate` 실행
|
||||
- ❌ 테이블 구조 변경 관련 작업
|
||||
# 운영 서버 (--force 필수)
|
||||
cd /home/webservice/mng && php artisan migrate --force
|
||||
```
|
||||
|
||||
### 새 테이블이 필요할 때
|
||||
### 향후 정리
|
||||
|
||||
1. API 프로젝트에서 마이그레이션 생성
|
||||
2. `docker exec sam-api-1 php artisan migrate` 실행
|
||||
3. MNG에서 해당 테이블의 모델만 작성
|
||||
- API 운영 배포 재개 시 MNG 마이그레이션을 API로 통합 정리
|
||||
- 동일 파일명 + `Schema::hasTable()` 가드로 충돌 없음
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user