docs: [equipment] 사진 API 스펙 업데이트 (GCS→R2)

- 프론트엔드 요청 문서: 사진 업로드 API 상세 스펙 추가
- multipart/form-data files[] 배열 형식 명시
- 검증 규칙, Request/Response 예시 추가
- GCS 언급을 Cloudflare R2로 수정
- features/equipment README 동일 수정
This commit is contained in:
김보곤
2026-03-12 13:47:48 +09:00
parent fa85bd388a
commit 9c17850782
2 changed files with 87 additions and 8 deletions

View File

@@ -355,15 +355,19 @@ equipment/
### 5.5 설비 사진
- 최대 10장
- 업로드 시 자동 압축 (MNG에서 구현, API에서는 `File` 모델 연동)
- GCS(Google Cloud Storage)에 저장
- 최대 10장 (설비당)
- Cloudflare R2에 저장 (`Storage::disk('r2')`)
- 저장 경로: `{tenantId}/equipment/{year}/{month}/{storedName}`
- 다중 업로드 지원 (`files[]` multipart/form-data)
- 허용 확장자: jpg, jpeg, png, gif, bmp, webp (최대 10MB/파일)
- 삭제 시 soft delete (`softDeleteFile()`) 적용
- MNG는 GCS + 자동 압축, API는 R2 직접 저장
### 5.6 엑셀 Import (MNG 전용)
- 한글/영문 헤더 자동 매핑
- 중복 처리: skip 또는 overwrite 선택
- 엑셀 내 이미지(Drawing) 자동 추출 후 GCS 업로드
- 엑셀 내 이미지(Drawing) 자동 추출 후 저장 (MNG: GCS, API: R2 예정)
- API에서는 미구현 (Phase 2+ 검토)
---