From ae121b9be36057b176a9bb2b4d43f6e99dca8a53 Mon Sep 17 00:00:00 2001 From: hskwon Date: Thu, 18 Dec 2025 11:23:35 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Dashboard=20API=20=EA=B5=AC=ED=98=84=20?= =?UTF-8?q?=EC=99=84=EB=A3=8C=20=EA=B8=B0=EB=A1=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Phase 2 상태 업데이트 (3/3 완료) - 3.3 대시보드 항목 완료 체크 - 작업 로그 추가 (2025-12-18) --- plans/erp-api-development-plan.md | 42 +++++++++++++++++++++---------- 1 file changed, 29 insertions(+), 13 deletions(-) diff --git a/plans/erp-api-development-plan.md b/plans/erp-api-development-plan.md index b88623a..36ba4a8 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 완료 | 🟢 Phase 2 진행중 (2/3 완료: 전자결재 + 급여관리) +> **상태**: ✅ Phase 1 완료 | ✅ Phase 2 완료 (3/3: 전자결재 + 급여관리 + 대시보드) --- @@ -378,22 +378,27 @@ --- -### 3.3 대시보드 +### 3.3 대시보드 ✅ > 참조: [99-gap-analysis.md#33-대시보드](../specs/erp-analysis/99-gap-analysis.md) +> **완료일**: 2025-12-18 -- [ ] **서비스 구현** - - [ ] `DashboardService` 생성 - - [ ] 통계 집계 로직 - - [ ] 차트 데이터 생성 +- [x] **서비스 구현** + - [x] `DashboardService` 생성 + - [x] 통계 집계 로직 (오늘 현황, 재무, 매출/매입, 할 일) + - [x] 차트 데이터 생성 (입금/출금 추이, 거래처별 매출) -- [ ] **API 엔드포인트** - - [ ] `GET /v1/dashboard/summary` - 요약 데이터 - - [ ] `GET /v1/dashboard/charts` - 차트 데이터 - - [ ] `GET /v1/dashboard/notifications` - 알림 - - [ ] `GET /v1/dashboard/approvals` - 결재 현황 +- [x] **API 엔드포인트** (3개) + - [x] `GET /v1/dashboard/summary` - 요약 데이터 + - [x] `GET /v1/dashboard/charts` - 차트 데이터 + - [x] `GET /v1/dashboard/approvals` - 결재 현황 + - [ ] `GET /v1/dashboard/notifications` - 알림 (Push 기능과 함께 개발 예정) -- [ ] **Swagger 문서** - - [ ] `DashboardApi.php` 작성 +- [x] **Swagger 문서** + - [x] `DashboardApi.php` 작성 + +- [ ] **테스트** + - [ ] Feature 테스트 작성 + - [ ] 수동 API 테스트 --- @@ -506,6 +511,17 @@ - 4대보험 계산 로직 (건강보험, 장기요양, 국민연금, 고용보험) - 급여 상태 관리 (draft→confirmed→paid) +- [x] **대시보드 API 구현 완료** + - 서비스 1개 (`DashboardService`) + - 컨트롤러 1개 (`DashboardController`) + - FormRequest 2개 (`DashboardChartsRequest`, `DashboardApprovalsRequest`) + - API 엔드포인트 3개 (summary, charts, approvals) + - Swagger 문서 (`DashboardApi.php`) + - i18n 메시지/에러 키 추가 + - 통계 집계 로직 (오늘 현황, 재무, 매출/매입, 할 일) + - 차트 데이터 (입금/출금 추이, 거래처별 매출 상위 10) + - ※ notifications는 Push 기능과 함께 개발 예정 + ### YYYY-MM-DD - [ ] (작업 내용 기록)