docs: Phase 6.1 악성채권 추심관리 작업 현황 업데이트
This commit is contained in:
@@ -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 개발
|
||||
|
||||
### 작업 목표
|
||||
|
||||
Reference in New Issue
Block a user