Item Backend (부품 마스터 서비스) MSA 기반 재고관리 시스템의 Item(부품 마스터) 도메인 서비스입니다. 부품의 등록·조회·수정·상태 변경을 담당합니다. 기술 스택 구분 기술 Language Java 25 Framework Spring Boot 4.0.6 Persistence Spring Data JPA, PostgreSQL API 문서 springdoc-openapi (Swagger UI 5.32.6) API 목록 Base URL: /api/items # Method Endpoint 기능 1 GET /api/items 부품 목록 조회 (필터·정렬·페이지네이션) 2 GET /api/items/{sku} 부품 단건 조회 3 POST /api/items 부품 추가 4 PUT /api/items/{sku} 부품 수정 5 PATCH /api/items/{sku}/state 부품 상태 변경 (활성/비활성) 6 GET /api/items/categories 카테고리 목록 조회 7 GET /api/items/units 단위 목록 조회 8 POST /api/items/batch 부품 복수 조회 에러 코드 정리 code status 의미 COMMON_INVALID_INPUT 400 입력 검증 실패 COMMON_BAD_REQUEST 4xx 기타 잘못된 요청 (fallback) COMMON_INTERNAL_ERROR 500 미처리 서버 오류 ITEM_NOT_FOUND 404 부품 없음 ITEM_SKU_DUPLICATED 409 SKU 중복 ITEM_INVALID_PRICE 422 단가 비즈니스 규칙 위반