diff --git a/changes/20260318_item-management-bom-tree.md b/changes/20260318_item-management-bom-tree.md index 67b9822..e022354 100644 --- a/changes/20260318_item-management-bom-tree.md +++ b/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` | 절곡 품목 트리 조회 | + --- ## 관련 문서