[Dashboard] 오늘 업무 대시보드 요약 API 구현

[hywznn]

한 줄 요약

HR이 로그인 직후 오늘 처리할 업무, 만료 임박 항목, 대기 중인 요청을 한 화면에서 확인할 수 있게 합니다.

소유 API

• GET /dashboard/today

상세 필드와 화면 기준은 Notion API 명세와 Figma를 함께 확인합니다.

응답이 설명해야 하는 것

• 오늘 마감 또는 기한 임박 업무
• NEEDS_INFO, READY_FOR_REVIEW, WAITING_WORKER, WAITING_EXTERNAL 개수
• 체류·계약·서류 만료 임박 요약
• 사용자가 눌렀을 때 이동할 필터 조건

초보자용 구현 순서

1. Figma 카드마다 어떤 숫자와 목록이 필요한지 표로 정리합니다.
2. 같은 사업장과 같은 기준 시각을 사용하는 조회 Service를 만듭니다.
3. 상태·마감일·만료일 기준을 설정값 또는 Workflow 정책에서 읽습니다.
4. 오늘 화면에 필요한 최소 요약을 한 응답으로 반환합니다.
5. 빈 데이터, 날짜 경계, VIEWER 권한, 타 사업장 격리 테스트를 작성합니다.

완료 조건

• 서버의 기준 시간대가 명확하며 날짜 경계 테스트가 있습니다.
• 다른 사업장의 집계가 섞이지 않습니다.
• 빈 사업장은 500이 아니라 0과 빈 목록을 반환합니다.
• 응답 항목이 실제 업무 목록 필터와 일치합니다.
• Swagger 예시와 성능을 확인할 인덱스가 있습니다.

이번 이슈에서 하지 않는 것

• 자유롭게 조합하는 분석 대시보드
• 장기 통계·BI
• 실시간 WebSocket 알림

선행/후속 관계

• 선행: [Auth & Security] JWT 인증·사업장 권한·멀티테넌시 구현 #4, [Worker] 근로자 기본정보·서류 메타데이터 API 구현 #5, [Task Workflow] 업무카드·체크리스트·상태 전이 구현 #6, [Approval & Audit] 승인·반려·외부제출·증빙·완료·감사 로그 구현 #11
• 상위 목표: [EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP #2