hskwon
c63e676257
- FK 제약조건 현황 분석 완료: 8개 마이그레이션에서 15+개 FK 식별 - 중요도별 테이블 분류 (핵심/중요/일반) 및 안전한 제거 전략 수립 - 코드 영향도 분석: Eloquent 관계가 FK 독립적으로 작동하여 코드 수정 불필요 주요 변경사항: - Phase 1: classifications.tenant_id, departments.parent_id FK 제거 - Phase 2: estimates.model_set_id, estimate_items.estimate_id FK 제거 - Phase 3: product_components.material_id FK 제거 (신중한 검토 필요) - 각 단계별 동적 FK 탐지, 상세 로깅, 완전 롤백 기능 포함 - 성능 인덱스 유지/추가로 쿼리 성능 보장 예상 효과: - 견적 시스템 및 분류 관리 성능 향상 - 부서 구조 변경 및 자재 관리 유연성 증가 - FK 제약 에러 감소로 개발 생산성 향상 - 시스템 확장 시 스키마 변경 유연성 확보 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
93 lines
4.0 KiB
Markdown
93 lines
4.0 KiB
Markdown
# SAM API 저장소 작업 현황
|
|
|
|
## 2025-09-24 (화) - FK 제약조건 최적화 및 데이터베이스 성능 개선
|
|
|
|
### 주요 작업
|
|
- 데이터베이스 FK 제약조건 분석 및 최적화
|
|
- 성능과 관리 편의성을 위한 비중요 FK 제거
|
|
- 3단계 점진적 FK 제거 마이그레이션 구현
|
|
|
|
### 추가된 파일:
|
|
- `database/migrations/2025_09_24_214146_remove_non_critical_foreign_keys_phase1.php` - 1차 FK 제거 (Classifications, Departments)
|
|
- `database/migrations/2025_09_24_214200_remove_estimate_foreign_keys_phase2.php` - 2차 FK 제거 (견적 시스템)
|
|
- `database/migrations/2025_09_24_214300_remove_material_foreign_key_phase3.php` - 3차 FK 제거 (제품-자재 관계)
|
|
- `CURRENT_WORKS.md` - 저장소별 작업 현황 추적
|
|
|
|
### 수정된 파일:
|
|
- `CLAUDE.md` - CURRENT_WORKS.md 파일 위치 규칙 명확화
|
|
- `database/migrations/2025_09_24_000002_create_dynamic_estimate_fields.php` - level 컬럼 제거로 마이그레이션 오류 해결
|
|
|
|
### 작업 내용:
|
|
|
|
#### 1. FK 제약조건 현황 분석
|
|
- 현재 8개 마이그레이션에서 FK 제약조건 사용 확인
|
|
- 권한 관리, 제품/자재 관리, 견적 시스템, 기타 시스템별 분류
|
|
- 총 15+개의 FK 제약조건 식별
|
|
|
|
#### 2. 중요도별 테이블 분류
|
|
**🔴 핵심 테이블 (FK 유지 필수):**
|
|
- 인증/권한 시스템: users, roles, permissions 관계
|
|
- 제품/BOM 관리 핵심: products.category_id, product_components 내부 관계
|
|
- 멀티테넌트 핵심: 모든 tenant_id 참조
|
|
|
|
**🟡 중요 테이블 (FK 선택적 유지):**
|
|
- 견적 시스템: estimates, estimate_items 관계
|
|
- 자재 관리: product_components.material_id
|
|
|
|
**🟢 일반 테이블 (FK 제거 권장):**
|
|
- 분류/코드 관리: classifications.tenant_id
|
|
- 부서 관리: departments.parent_id (자기참조)
|
|
- 감사 로그: 모든 audit 관련 FK
|
|
|
|
#### 3. 코드 영향도 분석 결과
|
|
**✅ 중요 결론: 모델/컨트롤러/서비스 코드 수정 불필요!**
|
|
- Laravel Eloquent 관계가 FK 제약조건과 독립적으로 작동
|
|
- 현재 코드가 CASCADE 동작에 의존하지 않음
|
|
- BelongsToTenant 트레잇과 소프트 딜리트로 무결성 관리
|
|
- 비즈니스 로직이 애플리케이션 레벨에서 처리됨
|
|
|
|
#### 4. 3단계 점진적 FK 제거 전략
|
|
|
|
**Phase 1 (즉시 적용 가능):**
|
|
- `classifications.tenant_id` → `tenants`
|
|
- `departments.parent_id` → `departments` (자기참조)
|
|
- 영향도: 낮음, 관리 편의성 증가
|
|
|
|
**Phase 2 (견적 시스템):**
|
|
- `estimates.model_set_id` → `categories`
|
|
- `estimate_items.estimate_id` → `estimates`
|
|
- 영향도: 중간, 성능 향상 효과
|
|
- 멀티테넌트 보안 FK는 유지
|
|
|
|
**Phase 3 (신중한 검토 필요):**
|
|
- `product_components.material_id` → `materials`
|
|
- 영향도: 중간, 자재 관리 유연성 증가
|
|
- 핵심 제품 관계 FK는 유지
|
|
|
|
#### 5. 마이그레이션 특징
|
|
- 동적 FK 이름 탐지로 안전한 제거
|
|
- 성능을 위한 인덱스 유지/추가
|
|
- 상세한 진행 상황 로깅
|
|
- 완전한 롤백 기능
|
|
- 각 단계별 영향도와 주의사항 문서화
|
|
|
|
### 데이터베이스 마이그레이션 상태:
|
|
- 기존 마이그레이션 오류 해결 완료 (level 컬럼 이슈)
|
|
- 새로운 FK 제거 마이그레이션 3개 생성
|
|
- 롤백 가능한 안전한 구조로 설계
|
|
|
|
### 예상 효과:
|
|
1. **성능 향상**: 견적 시스템과 분류 관리에서 FK 검증 오버헤드 제거
|
|
2. **관리 편의성**: 부서 구조 변경, 자재 관리 시 유연성 증가
|
|
3. **개발 생산성**: 데이터 변경 시 FK 제약 에러 감소
|
|
4. **확장성**: 향후 시스템 확장 시 유연한 스키마 변경 가능
|
|
|
|
### 향후 작업:
|
|
1. Phase 1 마이그레이션 개발 서버 테스트
|
|
2. 각 단계별 성능 영향 모니터링
|
|
3. Service 레벨에서 데이터 무결성 검증 로직 보강 검토
|
|
4. 프로덕션 적용 전 백업 및 롤백 계획 수립
|
|
|
|
### Git 커밋:
|
|
- `cfd4c25` - fix: categories 테이블 level 컬럼 제거로 마이그레이션 오류 해결
|
|
- `7dafab3` - docs: CURRENT_WORKS.md 파일 위치 규칙 명확화 |