docs: BOM 품목 매핑, 수주 개소관리, 배포 가이드 문서 추가

- BOM 품목 매핑 분석 및 계획 문서
- 수주 개소(노드) 관리 계획 문서
- 배포 가이드 문서
- 수입검사 양식 변경 이력 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

plans/item-master-data-alignment-plan.md

@@ -11,10 +11,10 @@
 
 | 항목 | 내용 |
 |------|------|
-| **마지막 완료 작업** | Phase 2B 프론트엔드 검증 완료 + RM display_condition 수정 |
-| **다음 작업** | 섀도잉 정리 (재수행), Phase 3 (견적 영향 범위 설정 수정) |
-| **진행률** | Phase 1 완료, Phase 2A 롤백, Phase 2B 완료 (5/5 + 검증 + display_condition 수정) |
-| **마지막 업데이트** | 2026-01-31 |
+| **마지막 완료 작업** | 견적 영향 검증 완료 + SM/CS 프론트엔드 검증 + SM display_condition 수정 |
+| **다음 작업** | 섀도잉 정리 (재수행), SM field 108/109 드롭다운 옵션 실데이터 정비 |
+| **진행률** | Phase 1 완료, Phase 2A 롤백, Phase 2B 완료 (5/5 + 검증 + RM/SM display_condition 수정 + 견적 검증) |
+| **마지막 업데이트** | 2026-02-03 |
 
 ---
 
@@ -655,9 +655,13 @@ WHERE f.id IN (116, 117, 129, 131, 136) AND f.tenant_id = 287;
 |---|------|----------|----------|------|
 | 1 | FG 필드 추가 | 4개 필드 추가(id:177-180) + SM/RM options 추가 | item_fields, entity_relationships | ✅ 완료 |
 | 2 | category_id 분류 | categories 5건 추가, 780건 매핑 | categories, items | ✅ 완료 |
-| 3 | FG item_details 생성 | 18건 INSERT 필요 | item_details | ⏳ 대기 |
-| 4 | PT/SM/RM attributes 매핑 | field_key ↔ attributes JSON 키 정합성 | item_fields, items.attributes | ⏳ 대기 |
-| 5 | 섀도잉 정리 (재수행) | Phase 2A에서 롤백됨. display_condition 안전 확인 후 재수행 | entity_relationships, item_fields | ⏳ 대기 |
+| 3 | FG item_details 생성 | 18건 INSERT 완료 (Phase 2B-4) | item_details | ✅ 완료 |
+| 4 | PT/SM/RM attributes 매핑 | field_key ↔ attributes JSON 키 정합성 완료 (Phase 2B-5) | item_fields, items.attributes | ✅ 완료 |
+| 5 | 견적 시스템 영향 검증 | KyungdongFormulaHandler가 items.attributes 미참조 확인. 견적 영향 없음 | FormulaEvaluatorService | ✅ 완료 |
+| 6 | SM/CS 프론트엔드 검증 | SM: display_condition 수정 후 정상. CS: 무형상품이라 실질 영향 없음 | dev.sam.kr | ✅ 완료 |
+| 7 | RM/SM display_condition 수정 | RM id:100 + SM id:107 조건부 표시 매핑 추가 | item_fields | ✅ 완료 |
+| 8 | 섀도잉 정리 (재수행) | Phase 2A에서 롤백됨. display_condition 안전 확인 후 재수행 | entity_relationships, item_fields | ⏳ 대기 |
+| 9 | SM field 108/109 드롭다운 옵션 정비 | 현재 테스트 데이터(부자재1-1 등) → 실제 규격값으로 교체 필요 | item_fields.options | ⏳ 대기 |
 
 ---
 
@@ -679,6 +683,10 @@ WHERE f.id IN (116, 117, 129, 131, 136) AND f.tenant_id = 287;
 | 2026-01-31 | 2B-5 | attributes field_key 매핑: PT Part_type 669건(조립400/구매205/절곡64), RM 100~103 field_key 28건(SUS/EGI/원단류+규격파싱), SM 107 카테고리 61건+spec→108, CS item_name 4건 | items.attributes | ✅ |
 | 2026-01-31 | 2B-검증 | 프론트엔드 검증: FG(모델명/대분류/마감유형/설치유형 ✅), PT(Part_type→조건부필드 ✅), RM(품목명 ✅, 규격 display_condition 불일치 발견) | - | ✅ |
 | 2026-01-31 | 2B-DC | RM 필드 100 display_condition 수정: "SUS(스테인리스)"→[101,102,103], "EGI(아연도금강판)"→[101,102,103], "원단류"→[101] 추가. 기존 4개 조건 유지 | item_fields.id=100 | ✅ |
