sam-docs/dev/changes/20260205_sus_inspection_template.md

# 변경 내용 요약

**날짜:** 2026-02-05
**작업자:** Claude Code
**관련 계획:** docs/dev_plans/incoming-inspection-templates-plan.md

## 📋 변경 개요
5130 레거시 수입검사 양식 전환 작업 - Phase 1 완료
- 13개 수입검사 양식 생성 (id:18-30)
- 테이블 컬럼 구조 추가 (미리보기 기능 정상화)
- MNG UI 테스트 완료

## 📁 수정된 파일/데이터

### 데이터베이스 변경
- `document_templates` - 13건 INSERT (id:18-30)
- `document_template_section_fields` - 8건씩 INSERT (template_id:18-30)
- `document_template_columns` - 84건 INSERT (7개 컬럼 × 12개 템플릿 19-30)

### 문서 변경
- `docs/dev_plans/incoming-inspection-templates-plan.md` - 진행 상태 업데이트

## 🔧 상세 변경 사항

### 1. SUS 절곡판 수입검사 양식 생성 (id:19)

**생성된 데이터:**
```json
{
  "id": 19,
  "tenant_id": 287,
  "name": "SUS 절곡판 수입검사",
  "category": "수입검사",
  "title": "수입검사 성적서",
  "company_name": "경동산업",
  "footer_remark_label": "비고 / 부적합 내용",
  "footer_judgement_label": "종합판정",
  "footer_judgement_options": ["적합", "부적합"],
  "is_active": 1,
  "linked_item_ids": [14172, 14173, 14174, 14175, 14176, 14177, 14178, 14179, 14180, 14181, 14182]
}
```

### 2. 필드 구조 (EGI 양식에서 복사)

| sort_order | field_key | label | field_type |
|------------|-----------|-------|------------|
| 0 | category | 구분 | text |
| 1 | item | 검사항목 | text |
| 2 | standard | 검사 기준/범위 | text_with_criteria |
| 3 | tolerance | 공차/범위 | json_tolerance |
| 4 | method | 검사방식 | select_api |
| 5 | measurement_type | 측정유형 | select |
| 6 | frequency | 검사주기 | composite_frequency |
| 7 | regulation | 관련규정 | text |

### 3. 연결된 품목 (11건)

| ID | 품목명 |
|----|--------|
| 14172 | sus1.2*1219*2438 |
| 14173 | sus1.2*1219*3000 |
| 14174 | sus1.2t*1219*4000 |
| 14175 | sus1.5*1219*2438 |
| 14176 | sus1.5*1219*3000 |
| 14177 | sus1.5*1219*4000 |
| 14178 | sus1.2*1219*c |
| 14179 | sus1.5*1219*2500 |
| 14180 | sus1.2*1219*4230 |
| 14181 | sus1.2*1219*3000 P/L |
| 14182 | sus1.2*1219*2500 |

### 4. 테이블 컬럼 구조 추가 (템플릿 19-30)

미리보기 기능이 동작하려면 `document_template_columns` 테이블에 컬럼 정의가 필요합니다.
템플릿 18(EGI)의 컬럼 구조를 복사하여 12개 템플릿(19-30)에 적용했습니다.

| sort_order | label | column_type | width |
|------------|-------|-------------|-------|
| 0 | NO | text | 50px |
| 1 | 검사항목 | text | 120px |
| 2 | 검사기준 | text | 150px |
| 3 | 검사방식 | text | 100px |
| 4 | 검사주기 | text | 100px |
| 5 | 측정치 | complex | 240px |
| 6 | 판정 (적/부) | select | 80px |

**측정치 컬럼 sub_labels:** `["n1", "n2", "n3"]`

## ✅ 테스트 체크리스트
- [x] 양식 생성 확인 (id:18-30, 총 13개)
- [x] 필드 8개 복사 확인 (각 템플릿별)
- [x] 품목 연결 확인 (EGI, SUS 등)
- [x] MNG UI 양식 편집 테스트 ✅
- [x] **MNG UI 미리보기 테스트 ✅** (컬럼 추가 후 정상 동작)
- [ ] React resolve API 테스트

## ⚠️ 후속 작업
1. ~~EGI 양식(id:18)에 품목 연결 필요~~ → 완료
2. ~~Phase 1 나머지 양식 생성~~ → 완료 (13개 양식)
3. MNG UI에서 검사항목 데이터 입력 필요
4. React resolve API 테스트

## 🔗 관련 문서
- 계획 문서: `docs/dev_plans/incoming-inspection-templates-plan.md`
- 레거시 참조: `5130/instock/i_SUSplate.php`