docs: [vehicle] 차량 사진 API 문서 추가

- vehicle-api.md에 사진 API 3개 엔드포인트 추가 (섹션 7)
- corporate-vehicles.md에 사진 이관 현황 및 엔드포인트 추가
This commit is contained in:
김보곤
2026-03-12 22:26:40 +09:00
parent efbd74788a
commit 0e6d4e6adf
2 changed files with 138 additions and 5 deletions

View File

@@ -170,8 +170,9 @@ CorporateVehicle (1) ← (N) VehicleLog (총 주행거리 합산)
|------|:----:|------|
| DB 마이그레이션 | ✅ | `api/database/migrations/2026_02_02_220000_create_corporate_vehicles_table.php` |
| MNG UI (Blade+React) | ✅ | 운영중 |
| API REST 엔드포인트 | ❌ | 미이관 |
| API Service/Model | | 미이관 |
| API REST 엔드포인트 | ❌ | 미이관 (사진 API만 구현 완료) |
| API Service/Model | 🔶 | 사진: `VehiclePhotoService`, `CorporateVehicle` 모델 구현 완료 |
| API 차량 사진 | ✅ | `VehiclePhotoController` + `StoreVehiclePhotoRequest` 구현 완료 |
| React UI | ❌ | 미이관 |
---
@@ -187,6 +188,9 @@ POST /api/v1/corporate-vehicles 차량 등록
PUT /api/v1/corporate-vehicles/{id} 차량 수정
DELETE /api/v1/corporate-vehicles/{id} 차량 삭제 (SoftDelete)
GET /api/v1/corporate-vehicles/dropdown 차량 드롭다운 목록 (id, plate_number, model)
GET /api/v1/corporate-vehicles/{id}/photos 차량 사진 목록
POST /api/v1/corporate-vehicles/{id}/photos 차량 사진 업로드 (최대 10장)
DELETE /api/v1/corporate-vehicles/{id}/photos/{fileId} 차량 사진 삭제
```
### 필터 파라미터
@@ -205,3 +209,4 @@ GET /api/v1/corporate-vehicles/dropdown 차량 드롭다운 목록 (id, plate
3. **options 컬럼**: 현재 미적용. 이관 시 렌트/리스 전용 필드를 options JSON으로 통합 검토
4. **Auditable**: API 모델에 `Auditable` trait 적용
5. **FormRequest**: `StoreCorporateVehicleRequest`, `UpdateCorporateVehicleRequest` 분리
6. **차량 사진**: R2 저장, `document_type='corporate_vehicle'` 다형성 관계, 최대 10장, `StoreVehiclePhotoRequest` 동적 max 검증