302 lines
12 KiB
Markdown
302 lines
12 KiB
Markdown
# 절곡품(Bending Parts) 관리 현황 분석
|
||
|
||
> **작성일**: 2026-03-16
|
||
> **분류**: 갭 분석 / 기능 비교
|
||
> **대상**: 경동기업(5130) 가이드레일 시스템 vs SAM 시스템
|
||
|
||
---
|
||
|
||
## 배경 및 질문
|
||
|
||
경동기업(5130)에는 절곡품(가이드레일) 관리 리스트가 있다.
|
||
(`5130.codebridge-x.com/guiderail/list.php`)
|
||
|
||
견적/수주를 하면 해당 제품의 가이드레일을 불러와 **이미지들을 보여주는** 역할을 하며,
|
||
개별 절곡품들을 **조합**하여 가이드레일을 구성하는 구조이다.
|
||
|
||
SAM 시스템에서도 견적(`dev.sam.kr/sales/quote-management/new`)에서 가이드레일이 나오는데,
|
||
경동기업과 같이 **절곡품 이미지를 보여주고 조합**할 수 있어야 한다.
|
||
|
||
### 구체적 질문
|
||
|
||
1. SAM의 `items` 테이블에 `BD-XX-XXX` 코드 품목들이 있는데, 경동기업 절곡품처럼 **이미지 표현과 조합 구성이 가능한 상태인가?**
|
||
2. 초기 개발 시 절곡품을 고려하지 않고 개발 후 추후 items에 밀어넣었는데, **경동기업 수준의 관리가 되고 있는가?**
|
||
3. 경동기업 절곡품 시스템과 SAM 시스템 간 **갭은 무엇인가?**
|
||
|
||
---
|
||
|
||
## 1. 경동기업(5130) 절곡품 관리 체계
|
||
|
||
### 1.1 시스템 구조
|
||
|
||
```
|
||
bending 테이블 (개별 절곡품)
|
||
├─ 품명, 대분류(스크린/철재), 중분류(가이드레일/케이스/하단마감재)
|
||
├─ 규격(120*70), 재질(SUS 1.2T), 모델명(KSS01)
|
||
├─ 인정/비인정 구분
|
||
├─ 치수 JSON (inputList), 연신율 JSON (bendingrateList)
|
||
├─ 합계 JSON (sumList), 색상 마킹 (colorList)
|
||
└─ 검색 키워드 (130x75한빛, 주일-130x70 등)
|
||
|
||
guiderail 테이블 (조합 전개도)
|
||
├─ 모델별 부품 조합 정의 (proditem1~8)
|
||
├─ 전개도 이미지 저장
|
||
└─ 견적에서 호출되어 이미지 표시
|
||
```
|
||
|
||
### 1.2 주요 기능
|
||
|
||
| 기능 | 구현 파일 | 설명 |
|
||
|------|----------|------|
|
||
| 절곡품 마스터 리스트 | `guiderail/list.php` | 22개 모델 정의, CRUD 관리 |
|
||
| 절곡품 이미지 관리 | `put_guiderail_image.php` | 이미지 업로드 + Canvas 드로잉 (`drawingTool.js`) |
|
||
| 모델별 부품 조합 | `fun_guiderail.php` | KSS01 등 모델마다 1~8개 부품 조합 (`getProductData()`) |
|
||
| 절곡품 검색 | `search_bending.php` | 대분류/규격/재질/인정여부 복합 필터 |
|
||
| 견적에서 호출 | `fetch_guiderail_detail.php` | 견적 시 해당 모델의 이미지 + 부품 표시 |
|
||
| 메타데이터 | `guiderail.json` | 22개 모델 정의 (이미지 경로, 분류, 마감 유형) |
|
||
|
||
### 1.3 모델별 부품 조합 예시 (KSS01 벽면형)
|
||
|
||
```
|
||
proditem1: ①②마감재 (SUS 1.2T, 수량2)
|
||
proditem2: ③본체 (EGI 1.55T, 수량1)
|
||
proditem3: ④벽면형-C (EGI 1.55T, 수량1)
|
||
proditem4: ⑤벽면형-D (EGI 1.55T, 수량1)
|
||
```
|
||
|
||
### 1.4 이미지 관리
|
||
|
||
- **저장 경로**: `/5130/guiderail/images/`, `/5130/bending/img/`
|
||
- **파일명 규칙**: `YYYY_MM_DD_HH_MM_SS_[모델명].png`
|
||
- **드로잉 도구**: Canvas 기반 `drawingTool.js`로 실시간 전개도 생성
|
||
|
||
### 1.5 bending 테이블 주요 컬럼
|
||
|
||
| 컬럼 | 설명 | 예시 |
|
||
|------|------|------|
|
||
| `itemName` | 품명 | 가이드레일 |
|
||
| `item_sep` | 대분류 | 스크린, 철재 |
|
||
| `item_bending` | 중분류 | 가이드레일, 케이스, 하단마감재 |
|
||
| `item_spec` | 규격 | 120*70, 120*120 |
|
||
| `material` | 재질 | SUS 1.2T, EGI 1.55T |
|
||
| `model_UA` | 인정여부 | 인정, 비인정 |
|
||
| `model_name` | 모델명 | KSS01, KWE01, KQTS01 |
|
||
| `search_keyword` | 검색어 | 130x75한빛 |
|
||
| `inputList` | 치수 JSON | [...] |
|
||
| `bendingrateList` | 연신율 JSON | [...] |
|
||
| `sumList` | 합계 JSON | [...] |
|
||
| `colorList` | 색상 마킹 JSON | [...] |
|
||
| `rail_width` | 레일 폭 | 70, 120 |
|
||
|
||
---
|
||
|
||
## 2. SAM 시스템 현재 상태
|
||
|
||
### 2.1 BD-XX-XXX 코드 체계
|
||
|
||
`BendingItemSeeder`로 ~40개 품목이 `items` 테이블에 등록되어 있다.
|
||
|
||
**코드 구조**: `BD-{PREFIX}-{LENGTH_CODE}`
|
||
|
||
| PREFIX | 용도 | 예시 |
|
||
|--------|------|------|
|
||
| RS/RE | 가이드레일 마감재 (벽면) | BD-RS-30 |
|
||
| SS/SE | 가이드레일 마감재 (측면) | BD-SS-35 |
|
||
| RM | 가이드레일 본체 (벽면) | BD-RM-42 |
|
||
| SM | 가이드레일 본체 (측면) | BD-SM-24 |
|
||
| RC/RD | 가이드레일 C형/D형 (벽면) | BD-RC-30 |
|
||
| BS/TS | 하단마감재 (SUS/철재) | BD-BS-40 |
|
||
| LA | L-Bar | BD-LA-40 |
|
||
| HH | 보강평철 | BD-HH-30 |
|
||
| CF/CL/CP/CB | 셔터박스 부품 | BD-CF-35 |
|
||
| GI | 연기차단재 | BD-GI-54 |
|
||
| XX | 하부BASE/상부덮개/마구리 (공용) | BD-XX-35 |
|
||
| YY | 별도마감 | BD-YY-30 |
|
||
|
||
**길이코드 매핑**:
|
||
|
||
| 코드 | mm | 코드 | mm |
|
||
|------|-----|------|-----|
|
||
| 12 | 1219 | 40 | 4000 |
|
||
| 24 | 2438 | 41 | 4150 |
|
||
| 30 | 3000 | 42 | 4200 |
|
||
| 35 | 3500 | 43 | 4300 |
|
||
|
||
### 2.2 items 테이블 저장 구조
|
||
|
||
```json
|
||
{
|
||
"item_type": "PT",
|
||
"item_category": "BENDING",
|
||
"code": "BD-RS-30",
|
||
"name": "가이드레일 마감재 3000mm",
|
||
"options": {
|
||
"source": "bending_item_seeder",
|
||
"lot_managed": true,
|
||
"consumption_method": "auto",
|
||
"production_source": "self_produced",
|
||
"input_tracking": true,
|
||
"prefix": "RS",
|
||
"length_code": "30",
|
||
"length_mm": 3000
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2.3 SAM에서 구현된 기능
|
||
|
||
| 기능 | 파일 | 설명 |
|
||
|------|------|------|
|
||
| 동적 BOM 생성 | `BendingInfoBuilder.php` (1172줄) | 제품코드별 자동 부품 조합 |
|
||
| Prefix 자동 결정 | `PrefixResolver.php` (300줄) | BD-코드 자동 매핑 |
|
||
| 작업지시서 절곡 표시 | `GuideRailSection` 등 (React) | 가이드레일/하단마감재/셔터박스/연기차단재 테이블 |
|
||
| 절곡 검사 (Phase 3) | `inspection-config` API | 공정 자동 판별, BOM 기반 구성품 로딩 |
|
||
| 정적 이미지 | `api/public/images/bending/` | 22개 이미지 (6개 모델 × 벽면/측면) |
|
||
| 재질 매핑 | `BendingInfoBuilder` | 제품코드별, 마감재질별 자동 결정 |
|
||
|
||
### 2.4 데이터 흐름
|
||
|
||
```
|
||
Quote (견적)
|
||
└─ calculation_inputs: { items[], bomResults[] }
|
||
↓ OrderService::store()
|
||
OrderNode (개소별)
|
||
└─ options: { product_code, bom_result }
|
||
↓ OrderService::createWorkOrders()
|
||
WorkOrder (작업지시)
|
||
└─ work_order_items[].options: {
|
||
bending_info: {
|
||
productCode, finishMaterial,
|
||
guideRail: { wall, side },
|
||
bottomBar, shutterBox, smokeBarrier
|
||
},
|
||
slat_info: { joint_bar, glass_qty }
|
||
}
|
||
↓ 프론트 렌더링
|
||
작업일지
|
||
├─ 가이드레일 (이미지 + 테이블)
|
||
├─ 하단마감재
|
||
├─ 셔터박스
|
||
└─ 연기차단재
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 갭 분석
|
||
|
||
### 3.1 핵심 갭 (경동기업에 있고 SAM에 없는 것)
|
||
|
||
#### 🔴 ① 절곡품 마스터 관리 화면
|
||
|
||
| 항목 | 경동기업(5130) | SAM |
|
||
|------|--------------|-----|
|
||
| 관리 화면 | `guiderail/list.php` — CRUD | ❌ 없음 |
|
||
| 필터링 | 대분류/규격/재질/인정여부 복합 필터 | ❌ 없음 |
|
||
| 검색 | 키워드 기반 통합 검색 | ❌ 없음 |
|
||
|
||
BD-XX-XXX 품목이 `items` 테이블에 등록만 되어 있고, **절곡품 전용 관리 화면이 없다.**
|
||
|
||
#### 🔴 ② 견적 시 가이드레일 이미지 표시
|
||
|
||
| 항목 | 경동기업(5130) | SAM |
|
||
|------|--------------|-----|
|
||
| 견적 화면 | 모델 선택 → 전개도 이미지 + 부품 조합 표시 | ❌ 이미지 미표시 |
|
||
| 호출 방식 | `fetch_guiderail_detail.php` | 해당 기능 없음 |
|
||
|
||
견적 페이지(`/sales/quote-management/new`)에서 가이드레일 선택은 되지만 **이미지가 표시되지 않는다.**
|
||
|
||
#### 🔴 ③ 절곡품 개별 전개도 데이터
|
||
|
||
| 항목 | 경동기업(5130) | SAM |
|
||
|------|--------------|-----|
|
||
| 치수 데이터 | `inputList` JSON | ❌ 없음 |
|
||
| 연신율 데이터 | `bendingrateList` JSON | ❌ 없음 |
|
||
| 합계 계산 | `sumList` JSON | ❌ 없음 |
|
||
| 색상 마킹 | `colorList` JSON | ❌ 없음 |
|
||
| 전개도 드로잉 | Canvas 기반 실시간 생성 | ❌ 없음 |
|
||
|
||
`BendingInfoBuilder`는 **조합 로직만** 있고, 개별 절곡품의 전개도 상세 데이터는 저장되지 않는다.
|
||
|
||
### 3.2 보조 갭
|
||
|
||
#### 🟡 ④ 절곡품 속성 풍부도
|
||
|
||
| 속성 | 경동기업 `bending` 테이블 | SAM `items.options` |
|
||
|------|------------------------|---------------------|
|
||
| 품명 | ✅ `itemName` | ✅ `name` |
|
||
| 대분류 | ✅ `item_sep` (스크린/철재) | ❌ 없음 |
|
||
| 중분류 | ✅ `item_bending` (가이드레일/케이스) | ❌ 없음 |
|
||
| 규격 | ✅ `item_spec` (120*70) | ❌ 없음 |
|
||
| 재질 | ✅ `material` (SUS 1.2T) | ❌ 없음 |
|
||
| 모델명 | ✅ `model_name` (KSS01) | ❌ 없음 |
|
||
| 인정여부 | ✅ `model_UA` | ❌ 없음 |
|
||
| 검색키워드 | ✅ `search_keyword` | ❌ 없음 |
|
||
| 레일 폭 | ✅ `rail_width` | ❌ 없음 |
|
||
| prefix | ❌ | ✅ `options.prefix` |
|
||
| 길이코드 | ❌ | ✅ `options.length_code` |
|
||
| 길이(mm) | ❌ | ✅ `options.length_mm` |
|
||
|
||
#### 🟡 ⑤ 이미지 업로드/드로잉 기능
|
||
|
||
| 항목 | 경동기업(5130) | SAM |
|
||
|------|--------------|-----|
|
||
| 이미지 업로드 | ✅ `put_guiderail_image.php` | ❌ 없음 |
|
||
| Canvas 드로잉 | ✅ `drawingTool.js` | ❌ 없음 |
|
||
| 이미지 저장 | 동적 생성 + 파일 저장 | 정적 파일 22개만 |
|
||
|
||
### 3.3 SAM이 우위인 부분
|
||
|
||
| 영역 | 설명 |
|
||
|------|------|
|
||
| 동적 BOM | `BendingInfoBuilder`가 제품코드별 자동 조합 (5130은 하드코딩) |
|
||
| Prefix 체계 | `PrefixResolver`로 BD-코드 자동 결정 (5130은 수동) |
|
||
| 작업지시 연동 | `work_order_items.options.bending_info`로 구조화된 데이터 전달 |
|
||
| 검사 동적 구현 | Phase 3에서 API 기반 검사 완료 (5130보다 진보적) |
|
||
| 멀티테넌시 | 테넌트별 독립 관리 가능 (5130은 단일) |
|
||
|
||
---
|
||
|
||
## 4. 종합 비교
|
||
|
||
```
|
||
경동기업(5130) SAM 시스템
|
||
───────────────────────────── ─────────────────────────────
|
||
[절곡품 마스터 관리] ─────────────→ ❌ 없음 (items에 등록만)
|
||
├─ 이미지/전개도 관리 ├─ 정적 이미지 22개만
|
||
├─ 치수/연신율 데이터 ├─ ❌ 없음
|
||
├─ 검색/필터 └─ ❌ 없음
|
||
└─ CRUD 화면
|
||
|
||
[가이드레일 조합] ───────────────→ ✅ BendingInfoBuilder (더 체계적)
|
||
├─ 모델별 부품 정의 ├─ ✅ 동적 BOM 생성
|
||
├─ 재질 자동 매핑 ├─ ✅ PrefixResolver
|
||
└─ 견적에서 이미지 표시 └─ ❌ 이미지 미표시
|
||
|
||
[절곡 검사] ─────────────────────→ ✅ Phase 3 완료 (더 진보적)
|
||
├─ 중간검사 ├─ ✅ inspection-config API
|
||
└─ 하드코딩 검사 └─ ✅ 동적 검사
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 결론
|
||
|
||
**SAM은 절곡품의 "계산과 조합"은 잘 되어 있지만, "관리와 시각화"가 빠져 있다.**
|
||
|
||
경동기업처럼 절곡품을 독립적으로 관리하고 견적에서 이미지를 보여주려면,
|
||
**절곡품 마스터 관리 기능**을 새로 구현해야 한다.
|
||
|
||
### 필요 작업 (예상)
|
||
|
||
1. **절곡품 마스터 관리 화면** — mng 또는 react에 CRUD + 필터링
|
||
2. **items.options 속성 확장** — 대분류, 중분류, 규격, 재질, 모델명 등
|
||
3. **견적 화면 이미지 연동** — 모델 선택 시 가이드레일 전개도 이미지 표시
|
||
4. **전개도 데이터 구조** — 치수/연신율/합계 JSON 저장 방안 설계
|
||
5. **이미지 업로드 기능** — 절곡품별 전개도 이미지 관리
|
||
|
||
### 관련 문서
|
||
|
||
- 통합 마스터 플랜: `docs/dev/dev_plans/integrated-master-plan.md`
|
||
- Phase 2 (절곡 분석/설계): `docs/dev/dev_plans/integrated-phase-2.md`
|
||
- Phase 3 (절곡 검사, 완료): `docs/dev/dev_plans/integrated-phase-3.md`
|
||
- 품목 정책: `docs/rules/item-policy.md` |