docs: [features] 기초자료 복사 기능 + 2차 가공물 부품 코드 표시 문서화

This commit is contained in:
김보곤
2026-03-21 11:56:47 +09:00
parent 13907d07f1
commit 93c0e2815c

View File

@@ -205,6 +205,7 @@ BD-RS-24 가이드레일 SUS 마감재 2438mm
| **등록** | 분류코드 드롭다운 선택 → 순번(`.nnn`) 자동 채번 |
| **조회** | 코드/기본정보/전개도/이미지 표시 |
| **수정** | 코드 편집 가능 (저장 시 중복 검사) |
| **복사** | 현재 항목을 복제 — 코드 자동 채번 + 이미지 복사 |
| **삭제** | Soft delete |
### 5.3 코드 관련 동작
@@ -227,6 +228,36 @@ BD-RS-24 가이드레일 SUS 마감재 2438mm
- 같은 코드 유지 → 중복 검사 건너뜀
- 자기 자신은 중복에서 제외
#### 복사 시
1. 수정/조회 화면에서 **복사** 버튼 클릭
2. 확인 다이얼로그 후 API 호출 (`POST /api/v1/bending-items/{id}/duplicate`)
3. **같은 분류코드의 다음 번호 자동 채번** (예: `.027`까지 있으면 → `.028`)
4. **R2 이미지 파일도 함께 복사** (R2 내 파일 복사 + 새 File 레코드 생성)
5. 복사 완료 후 새 항목의 **수정 화면**으로 자동 이동
6. "복사 완료 — 새 코드: BD-CL.028" 성공 메시지 표시
복사되는 항목:
- 기본정보 (품명, 대분류, 분류, 재질, 규격 등)
- 전개도 데이터 (`bending_data` JSON)
- options (검색어, 메모 등)
- 전개도 이미지 (R2 파일 복사)
### 5.4 2차 가공물 부품 코드 표시
가이드레일/케이스/하단마감재 상세 화면의 '절곡 부품 조합' 섹션에 각 부품의 **기초자료 품목코드**가 표시된다.
```
순서:1 BD-RS.011 1번(마감제) 재질: SUS 1.2T 수량: 2
순서:2 BD-RM.009 2번(본체) 재질: EGI 1.55T
순서:3 BD-RC.005 3번(벽면형-C) 재질: EGI 1.55T
순서:4 BD-RD.004 4번(벽면형-D) 재질: EGI 1.55T
```
- `components[].sam_item_id``bending_items.id``bending_items.code` 매핑
- API Resource에서 `item_code` 필드로 자동 주입
- 조회/수정 모드 모두 회색 배지로 표시
---
## 6. API 엔드포인트
@@ -239,6 +270,7 @@ BD-RS-24 가이드레일 SUS 마감재 2438mm
| POST | `/api/v1/bending-items` | 등록 (자동 채번) | 필수 |
| GET | `/api/v1/bending-items/{id}` | 상세 조회 | 필수 |
| PUT | `/api/v1/bending-items/{id}` | 수정 (코드 중복 검사) | 필수 |
| POST | `/api/v1/bending-items/{id}/duplicate` | 복사 (자동 채번 + 이미지 복사) | 필수 |
| DELETE | `/api/v1/bending-items/{id}` | 삭제 | 필수 |
> 화이트리스트: `ApiKeyMiddleware`의 `allowWithoutAuth`에 등록 필요 (Bearer 토큰 없이 API Key + X-TENANT-ID로 접근)