From 990674913345092260a12845dfbc02abd8a8bc82 Mon Sep 17 00:00:00 2001 From: hskwon Date: Wed, 17 Dec 2025 22:15:00 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EB=A7=A4=EC=B6=9C/=EB=A7=A4=EC=9E=85?= =?UTF-8?q?=20=EA=B4=80=EB=A6=AC=20API=20=EC=99=84=EB=A3=8C=20=ED=91=9C?= =?UTF-8?q?=EC=8B=9C=20(5/6)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- plans/erp-api-development-plan.md | 56 +++++++++++++++++++------------ 1 file changed, 35 insertions(+), 21 deletions(-) diff --git a/plans/erp-api-development-plan.md b/plans/erp-api-development-plan.md index c7a9318..c1b1302 100644 --- a/plans/erp-api-development-plan.md +++ b/plans/erp-api-development-plan.md @@ -2,7 +2,7 @@ > **작성일**: 2025-12-17 > **기준 문서**: SAM_ERP_Storyboard_D0.8_251216 -> **상태**: 🟢 Phase 1 진행 중 (4/6 완료: 휴가 관리, 근무/출퇴근 설정, 카드/계좌 관리, 입금/출금 관리) +> **상태**: 🟢 Phase 1 진행 중 (5/6 완료: 휴가 관리, 근무/출퇴근 설정, 카드/계좌 관리, 입금/출금 관리, 매출/매입 관리) --- @@ -227,32 +227,46 @@ --- -### 2.5 매출/매입 관리 +### 2.5 매출/매입 관리 ✅ > 참조: [99-gap-analysis.md#25-매출매입-관리](../specs/erp-analysis/99-gap-analysis.md) +> **완료일**: 2025-12-17 -- [ ] **테이블 생성** - - [ ] `sales` 마이그레이션 - - [ ] `purchases` 마이그레이션 +- [x] **테이블 생성** + - [x] `sales` 마이그레이션 + - [x] `purchases` 마이그레이션 -- [ ] **모델 생성** - - [ ] `Sale` 모델 - - [ ] `Purchase` 모델 +- [x] **모델 생성** + - [x] `Sale` 모델 (BelongsToTenant, SoftDeletes) + - [x] `Purchase` 모델 (BelongsToTenant, SoftDeletes) -- [ ] **서비스 구현** - - [ ] `SaleService` 생성 - - [ ] `PurchaseService` 생성 - - [ ] 세금계산서 발행 연동 준비 +- [x] **서비스 구현** + - [x] `SaleService` 생성 (CRUD, confirm, summary) + - [x] `PurchaseService` 생성 (CRUD, confirm, summary) + - [ ] 세금계산서 발행 연동 (추후 개발) -- [ ] **API 엔드포인트** - - [ ] `GET/POST/PUT/DELETE /v1/sales` - 매출 CRUD - - [ ] `POST /v1/sales/{id}/confirm` - 매출 확정 - - [ ] `POST /v1/sales/{id}/tax-invoice` - 세금계산서 발행 - - [ ] `GET/POST/PUT/DELETE /v1/purchases` - 매입 CRUD - - [ ] `POST /v1/purchases/{id}/confirm` - 매입 확정 +- [x] **API 엔드포인트** (14개) + - [x] `GET /v1/sales` - 매출 목록 + - [x] `POST /v1/sales` - 매출 등록 + - [x] `GET /v1/sales/{id}` - 매출 상세 + - [x] `PUT /v1/sales/{id}` - 매출 수정 + - [x] `DELETE /v1/sales/{id}` - 매출 삭제 + - [x] `POST /v1/sales/{id}/confirm` - 매출 확정 + - [x] `GET /v1/sales/summary` - 매출 요약 + - [x] `GET /v1/purchases` - 매입 목록 + - [x] `POST /v1/purchases` - 매입 등록 + - [x] `GET /v1/purchases/{id}` - 매입 상세 + - [x] `PUT /v1/purchases/{id}` - 매입 수정 + - [x] `DELETE /v1/purchases/{id}` - 매입 삭제 + - [x] `POST /v1/purchases/{id}/confirm` - 매입 확정 + - [x] `GET /v1/purchases/summary` - 매입 요약 -- [ ] **Swagger 문서** - - [ ] `SaleApi.php` 작성 - - [ ] `PurchaseApi.php` 작성 +- [x] **Swagger 문서** + - [x] `SaleApi.php` 작성 + - [x] `PurchaseApi.php` 작성 + +- [ ] **테스트** + - [ ] Feature 테스트 작성 + - [ ] 수동 API 테스트 ---