232 lines
8.0 KiB
Markdown
232 lines
8.0 KiB
Markdown
# 절곡 재공품 품목코드 체계
|
|
|
|
> **작성일**: 2026-03-21
|
|
> **상태**: 설계 확정
|
|
|
|
---
|
|
|
|
## 1. 개요
|
|
|
|
### 1.1 목적
|
|
|
|
절곡 바라시 기초자료(1차 가공물)에 **의미 기반 고유 품목코드**를 부여하여, 재공품 관리 및 2차 가공물(가이드레일/케이스 등)과의 매핑을 체계화한다.
|
|
|
|
### 1.2 재공품과의 관계
|
|
|
|
재공품(WIP)은 유휴 시간을 활용하여 **가장 많이 나가는 정형화된 부품**을 미리 생산하는 것이다. 모든 절곡 형상을 재공품으로 관리하는 것이 아니라, 수요가 높은 **표준 형상**만 재공품 코드로 관리한다.
|
|
|
|
기초자료는 이 표준 형상을 정의하는 동시에, 주문에 따라 **표준을 수정한 변형 형상**도 관리한다.
|
|
|
|
### 1.3 핵심 원칙
|
|
|
|
- 품목코드는 **고유키(Unique Key)** — 중복 불가
|
|
- 날짜 정보 미포함 — LOT 번호와 명확히 구분
|
|
- 코드만으로 분류(종류+재질 계열) 식별 가능
|
|
- `BD-XX`까지 재공품과 공통, 그 뒤 구분자(`.` vs `-`)로 구분
|
|
|
|
---
|
|
|
|
## 2. 코드 형식
|
|
|
|
### 2.1 기초자료 (1차 가공물 — 형상 정의)
|
|
|
|
```
|
|
BD-{분류코드} ← 해당 분류에 1건일 때
|
|
BD-{분류코드}.{순번} ← 해당 분류에 다수일 때
|
|
```
|
|
|
|
| 세그먼트 | 설명 | 예시 |
|
|
|----------|------|------|
|
|
| `BD` | Bending 접두사 (고정) | `BD` |
|
|
| 분류코드 | 부품 종류+재질 계열 (2자리) | `RS`, `CP`, `CX` |
|
|
| `.nnn` | 변형 번호 (점 구분자, 3자리, 001~999) | `.001`, `.027` |
|
|
|
|
**예시:**
|
|
```
|
|
BD-CL 케이스 린텔 — 표준 형상 (재공품 BD-CL-30 등의 기준)
|
|
BD-CL.001 케이스 린텔 — 변형 1번 (주문 수정)
|
|
BD-CL.002 케이스 린텔 — 변형 2번
|
|
BD-RS 가이드레일 SUS 마감재 — 표준 형상
|
|
BD-RS.001 가이드레일 SUS 마감재 — 변형 1번
|
|
```
|
|
|
|
> **표준 형상** (`BD-XX`): 재공품으로 미리 생산하는 가장 많이 나가는 정형화된 부품
|
|
> **변형** (`BD-XX.nnn`): 주문에 따라 표준 형상을 수정한 절곡도 (최대 999종)
|
|
|
|
### 2.2 재공품 (WIP 품목 — 길이 포함)
|
|
|
|
```
|
|
BD-{분류코드}-{길이코드}
|
|
```
|
|
|
|
| 세그먼트 | 설명 | 예시 |
|
|
|----------|------|------|
|
|
| `BD` | Bending 접두사 (기초자료와 공통) | `BD` |
|
|
| 분류코드 | 기초자료와 동일 (2자리) | `CL`, `RS` |
|
|
| `-길이코드` | 원자재 길이 (하이픈 구분자) | `-30` (3000mm) |
|
|
|
|
**예시:**
|
|
```
|
|
BD-CL-30 케이스 린텔 3000mm
|
|
BD-RS-24 가이드레일 SUS 마감재 2438mm
|
|
```
|
|
|
|
### 2.3 기초자료 vs 재공품 코드 구분
|
|
|
|
| 구분 | 구분자 | 형식 | 의미 |
|
|
|------|:------:|------|------|
|
|
| 기초자료 (표준) | 없음 | `BD-CL` | 표준 절곡 형상 (길이 무관) |
|
|
| 기초자료 (변형) | 점 (`.`) | `BD-CL.001` | 주문 수정 형상 (최대 999종) |
|
|
| 재공품 | 하이픈 (`-`) | `BD-CL-30` | 표준 형상 + 길이 (고유 품목) |
|
|
|
|
> **핵심**: `BD-CL`까지 공통, 그 뒤 구분자가 다름.
|
|
> - 기초자료는 **절곡 형상만** 정의 (길이 정보 없음)
|
|
> - 재공품은 **형상 + 길이**로 고유 품목 (변종 시 새 코드 부여)
|
|
> - 기초자료 `BD-CL` = 재공품 `BD-CL-30`, `BD-CL-24` 등의 **기준 형상**
|
|
|
|
---
|
|
|
|
## 3. 분류코드 정의
|
|
|
|
### 3.1 가이드레일 부품 (R 계열)
|
|
|
|
| 코드 | 부품명 | 주재질 | 현재 건수 |
|
|
|------|--------|--------|:---------:|
|
|
| `RS` | SUS 마감재 | SUS 1.2T | 25 |
|
|
| `RM` | 본체/보강 | EGI 1.55T | 12 |
|
|
| `RC` | C형 | EGI 1.55T | 11 |
|
|
| `RD` | D형 | EGI 1.55T | 7 |
|
|
| `RE` | 측면 마감재 | EGI/SUS | 11 |
|
|
| `RT` | 절단판 | — | 3 |
|
|
| `RH` | 뒷보강 | — | 1 |
|
|
| `RN` | 비인정 | — | 1 |
|
|
|
|
### 3.2 케이스 부품 (C 계열)
|
|
|
|
| 코드 | 부품명 | 주재질 | 현재 건수 |
|
|
|------|--------|--------|:---------:|
|
|
| `CP` | 밑면판/점검구 | EGI 1.55T | 44 |
|
|
| `CF` | 전면판 | EGI 1.55T | 34 |
|
|
| `CB` | 후면 코너/후면부 | EGI 1.55T | 28 |
|
|
| `CL` | 린텔 | EGI 1.55T | 27 |
|
|
| `CX` | 상부 덮개 | EGI 1.55T | 27 |
|
|
|
|
### 3.3 하단마감재 부품 (B/T 계열)
|
|
|
|
| 코드 | 부품명 | 주재질 | 현재 건수 |
|
|
|------|--------|--------|:---------:|
|
|
| `BS` | 하장바 (SUS) | SUS 1.5T | 4 |
|
|
| `BE` | 하장바 (EGI) | EGI 1.55T | 1 |
|
|
| `BH` | 보강평철 | EGI 1.15T | 1 |
|
|
| `TS` | 철재 하장바 (SUS) | SUS | 3 |
|
|
| `TE` | 철재 하장바 (EGI) | EGI | 2 |
|
|
|
|
### 3.4 기타
|
|
|
|
| 코드 | 부품명 | 현재 건수 |
|
|
|------|--------|:---------:|
|
|
| `XE` | 마구리 | 12 |
|
|
| `LE` | L-BAR | 2 |
|
|
| `ZP` | 특수 밑면/점검구 | 5 |
|
|
| `ZF` | 특수 전면판 | 3 |
|
|
| `ZB` | 특수 후면 | 1 |
|
|
|
|
---
|
|
|
|
## 4. 2계층 구조
|
|
|
|
절곡품은 **원자재 → 1차 가공물 → 2차 가공물** 2계층 구조를 따른다.
|
|
|
|
```
|
|
원자재 (SUS 1.2T, EGI 1.55T 등)
|
|
↓ 절곡 가공 (바라시)
|
|
1차 가공물: bending_items (기초자료) — BD-XX-nn 코드
|
|
↓ 조립
|
|
2차 가공물: bending_models (가이드레일/케이스/하단마감재) — GR-nn 코드
|
|
```
|
|
|
|
### 4.1 테이블 관계
|
|
|
|
| 테이블 | 역할 | 코드 형식 | 건수 (2026-03) |
|
|
|--------|------|----------|:--------------:|
|
|
| `bending_items` | 1차 가공물 (부품) | `BD-XX-nn` | 265 |
|
|
| `bending_models` | 2차 가공물 (조립품) | `GR-nn` 등 | 21+ |
|
|
|
|
### 4.2 매핑 방식
|
|
|
|
`bending_models.components` JSON 배열에서 `sam_item_id`로 `bending_items.id`를 참조한다.
|
|
|
|
```json
|
|
// bending_models.components 예시 (가이드레일 KSS01)
|
|
[
|
|
{"orderNumber": 1, "sam_item_id": 1968, "itemName": "1번(마감제)", "material": "SUS 1.2T", "quantity": 2},
|
|
{"orderNumber": 2, "sam_item_id": 1976, "itemName": "2번(본체)", "material": "EGI 1.55T"},
|
|
{"orderNumber": 3, "sam_item_id": 1966, "itemName": "3번(벽면형-C)", "material": "EGI 1.55T"},
|
|
{"orderNumber": 4, "sam_item_id": 1965, "itemName": "4번(벽면형-D)", "material": "EGI 1.55T"}
|
|
]
|
|
```
|
|
|
|
---
|
|
|
|
## 5. 코드와 LOT 번호의 차이
|
|
|
|
| 항목 | 기초자료 코드 | 재공품 코드 | LOT 번호 |
|
|
|------|-------------|------------|----------|
|
|
| 목적 | 절곡 형상 정의 | 품목 식별 (형상+길이) | 생산 이력 추적 |
|
|
| 길이 정보 | 없음 | 포함 | 포함 |
|
|
| 날짜 정보 | 없음 | 없음 | 포함 |
|
|
| 구분자 | 점 (`.`) | 하이픈 (`-`) | — |
|
|
| 예시 | `BD-CL.03` | `BD-CL-30` | `CL6318-30` |
|
|
| 변경 여부 | 변경 불가 | 변경 불가 (고유) | 생산 시 생성 |
|
|
|
|
---
|
|
|
|
## 6. 신규 부품 등록 시 코드 부여 규칙
|
|
|
|
API가 분류코드(`BD-XX`)를 받으면 자동으로 채번한다:
|
|
|
|
1. **해당 분류 첫 등록**: `BD-XX` — 표준 형상
|
|
2. **변형 등록**: `BD-XX.001` — 표준 대비 수정된 형상
|
|
3. **이후 변형**: `BD-XX.002`, `BD-XX.003`, ... (마지막 +1 자동)
|
|
4. **최대 999종**: `BD-XX.999`까지
|
|
|
|
```
|
|
표준 등록: BD-CL (표준 형상, 재공품 기준)
|
|
변형 1: BD-CL.001 (주문 수정)
|
|
변형 2: BD-CL.002 (또 다른 수정)
|
|
```
|
|
|
|
> 표준 형상 `BD-XX`는 이미 존재할 때, 변형만 추가 등록된다. 표준 자체가 변경되지 않는다.
|
|
|
|
---
|
|
|
|
## 7. 마이그레이션 이력
|
|
|
|
| 날짜 | 작업 | 비고 |
|
|
|------|------|------|
|
|
| 2026-03-21 (1차) | 기존 코드(날짜 포함) → `BD-XX-nn` 형식 변환 | 265건 |
|
|
| 2026-03-21 (2차) | `BD-XX-nn` → `BD-XX.nn` 형식 변환 | 재공품 코드와 구분자 분리 |
|
|
| 2026-03-21 (3차) | `BD-XX.nn` → `BD-XX.nnn` 3자리 변형번호 | 999종 변형 수용 |
|
|
|
|
### 이전 코드 형식 (폐기)
|
|
|
|
```
|
|
❌ CX250722-06 (접두사 + 날짜 + 순번) — LOT 번호와 혼동
|
|
❌ BD-CX-06 (하이픈 구분 2자리) — 재공품 BD-CX-30과 혼동
|
|
❌ BD-CX.06 (점 구분 2자리) — 변형 수용량 99종 한계
|
|
✅ BD-CX.006 (점 구분 3자리) — 변형 999종, 재공품과 구분 명확
|
|
✅ BD-CX (표준 형상) — 재공품 BD-CX-길이의 기준
|
|
```
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
- [changes/20260321_bending_api_internal_url_fix.md](../changes/20260321_bending_api_internal_url_fix.md) — 절곡품 API 연동 수정
|
|
- `api/app/Models/BendingItem.php` — 1차 가공물 모델
|
|
- `api/app/Models/BendingModel.php` — 2차 가공물 모델
|
|
|
|
---
|
|
|
|
**최종 업데이트**: 2026-03-21
|