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:
@@ -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. 구현 파일 구조
|
||||
|
||||
Reference in New Issue
Block a user