feat: 캘린더 기반 작업 현황 확인 시스템 구현

- 월별 캘린더 UI로 작업 현황을 한눈에 확인 가능 - 미입력(빨강), 부분입력(주황), 확인필요(보라), 이상없음(초록) 상태 표시 - 범례 아이콘(●)을 사용한 직관적인 상태 표시 - 날짜 클릭 시 해당일 작업자별 상세 현황 모달 - 작업자 클릭 시 개별 작업 입력/수정 모달 - 휴가 처리 기능 (연차, 반차, 반반차, 조퇴) - 월별 집계 데이터 최적화로 API 호출 최소화 백엔드: - monthly_worker_status, monthly_summary 테이블 추가 - 자동 집계 stored procedure 및 trigger 구현 - 확인필요(12시간 초과) 상태 감지 로직 - 출석 관리 시스템 확장 프론트엔드: - 캘린더 그리드 UI 구현 - 상태별 색상 및 아이콘 표시 - 모달 기반 상세 정보 표시 - 반응형 디자인 적용
2025-11-04 10:12:07 +09:00
parent 33307bb243
commit 746e09420b
29 changed files with 8815 additions and 251 deletions
--- a/api.hyungi.net/controllers/monthlyStatusController.js
+++ b/api.hyungi.net/controllers/monthlyStatusController.js
@@ -0,0 +1,201 @@
+// controllers/monthlyStatusController.js
+// 월별 작업자 상태 집계 컨트롤러
+
+const MonthlyStatusModel = require('../models/monthlyStatusModel');
+
+class MonthlyStatusController {
+  // 월별 캘린더 데이터 조회
+  static async getMonthlyCalendarData(req, res) {
+    try {
+      const { year, month } = req.query;
+      
+      if (!year || !month) {
+        return res.status(400).json({
+          success: false,
+          message: '연도(year)와 월(month)이 필요합니다.'
+        });
+      }
+      
+      const yearNum = parseInt(year);
+      const monthNum = parseInt(month);
+      
+      if (yearNum < 2020 || yearNum > 2030 || monthNum < 1 || monthNum > 12) {
+        return res.status(400).json({
+          success: false,
+          message: '유효하지 않은 연도 또는 월입니다.'
+        });
+      }
+      
+      console.log(`📅 월별 캘린더 데이터 조회: ${year}년 ${month}월`);
+      
+      const summaryData = await MonthlyStatusModel.getMonthlySummary(yearNum, monthNum);
+      
+      // 날짜별 객체로 변환 (날짜 키를 YYYY-MM-DD 형식으로 변환)
+      const calendarData = {};
+      summaryData.forEach(day => {
+        const dateKey = day.date.toISOString().split('T')[0]; // YYYY-MM-DD 형식으로 변환
+        calendarData[dateKey] = {
+          totalWorkers: day.total_workers,
+          workingWorkers: day.working_workers,
+          hasIssues: day.has_issues,
+          hasErrors: day.has_errors,
+          hasOvertimeWarning: day.has_overtime_warning,
+          incompleteWorkers: day.incomplete_workers,
+          partialWorkers: day.partial_workers,
+          errorWorkers: day.error_workers,
+          overtimeWarningWorkers: day.overtime_warning_workers,
+          totalHours: parseFloat(day.total_work_hours || 0),
+          totalTasks: day.total_work_count,
+          errorCount: day.total_error_count,
+          lastUpdated: day.last_updated
+        };
+      });
+      
+      res.json({
+        success: true,
+        data: calendarData,
+        message: `${year}년 ${month}월 캘린더 데이터를 성공적으로 조회했습니다.`
+      });
+      
+    } catch (error) {
+      console.error('월별 캘린더 데이터 조회 오류:', error);
+      res.status(500).json({
+        success: false,
+        message: '월별 캘린더 데이터 조회 중 오류가 발생했습니다.',
+        error: error.message
+      });
+    }
+  }
+  
+  // 특정 날짜의 작업자별 상세 상태 조회
+  static async getDailyWorkerDetails(req, res) {
+    try {
+      const { date } = req.query;
+      
+      if (!date) {
+        return res.status(400).json({
+          success: false,
+          message: '날짜(date)가 필요합니다.'
+        });
+      }
+      
+      console.log(`👥 일별 작업자 상세 조회: ${date}`);
+      
+      const workerDetails = await MonthlyStatusModel.getDailyWorkerStatus(date);
+      
+      // 프론트엔드에서 사용하기 쉽도록 데이터 변환
+      const formattedData = workerDetails.map(worker => ({
+        workerId: worker.worker_id,
+        workerName: worker.worker_name,
+        jobType: worker.job_type,
+        totalHours: parseFloat(worker.total_work_hours || 0),
+        actualWorkHours: parseFloat(worker.actual_work_hours || 0),
+        vacationHours: parseFloat(worker.vacation_hours || 0),
+        totalWorkCount: worker.total_work_count,
+        regularWorkCount: worker.regular_work_count,
+        errorWorkCount: worker.error_work_count,
+        status: worker.work_status,
+        hasVacation: worker.has_vacation,
+        hasError: worker.has_error,
+        hasIssues: worker.has_issues,
+        lastUpdated: worker.last_updated
+      }));
+      
+      // 요약 정보 계산
+      const summary = {
+        totalWorkers: formattedData.length,
+        totalHours: formattedData.reduce((sum, w) => sum + w.totalHours, 0),
+        totalTasks: formattedData.reduce((sum, w) => sum + w.totalWorkCount, 0),
+        errorCount: formattedData.reduce((sum, w) => sum + w.errorWorkCount, 0)
+      };
+      
+      res.json({
+        success: true,
+        data: {
+          workers: formattedData,
+          summary
+        },
+        message: `${date} 작업자 상세 정보를 성공적으로 조회했습니다.`
+      });
+      
+    } catch (error) {
+      console.error('일별 작업자 상세 조회 오류:', error);
+      res.status(500).json({
+        success: false,
+        message: '일별 작업자 상세 조회 중 오류가 발생했습니다.',
+        error: error.message
+      });
+    }
+  }
+  
+  // 월별 집계 재계산 (관리자용)
+  static async recalculateMonth(req, res) {
+    try {
+      const { year, month } = req.body;
+      
+      if (!year || !month) {
+        return res.status(400).json({
+          success: false,
+          message: '연도(year)와 월(month)이 필요합니다.'
+        });
+      }
+      
+      // 관리자 권한 확인
+      if (req.user.role !== 'admin' && req.user.role !== 'system') {
+        return res.status(403).json({
+          success: false,
+          message: '관리자 권한이 필요합니다.'
+        });
+      }
+      
+      console.log(`🔄 월별 집계 재계산 시작: ${year}년 ${month}월`);
+      
+      const result = await MonthlyStatusModel.recalculateMonth(parseInt(year), parseInt(month));
+      
+      res.json({
+        success: true,
+        data: result,
+        message: `${year}년 ${month}월 집계 재계산이 완료되었습니다.`
+      });
+      
+    } catch (error) {
+      console.error('월별 집계 재계산 오류:', error);
+      res.status(500).json({
+        success: false,
+        message: '월별 집계 재계산 중 오류가 발생했습니다.',
+        error: error.message
+      });
+    }
+  }
+  
+  // 집계 테이블 상태 확인 (관리자용)
+  static async getStatusInfo(req, res) {
+    try {
+      // 관리자 권한 확인
+      if (req.user.role !== 'admin' && req.user.role !== 'system') {
+        return res.status(403).json({
+          success: false,
+          message: '관리자 권한이 필요합니다.'
+        });
+      }
+      
+      const statusInfo = await MonthlyStatusModel.getStatusInfo();
+      
+      res.json({
+        success: true,
+        data: statusInfo,
+        message: '집계 테이블 상태 정보를 성공적으로 조회했습니다.'
+      });
+      
+    } catch (error) {
+      console.error('집계 테이블 상태 확인 오류:', error);
+      res.status(500).json({
+        success: false,
+        message: '집계 테이블 상태 확인 중 오류가 발생했습니다.',
+        error: error.message
+      });
+    }
+  }
+}
+
+module.exports = MonthlyStatusController;