docs: 경동기업 마이그레이션 Phase 1.0 문서 업데이트
- kd-items-migration-plan.md 체크리스트 업데이트 - 변경 내용 요약 문서 추가 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
69
changes/20260128_kd_items_migration_phase1.md
Normal file
69
changes/20260128_kd_items_migration_phase1.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# 변경 내용 요약 - 경동기업 품목/단가 마이그레이션 Phase 1.0
|
||||
|
||||
**날짜:** 2026-01-28
|
||||
**작업자:** Claude Code
|
||||
**관련 문서:** docs/plans/kd-items-migration-plan.md
|
||||
|
||||
## 📋 변경 개요
|
||||
|
||||
경동기업(tenant_id=287) 레거시 DB(chandj)에서 SAM DB(samdb)로 품목/단가 데이터 마이그레이션을 위한 Seeder 생성
|
||||
|
||||
## 📁 추가된 파일
|
||||
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| `api/database/seeders/Kyungdong/KyungdongItemSeeder.php` | 경동기업 품목/단가 마이그레이션 Seeder |
|
||||
|
||||
## 🔧 상세 변경 사항
|
||||
|
||||
### 1. KyungdongItemSeeder.php 생성
|
||||
|
||||
**기능:**
|
||||
- chandj.KDunitprice (601건) → samdb.items 마이그레이션
|
||||
- items 기반 → samdb.prices 마이그레이션
|
||||
- 기존 tenant_id=287 데이터 삭제 후 재생성
|
||||
|
||||
**주요 로직:**
|
||||
```php
|
||||
// item_div → item_type 매핑
|
||||
'[제품]' => 'FG' // 완제품
|
||||
'[상품]' => 'FG' // 완제품
|
||||
'[반제품]' => 'PT' // 부품
|
||||
'[부재료]' => 'SM' // 부자재
|
||||
'[원재료]' => 'RM' // 원자재
|
||||
'[무형상품]' => 'CS' // 소모품
|
||||
```
|
||||
|
||||
**발견된 이슈 및 해결:**
|
||||
- 레거시 DB의 `is_deleted` 컬럼이 `0`이 아닌 `NULL`로 활성 상태 표시
|
||||
- `where('is_deleted', 0)` → `whereNull('is_deleted')` 수정
|
||||
|
||||
## ✅ 실행 방법
|
||||
|
||||
```bash
|
||||
# Docker 컨테이너 내부에서 실행
|
||||
docker exec sam-api-1 php artisan db:seed --class="Database\\Seeders\\Kyungdong\\KyungdongItemSeeder"
|
||||
|
||||
# 또는 Docker 환경에서 직접 실행
|
||||
cd /var/www/html && php artisan db:seed --class="Database\\Seeders\\Kyungdong\\KyungdongItemSeeder"
|
||||
```
|
||||
|
||||
## 📊 예상 결과
|
||||
|
||||
| 테이블 | 작업 | 예상 건수 |
|
||||
|--------|------|----------|
|
||||
| items | DELETE (기존) | ~10,472건 |
|
||||
| items | INSERT (신규) | ~601건 |
|
||||
| prices | DELETE (기존) | ~86건 |
|
||||
| prices | INSERT (신규) | ~601건 |
|
||||
|
||||
## ⚠️ 주의사항
|
||||
|
||||
1. **기존 데이터 삭제됨**: tenant_id=287의 모든 items, prices 삭제
|
||||
2. **실행 전 백업 권장**: 중요 데이터는 백업 후 실행
|
||||
3. **Docker 환경 필수**: chandj DB 연결은 Docker 내부에서만 가능 (sam-mysql-1 호스트명)
|
||||
|
||||
## 🔗 관련 문서
|
||||
|
||||
- [kd-items-migration-plan.md](../plans/kd-items-migration-plan.md) - 전체 마이그레이션 계획
|
||||
- [kd-orders-migration-plan.md](../plans/kd-orders-migration-plan.md) - 입고/재고/주문 마이그레이션 (연관)
|
||||
1251
plans/kd-items-migration-plan.md
Normal file
1251
plans/kd-items-migration-plan.md
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user