docs: [item-management] 개발서버 401 오류 해결 내용 추가

changes/20260318_item-management-bom-tree.md

@@ -72,6 +72,31 @@ tenant 287(프론트_테스트회사)의 FG 품목 18건에 수식 산출(W:3000
 | `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` | 절곡 품목 트리 조회 |
+
 ---
 
 ## 관련 문서