+| 2026-02-03 | 견적검증 | 견적 시스템 영향 검증 완료. KyungdongFormulaHandler(tenant_id=287)는 items.attributes 미참조. quote_items.item_id=NULL(스냅샷 저장). Phase 2B 변경이 견적 계산에 영향 없음 확인 | FormulaEvaluatorService, KyungdongFormulaHandler | ✅ |
+| 2026-02-03 | SM검증 | SM 프론트엔드 검증: 알카바(id:12565) 편집 화면에서 품목명 ✅ 표시, 규격 ❌ 미표시 (display_condition에 "알카바" 매핑 누락). field 108/109 드롭다운 옵션은 테스트 데이터(부자재1-1 등) | dev.sam.kr 프론트엔드 | ✅ |
+| 2026-02-03 | CS검증 | CS 프론트엔드 검증: 출장비(id:12860) 편집 화면에서 품목명 ✅, 규격(사양) 빈칸 (field_key=specification vs attributes.spec 불일치, 무형상품이라 실질 영향 없음) | dev.sam.kr 프론트엔드 | ✅ |
+| 2026-02-03 | SM-DC | SM 필드 107 display_condition 수정: 기존 2개(육각볼트→108, 썬더볼트→109) + 8개 추가(샤우드/앵글/알카바/컨트롤박스/기타/포장자재/방범부품/원단류→108). 알카바 편집 화면에서 규격 필드 표시 확인 ✅ | item_fields.id=107 | ✅ |
 
 ---
 
@@ -801,7 +809,9 @@ read_memory("item-data-alignment-active-symbols") // 3. 작업 대상 파악
 | FG-KSE01-벽면형-EGI 조회 | model_name=KSE01, finishing_type=EGI마감 등 표시 | 상세 뷰는 고정 레이아웃, 품목기준관리 설정에서 필드 4개 정상 등록 확인 | ⚠️ 부분 |
 | PT-가이드레일 조회 | base_price, 부품유형 등 표시 | 품목기준관리에서 Part_type 4종 options 확인 | ✅ |
 | FG BOM 표시 | 가이드레일×2, 하단마감재×1, L-BAR×2 표시 | 상세 화면에서 BOM 3건 정확히 표시 | ✅ |
-| 견적 생성 (수정 후) | 기존과 동일한 견적 금액 산출 | 수정 금지 영역 미변경 (bom/code/item_category 미접촉) | ✅ 안전 |
+| 견적 생성 (수정 후) | 기존과 동일한 견적 금액 산출 | KyungdongFormulaHandler 분석: items.attributes 미참조. quote_items.item_id=ALL NULL(스냅샷). Phase 2B 변경 영향 없음 | ✅ 확인 |
+| SM 알카바 규격 표시 | 품목명 "알카바" 선택 시 규격(field 108) 표시 | display_condition 수정 후 규격 필드 표시 ✅. 드롭다운 옵션은 테스트 데이터(별도 정비 필요) | ✅ |
+| CS 출장비 편집 | 품목명/규격 필드 표시 | 품목명 ✅, 규격(사양) 빈칸(field_key=specification vs attributes.spec, 무형상품이라 실질 영향 없음) | ✅ |
 | SM 품목 활성 여부 | `items.is_active` 컬럼 값 표시 (field_163 아님) | 품목기준관리에서 id:163 공통필드로 교체 확인, id:164 제거 | ✅ |
 | PT 품목상태 필드 | `items.is_active` 공통 필드로 통합 표시 | 기본정보/측면규격 양쪽에 id:163 연결 확인, id:105/133/138/152 제거 | ✅ |
 | FG 품목상태 필드 | `items.is_active` 공통 필드로 통합 표시 | 기본정보에 id:163 연결 확인, id:138 제거 | ✅ |
@@ -815,7 +825,9 @@ read_memory("item-data-alignment-active-symbols") // 3. 작업 대상 파악
 | FG 18개 품목이 모든 필드 정상 표시 | ⚠️ | DB 설정 완료. 상세 뷰는 고정 레이아웃이라 동적 필드 미표시 (프론트 별도) |
 | PT 부품유형별 조건부 필드 정상 작동 | ✅ | Part_type 4종 options 갱신 완료 |
 | RM/SM 드롭다운 실제 값 표시 | ✅ | RM 재질/두께/폭/길이, SM 11개 카테고리 반영 확인 |
-| 견적 금액 변동 없음 (회귀 테스트) | ✅ | 수정 금지 영역(bom/code/item_category) 미접촉 |
+| 견적 금액 변동 없음 (회귀 테스트) | ✅ | KyungdongFormulaHandler 코드 분석 + quote_items 스냅샷 구조 확인. Phase 2B 영향 없음 |
+| SM display_condition 정상 작동 | ✅ | field 107에 10개 품목명→규격필드 매핑 완료. 알카바 편집 화면에서 규격 표시 확인 |
+| CS 프론트엔드 정상 | ✅ | 무형상품(출장비/노무비 등) 편집 화면 정상. 규격 미매핑은 실질 영향 없음 |
 | 품목 목록 → 상세 → 문서 데이터 흐름 정상 | ✅ | FG 목록 18건 표시, BOM 3건 정상 |
 | is_active 중복 필드 통합 완료 (6건 → 공통필드 1개) | ✅ | SM/PT/FG 모두 id:163으로 교체 확인 |
 | null key 필드(id:152) 비활성화 | ✅ | 폼에서 미표시 확인 |