feat: [attendance] attendance_requests 마이그레이션 MNG에 추가

- API 운영 배포 중지 기간 동안 MNG에서 마이그레이션 관리
- Schema::hasTable() 가드로 중복 실행 방지
- CLAUDE.md DB 아키텍처 정책 업데이트
This commit is contained in:
김보곤
2026-02-27 09:24:04 +09:00
parent 8f6911121c
commit cb0bc1a545
2 changed files with 77 additions and 24 deletions

View File

@@ -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()` 가드로 충돌 없음
---