110 lines
4.0 KiB
Markdown
110 lines
4.0 KiB
Markdown
# 품목관리 BOM 트리 기능 개선
|
|
|
|
**날짜:** 2026-03-18
|
|
**작업자:** Claude Code
|
|
|
|
## 변경 개요
|
|
|
|
품목관리 화면의 BOM(Bill of Materials) 트리 기능을 전면 개선하여 3단계 계층 구조(FG → 카테고리 → PT)로 표시하고, 수식 산출 결과를 BOM으로 저장하는 기능을 추가했다.
|
|
|
|
---
|
|
|
|
## 수정된 파일
|
|
|
|
| 파일 | 변경 내용 |
|
|
|------|----------|
|
|
| `mng/app/Services/ItemManagementService.php` | `saveBomFromFormula()`, `getBendingBomTree()` 메서드 추가, `buildBomNode()` 카테고리 그룹 노드 생성 |
|
|
| `mng/app/Http/Controllers/Api/Admin/ItemManagementApiController.php` | `saveBom()`, `bendingBomTree()` 엔드포인트 추가 |
|
|
| `mng/routes/api.php` | `POST /{id}/save-bom`, `GET /bending-bom-tree` 라우트 추가 |
|
|
| `mng/resources/views/item-management/index.blade.php` | BOM 탭 통합, 3단계 트리 UI, BOM 저장 버튼 |
|
|
|
|
---
|
|
|
|
## 상세 변경 사항
|
|
|
|
### 1. BOM 탭 통합
|
|
|
|
- 기존 "정적 BOM" + "절곡 BOM" 2개 탭 → **"BOM"** 단일 탭으로 통합
|
|
- "수식 산출" 탭은 FG 품목 선택 시에만 표시 (기존 유지)
|
|
- FG 선택 시 수식 산출 탭으로 자동 전환하지 않음 (현재 탭 유지)
|
|
|
|
### 2. BOM 트리 3단계 구조
|
|
|
|
BOM 데이터에 `category` 필드가 있으면 자동으로 중간 그룹 노드를 생성한다:
|
|
|
|
```
|
|
▼ FG KSS02 스크린 SUS마감 측면형
|
|
▼ 주자재 (1건)
|
|
PT 스크린 실리카 x10.65
|
|
▼ 모터 (1건)
|
|
PT 모터 150K(S) (220V) x1
|
|
▼ 절곡품 (9건)
|
|
PT 케이스 500*380 x3.22
|
|
...
|
|
▼ 부자재 (4건)
|
|
PT 감기샤프트 5인치 6m x1
|
|
...
|
|
```
|
|
|
|
- chevron 아이콘 기반 접힘/펼침 토글
|
|
- 카테고리 노드 회색 배경, 건수 표시
|
|
- 절곡 품목(SF-BND) amber 배경 강조
|
|
- 품목 코드는 hover 시에만 표시
|
|
|
|
### 3. 수식 산출 → BOM 저장
|
|
|
|
수식 산출 결과 합계 옆에 **"BOM 저장"** 버튼을 추가했다:
|
|
|
|
- 클릭 시 산출된 전체 품목을 FG의 `bom` JSON 필드에 저장
|
|
- 저장 데이터 구조: `[{child_item_id, child_item_code, quantity, unit, category}]`
|
|
- 저장 후 자동으로 BOM 탭 전환 + 트리 표시
|
|
|
|
### 4. FG 18건 BOM 일괄 등록
|
|
|
|
tenant 287(프론트_테스트회사)의 FG 품목 18건에 수식 산출(W:3000, H:3000) 결과를 BOM으로 일괄 저장했다. 각 FG에 17건의 PT 품목이 BOM으로 등록되었다.
|
|
|
|
---
|
|
|
|
## API 엔드포인트
|
|
|
|
| Method | Path | 설명 |
|
|
|--------|------|------|
|
|
| `POST` | `/api/admin/items/{id}/save-bom` | 수식 산출 결과를 FG BOM으로 저장 |
|
|
| `GET` | `/api/admin/items/bending-bom-tree` | 절곡 품목 트리 조회 |
|
|
|
|
### 5. 개발서버 배포 시 401 오류 해결
|
|
|
|
개발서버에서 수식 산출 시 401 인증 오류가 발생했다. 두 가지 원인:
|
|
|
|
**원인 1: MNG `.env` API 연결 설정 오류**
|
|
- `API_BASE_URL`이 운영 API(`api.codebridge-x.com`)를 가리키고 있었음
|
|
- 개발서버는 자기 자신의 도메인을 DNS로 해석하지 못하므로 `API_INTERNAL_URL=https://127.0.0.1` 설정 추가
|
|
- `API_BASE_URL`은 Host 헤더용, `API_INTERNAL_URL`은 실제 연결용
|
|
|
|
**원인 2: API 미들웨어 화이트리스트 미배포**
|
|
- `api/app/Http/Middleware/ApiKeyMiddleware.php`에 `api/v1/quotes/calculate/*` 화이트리스트를 추가한 커밋이 개발서버에 푸시되지 않았음
|
|
- MNG만 푸시하고 API는 누락 → Bearer 토큰 없이 호출 시 401 발생
|
|
- API도 함께 `git push origin develop` 실행하여 해결
|
|
|
|
> **교훈**: MNG에서 API 서버를 호출하는 기능 개발 시, API 프로젝트의 미푸시 커밋도 함께 확인하여 배포해야 한다.
|
|
|
|
---
|
|
|
|
## API 엔드포인트
|
|
|
|
| Method | Path | 설명 |
|
|
|--------|------|------|
|
|
| `POST` | `/api/admin/items/{id}/save-bom` | 수식 산출 결과를 FG BOM으로 저장 |
|
|
| `GET` | `/api/admin/items/bending-bom-tree` | 절곡 품목 트리 조회 |
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
- `rules/item-policy.md` — 품목 정책
|
|
- `features/quotes/README.md` — 견적 시스템, BOM 계산
|
|
|
|
---
|
|
|
|
**최종 업데이트**: 2026-03-18
|