From ac551d2c30e35e18c0dadf0de1aba6117779bf67 Mon Sep 17 00:00:00 2001 From: hskwon Date: Fri, 19 Dec 2025 16:04:31 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Phase=206.1=20=EC=95=85=EC=84=B1?= =?UTF-8?q?=EC=B1=84=EA=B6=8C=20=EC=B6=94=EC=8B=AC=EA=B4=80=EB=A6=AC=20?= =?UTF-8?q?=EC=9E=91=EC=97=85=20=ED=98=84=ED=99=A9=20=EC=97=85=EB=8D=B0?= =?UTF-8?q?=EC=9D=B4=ED=8A=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CURRENT_WORKS.md | 80 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) diff --git a/CURRENT_WORKS.md b/CURRENT_WORKS.md index f63fcee..02d524d 100644 --- a/CURRENT_WORKS.md +++ b/CURRENT_WORKS.md @@ -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 개발 ### 작업 목표