docs: Phase 6.1 악성채권 추심관리 작업 현황 업데이트

This commit is contained in:
2025-12-19 16:04:31 +09:00
parent c0af888bed
commit ac551d2c30

View File

@@ -1,5 +1,85 @@
# SAM API 작업 현황
## 2025-12-19 (목) - Phase 6.1 악성채권 추심관리 API 개발
### 작업 목표
- `docs/plans/erp-api-development-plan-d1.0-changes.md` Phase 6.1 악성채권 추심관리
- 악성채권 CRUD, 서류 첨부, 메모 관리 API 구현
### 생성된 마이그레이션 (3개)
| 파일명 | 설명 |
|--------|------|
| `2025_12_19_160001_create_bad_debts_table.php` | 악성채권 테이블 |
| `2025_12_19_160002_create_bad_debt_documents_table.php` | 악성채권 서류 테이블 |
| `2025_12_19_160003_create_bad_debt_memos_table.php` | 악성채권 메모 테이블 |
### 생성된 모델 (3개)
**app/Models/BadDebts/BadDebt.php:**
- 악성채권 모델 (BelongsToTenant, SoftDeletes)
- 상태: collecting(추심중), legal_action(법적조치), recovered(회수완료), bad_debt(대손처리)
- Relations: client(), assignedUser(), creator(), documents(), memos()
**app/Models/BadDebts/BadDebtDocument.php:**
- 서류 모델 (document_type: business_license, tax_invoice, additional)
- Relations: badDebt(), file()
**app/Models/BadDebts/BadDebtMemo.php:**
- 메모 모델
- Relations: badDebt(), creator()
### 생성된 서비스 (1개)
**app/Services/BadDebtService.php:**
- CRUD: index, show, store, update, destroy
- 토글: toggle (is_active)
- 요약: summary (상태별 통계)
- 서류: addDocument, removeDocument
- 메모: addMemo, removeMemo
### 생성된 FormRequest (4개)
| 파일명 | 설명 |
|--------|------|
| `StoreBadDebtRequest.php` | 등록 (client_id, amount, status, assigned_user_id 등) |
| `UpdateBadDebtRequest.php` | 수정 (선택적 필드) |
| `StoreBadDebtDocumentRequest.php` | 서류 첨부 (document_type, file_id) |
| `StoreBadDebtMemoRequest.php` | 메모 추가 (content) |
### 생성된 컨트롤러 (1개)
**app/Http/Controllers/Api/V1/BadDebtController.php:**
- index, summary, store, show, update, destroy, toggle
- addDocument, removeDocument, addMemo, removeMemo
### API 라우트 (11개)
| Method | Endpoint | 설명 |
|--------|----------|------|
| GET | /v1/bad-debts | 목록 |
| POST | /v1/bad-debts | 등록 |
| GET | /v1/bad-debts/summary | 요약 통계 |
| GET | /v1/bad-debts/{id} | 상세 |
| PUT | /v1/bad-debts/{id} | 수정 |
| DELETE | /v1/bad-debts/{id} | 삭제 |
| PATCH | /v1/bad-debts/{id}/toggle | 활성화 토글 |
| POST | /v1/bad-debts/{id}/documents | 서류 첨부 |
| DELETE | /v1/bad-debts/{id}/documents/{documentId} | 서류 삭제 |
| POST | /v1/bad-debts/{id}/memos | 메모 추가 |
| DELETE | /v1/bad-debts/{id}/memos/{memoId} | 메모 삭제 |
### Swagger 문서
**app/Swagger/v1/BadDebtApi.php:**
- BadDebt, BadDebtDocument, BadDebtMemo 스키마
- 모든 엔드포인트 문서화 완료
### Git 커밋
- `c0af888` feat: Phase 6.1 악성채권 추심관리 API 구현
---
## 2025-12-18 (수) - 가지급금 관리 API 개발
### 작업 목표