docs: [bending] 절곡품 관리 개발 완료 상태 업데이트

- step1: 데이터 임포트 완료 (170+60건), artisan 커맨드 7개 실행 결과
- step2: API 12개 엔드포인트 완료, item_category 필수 필터 추가
- step3: MNG 샘플 완료 (4개 메뉴, 이미지 473건)
- step4: React 구현 가이드 전면 작성 (API 응답 구조, 컴포넌트 설계, 실무 노트)
- 코드 체계 변경 불가 사유, 265vs170 차이 설명, 운영 전 정리 항목 추가
This commit is contained in:
강영보
2026-03-17 11:33:47 +09:00
parent 828b452186
commit fbd0510cc1
5 changed files with 564 additions and 91 deletions

View File

@@ -1,7 +1,8 @@
# Step 2: API 엔드포인트
# Step 2: API 엔드포인트 ✅ 완료
> **프로젝트**: API (`sam/api`)
> **선행 조건**: Step 1 완료
> **상태**: ✅ 구현 완료 (2026-03-16~17)
> **참조**: `standards/api-rules.md`, `standards/options-column-policy.md`, `rules/item-policy.md`
---
@@ -58,21 +59,41 @@
?item_sep=스크린 # 대분류
&item_bending=가이드레일 # 중분류
&material=SUS # 재질 (부분 매칭)
&model_UA=인정 # 인정여부
&model_UA=인정 # 인정여부
&search=KSS01 # 통합 검색 (이름/검색어/규격)
&page=1&size=50 # 페이지네이션 (size — api-rules 기준)
```
### 2-2. 절곡품 모델 관리 (합)
### 2-2. 절곡품 모델 관리 (가이드레일/케이스/하단마감재 통합)
| Method | Path | 설명 | 비고 |
|--------|------|------|------|
| GET | `/api/v1/guiderail-models` | 모델 목록 (타입별) | ?type=가이드레일 |
| GET | `/api/v1/guiderail-models` | 모델 목록 | `?item_category=` 필수 |
| GET | `/api/v1/guiderail-models/filters` | 필터 옵션 | |
| GET | `/api/v1/guiderail-models/{id}` | 모델 상세 (부품 조합 + 재질별 폭합) | |
| POST | `/api/v1/guiderail-models` | 모델 등록 | |
| PUT | `/api/v1/guiderail-models/{id}` | 모델 수정 | |
| DELETE | `/api/v1/guiderail-models/{id}` | 모델 삭제 (soft delete) | |
**카테고리 구분** (필수 파라미터):
| item_category | 메뉴 | 건수 | 코드 패턴 |
|--------------|------|:---:|---------|
| `GUIDERAIL_MODEL` | 가이드레일 | 20 | `GR-KSS01-벽면형-SUS` |
| `SHUTTERBOX_MODEL` | 케이스 | 30 | `SB-500*350-밑면` |
| `BOTTOMBAR_MODEL` | 하단마감재 | 10 | `BB-KSS01-SUS` |
**필터 파라미터** (GET /api/v1/guiderail-models):
```
?item_category=GUIDERAIL_MODEL # 필수: 카테고리 구분
&item_sep=스크린 # 대분류
&model_UA=인정 # 인정여부
&check_type=벽면형 # 형상 (가이드레일만)
&model_name=KSS01 # 모델명
&search=KSS01 # 통합 검색
&page=1&size=50
```
---
## 3. 구현 파일 구조