docs: 경동기업 마이그레이션 Phase 1.0 문서 업데이트

- kd-items-migration-plan.md 체크리스트 업데이트
- 변경 내용 요약 문서 추가

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-01-28 19:22:25 +09:00
parent 3b6e97dadc
commit 3ec8206bab
2 changed files with 1320 additions and 0 deletions

View 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) - 입고/재고/주문 마이그레이션 (연관)

File diff suppressed because it is too large Load Diff