sam-docs/projects/5130-migration/phase-1-source-analysis/5130-item-schema.md

# 5130 품목 테이블 스키마 분석

> 분석일: 2025-12-21
> DB: chandj (MySQL 8.0)

---

## 1. 테이블 구조 개요

### 1.1 품목 관련 테이블
| 테이블 | 레코드 수 | 설명 |
|--------|----------|------|
| `models` | 18 | 제품 모델 (KSS01, KSE01 등) |
| `parts` | 37 | 모델별 부품 |
| `parts_sub` | 134 | 부품별 세부 자재 |
| `item_list` | 9 | 품목 목록 (별도 용도) |

### 1.2 계층 구조
```
models (제품 모델)
  └─ parts (부품) - model_id 참조
       └─ parts_sub (세부 자재) - part_id 참조
```

---

## 2. 테이블 상세 스키마

### 2.1 models (제품 모델)

| 필드 | 타입 | NULL | 키 | 설명 |
|------|------|------|-----|------|
| model_id | int | NO | PRI | 모델 ID |
| model_name | varchar(255) | NO | | 모델명 (KSS01, KSE01 등) |
| major_category | enum('스크린','스라트') | NO | | 대분류 |
| finishing_type | enum('SUS마감','EGI마감') | NO | | 마감 유형 |
| description | text | YES | | 설명 |
| guiderail_type | varchar(20) | YES | | 가이드레일 유형 |
| is_deleted | tinyint(1) | NO | | 삭제 여부 |
| update_log | text | YES | | 변경 이력 |
| created_at | datetime | YES | | 생성일 |
| updated_at | datetime | YES | | 수정일 |

**샘플 데이터:**
```
model_id=12, model_name='KSS01', major_category='스크린', finishing_type='SUS마감'
model_id=14, model_name='KSE01', major_category='스크린', finishing_type='SUS마감'
```

### 2.2 parts (부품)

| 필드 | 타입 | NULL | 키 | 설명 |
|------|------|------|-----|------|
| part_id | int | NO | PRI | 부품 ID |
| model_id | int | NO | MUL | 모델 ID (FK → models) |
| part_name | varchar(30) | NO | | 부품명 |
| spec | varchar(50) | YES | | 규격 (120*70 등) |
| unit | varchar(15) | YES | | 단위 (SET 등) |
| quantity | int | NO | | 수량 |
| unitprice | varchar(15) | YES | | 단가 |
| memo | text | YES | | 메모 |
| img_url | text | YES | | 이미지 URL |
| is_deleted | tinyint(1) | YES | | 삭제 여부 |
| created_at | datetime | YES | | 생성일 |
| updated_at | datetime | YES | | 수정일 |

**샘플 데이터:**
```
part_id=49, model_id=12, part_name='상부브라켓', spec='120*70', unit='SET', quantity=1
part_id=50, model_id=12, part_name='하부브라켓', spec='60*40', unit='SET', quantity=2
```

### 2.3 parts_sub (세부 자재)

| 필드 | 타입 | NULL | 키 | 설명 |
|------|------|------|-----|------|
| subpart_id | int | NO | PRI | 세부 자재 ID |
| part_id | int | NO | MUL | 부품 ID (FK → parts) |
| subpart_name | varchar(255) | NO | | 자재명 |
| quantity | int | NO | | 수량 |
| material | varchar(255) | YES | | 재질 (SUS 1.2T 등) |
| bendSum | varchar(15) | YES | | 벤딩 합계 |
| plateSum | varchar(15) | YES | | 판재 합계 |
| finalSum | varchar(15) | YES | | 최종 합계 |
| unitPrice | varchar(15) | YES | | 단가 |
| computedPrice | varchar(15) | YES | | 계산 단가 |
| lineTotal | varchar(15) | YES | | 라인 합계 |
| image_url | varchar(255) | YES | | 이미지 URL |
| is_deleted | tinyint(1) | YES | | 삭제 여부 |
| created_at | datetime | YES | | 생성일 |
| updated_at | datetime | YES | | 수정일 |

**샘플 데이터:**
```
subpart_id=64, part_id=49, subpart_name='1차(전면)', quantity=1, material='SUS 1.2T'
subpart_id=65, part_id=49, subpart_name='2차(후면)', quantity=2, material='EGI 1.55T'
```

### 2.4 item_list (품목 목록)

| 필드 | 타입 | NULL | 키 | 설명 |
|------|------|------|-----|------|
| num | int | NO | PRI | 번호 |
| item_name | varchar(100) | NO | | 품목명 |
| col13 | decimal(10,2) | YES | | 가격 |
| col60~col80 | varchar(50) | YES | | 추가 속성들 |

> ⚠️ 컬럼명이 col60~col80으로 되어 있어 의미 파악 필요

---

## 3. 관계도

```
┌─────────────────┐
│     models      │
│   (18 레코드)    │
│                 │
│ model_id (PK)   │
│ model_name      │
│ major_category  │
│ finishing_type  │
└────────┬────────┘
         │ 1:N
         ▼
┌─────────────────┐
│     parts       │
│   (37 레코드)    │
│                 │
│ part_id (PK)    │
│ model_id (FK) ──┤
│ part_name       │
│ spec            │
└────────┬────────┘
         │ 1:N
         ▼
┌─────────────────┐
│   parts_sub     │
│  (134 레코드)    │
│                 │
│ subpart_id (PK) │
│ part_id (FK) ───┤
│ subpart_name    │
│ material        │
└─────────────────┘
```

---

## 4. 데이터 특성

### 4.1 major_category (대분류)
- `스크린` (Screen)
- `스라트` (Slat)

### 4.2 finishing_type (마감 유형)
- `SUS마감` (스테인리스)
- `EGI마감` (아연도금)

### 4.3 material (재질) - parts_sub
- `SUS 1.2T`, `SUS 1.5T` (스테인리스)
- `EGI 1.55T` (아연도금)

---

## 5. 마이그레이션 고려사항

### 5.1 구조적 차이
| 5130 | SAM | 비고 |
|------|-----|------|
| 3단계 계층 (models→parts→parts_sub) | items + item_bom_items | 구조 변환 필요 |
| 단순 FK 관계 | entity_relationships 사용 | 관계 정의 방식 다름 |
| 고정 컬럼 | JSON attributes | 유연한 속성 저장 |

### 5.2 매핑 방향
1. **models** → `items` (item_type='FG', 완제품)
2. **parts** → `items` (item_type='PT', 부품)
3. **parts_sub** → `items` (item_type='RM', 원자재)
4. **parts → models 관계** → `item_bom_items` 또는 `entity_relationships`
5. **parts_sub → parts 관계** → `item_bom_items` 또는 `entity_relationships`

### 5.3 데이터 변환 필요 항목
- `major_category` → `attributes.category` 또는 별도 분류
- `finishing_type` → `attributes.finishing_type`
- `material` → `attributes.material`
- 가격 필드들 (varchar) → decimal 변환