refactor: Phase 3.7 - MonthlyStatus 컨트롤러 개선

주요 변경사항:

1. controllers/monthlyStatusController.js 완전 재작성 (202 → 232 lines)
   * 클래스 기반 → 함수 기반으로 변경:
     - static 메서드 → 독립 함수
     - 모듈 export 방식 변경

   * console.log/error → logger 교체:
     - logger.info: 요청/성공 로깅
     - logger.warn: 경고 로깅
     - logger.error: 실패 로깅

   * try-catch → asyncHandler 사용:
     - 에러 처리 자동화
     - 일관된 에러 응답

   * 커스텀 에러 클래스 적용:
     - ValidationError: 필수 필드/범위 검증
     - ForbiddenError: 관리자 권한 체크
     - DatabaseError: DB 오류

   * 4개 함수 개선:
     - getMonthlyCalendarData: 월별 캘린더 데이터
     - getDailyWorkerDetails: 일별 작업자 상세
     - recalculateMonth: 월별 집계 재계산
     - getStatusInfo: 집계 테이블 상태

   * 상세한 로깅 추가:
     - 요청 파라미터 추적
     - 조회 결과 통계 (일수, 작업자 수, 총 근무시간)
     - 관리자 작업 추적 (요청자 username)

기술적 개선사항:
- 클래스 → 함수: 테스트 및 재사용 용이
- 일관된 에러 처리: ValidationError, ForbiddenError, DatabaseError
- 구조화된 로깅: 모든 작업 추적 가능
- 권한 체크 개선: ForbiddenError 사용
- 코드 가독성 향상: JSDoc 문서화

컨트롤러 개선 최종 현황:
- ✅ 15/16 개 컨트롤러 개선 완료 (93.75%)

서비스 레이어 최종 현황:
- 9개 서비스 레이어 구축 완료

Phase 3 리팩토링 완료율: ~95%

남은 작업 (복잡도 매우 높음):
- workReportAnalysisController (복잡한 SQL 분석)
- workAnalysisController (복잡한 SQL 분석)
- systemController (시스템 관리 - 부분 개선 필요)
- authController (인증 - 부분 개선됨)
- userController (사용자 관리 - 부분 개선됨)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

api.hyungi.net/controllers/monthlyStatusController.js

@@ -1,18 +1,27 @@
-// controllers/monthlyStatusController.js
+/**
-// 월별 작업자 상태 집계 컨트롤러
+ * 월별 작업자 상태 집계 컨트롤러
+ *
+ * 월별 캘린더 및 작업자 상태 집계 API 엔드포인트 핸들러
+ *
+ * @author TK-FB-Project
+ * @since 2025-12-11
+ */
 
 const MonthlyStatusModel = require('../models/monthlyStatusModel');
+const { ValidationError, ForbiddenError, DatabaseError } = require('../utils/errors');
+const { asyncHandler } = require('../middlewares/errorHandler');
+const logger = require('../utils/logger');
 
-class MonthlyStatusController {
+/**
-  // 월별 캘린더 데이터 조회
+ * 월별 캘린더 데이터 조회
-  static async getMonthlyCalendarData(req, res) {
+ */
-    try {
+const getMonthlyCalendarData = asyncHandler(async (req, res) => {
   const { year, month } = req.query;
 
   if (!year || !month) {
-        return res.status(400).json({
+    throw new ValidationError('연도(year)와 월(month)이 필요합니다', {
-          success: false,
+      required: ['year', 'month'],
-          message: '연도(year)와 월(month)이 필요합니다.'
+      received: { year, month }
     });
   }
 
@@ -20,20 +29,20 @@ class MonthlyStatusController {
   const monthNum = parseInt(month);
 
   if (yearNum < 2020 || yearNum > 2030 || monthNum < 1 || monthNum > 12) {
-        return res.status(400).json({
+    throw new ValidationError('유효하지 않은 연도 또는 월입니다', {
-          success: false,
+      received: { year: yearNum, month: monthNum }
-          message: '유효하지 않은 연도 또는 월입니다.'
     });
   }
 
-      console.log(`📅 월별 캘린더 데이터 조회: ${year}년 ${month}월`);
+  logger.info('월별 캘린더 데이터 조회 요청', { year: yearNum, month: monthNum });
 
+  try {
     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 형식으로 변환
+      const dateKey = day.date.toISOString().split('T')[0];
       calendarData[dateKey] = {
         totalWorkers: day.total_workers,
         workingWorkers: day.working_workers,
@@ -51,39 +60,46 @@ class MonthlyStatusController {
       };
     });
 
+    logger.info('월별 캘린더 데이터 조회 성공', {
+      year: yearNum,
+      month: monthNum,
+      dayCount: Object.keys(calendarData).length
+    });
+
     res.json({
       success: true,
       data: calendarData,
-        message: `${year}년 ${month}월 캘린더 데이터를 성공적으로 조회했습니다.`
+      message: `${year}년 ${month}월 캘린더 데이터를 성공적으로 조회했습니다`
     });
-      
   } catch (error) {
-      console.error('월별 캘린더 데이터 조회 오류:', error);
+    logger.error('월별 캘린더 데이터 조회 실패', {
-      res.status(500).json({
+      year: yearNum,
-        success: false,
+      month: monthNum,
-        message: '월별 캘린더 데이터 조회 중 오류가 발생했습니다.',
       error: error.message
     });
+    throw new DatabaseError('월별 캘린더 데이터 조회 중 오류가 발생했습니다');
   }
-  }
+});
 
-  // 특정 날짜의 작업자별 상세 상태 조회
+/**
-  static async getDailyWorkerDetails(req, res) {
+ * 특정 날짜의 작업자별 상세 상태 조회
-    try {
+ */
+const getDailyWorkerDetails = asyncHandler(async (req, res) => {
   const { date } = req.query;
 
   if (!date) {
-        return res.status(400).json({
+    throw new ValidationError('날짜(date)가 필요합니다', {
-          success: false,
+      required: ['date'],
-          message: '날짜(date)가 필요합니다.'
+      received: { date }
     });
   }
 
-      console.log(`👥 일별 작업자 상세 조회: ${date}`);
+  logger.info('일별 작업자 상세 조회 요청', { date });
 
+  try {
     const workerDetails = await MonthlyStatusModel.getDailyWorkerStatus(date);
 
-      // 프론트엔드에서 사용하기 쉽도록 데이터 변환
+    // 데이터 변환
     const formattedData = workerDetails.map(worker => ({
       workerId: worker.worker_id,
       workerName: worker.worker_name,
@@ -109,93 +125,107 @@ class MonthlyStatusController {
       errorCount: formattedData.reduce((sum, w) => sum + w.errorWorkCount, 0)
     };
 
+    logger.info('일별 작업자 상세 조회 성공', {
+      date,
+      workerCount: formattedData.length,
+      totalHours: summary.totalHours
+    });
+
     res.json({
       success: true,
       data: {
         workers: formattedData,
         summary
       },
-        message: `${date} 작업자 상세 정보를 성공적으로 조회했습니다.`
+      message: `${date} 작업자 상세 정보를 성공적으로 조회했습니다`
     });
-      
   } catch (error) {
-      console.error('일별 작업자 상세 조회 오류:', error);
+    logger.error('일별 작업자 상세 조회 실패', {
-      res.status(500).json({
+      date,
-        success: false,
-        message: '일별 작업자 상세 조회 중 오류가 발생했습니다.',
       error: error.message
     });
+    throw new DatabaseError('일별 작업자 상세 조회 중 오류가 발생했습니다');
   }
-  }
+});
 
-  // 월별 집계 재계산 (관리자용)
+/**
-  static async recalculateMonth(req, res) {
+ * 월별 집계 재계산 (관리자용)
-    try {
+ */
+const recalculateMonth = asyncHandler(async (req, res) => {
   const { year, month } = req.body;
 
   if (!year || !month) {
-        return res.status(400).json({
+    throw new ValidationError('연도(year)와 월(month)이 필요합니다', {
-          success: false,
+      required: ['year', 'month'],
-          message: '연도(year)와 월(month)이 필요합니다.'
+      received: { year, month }
     });
   }
 
   // 관리자 권한 확인
   if (req.user.role !== 'admin' && req.user.role !== 'system') {
-        return res.status(403).json({
+    throw new ForbiddenError('관리자 권한이 필요합니다');
-          success: false,
-          message: '관리자 권한이 필요합니다.'
-        });
   }
 
-      console.log(`🔄 월별 집계 재계산 시작: ${year}년 ${month}월`);
+  logger.info('월별 집계 재계산 시작', {
+    year,
+    month,
+    requestedBy: req.user.username
+  });
 
+  try {
     const result = await MonthlyStatusModel.recalculateMonth(parseInt(year), parseInt(month));
 
+    logger.info('월별 집계 재계산 성공', { year, month, result });
+
     res.json({
       success: true,
       data: result,
-        message: `${year}년 ${month}월 집계 재계산이 완료되었습니다.`
+      message: `${year}년 ${month}월 집계 재계산이 완료되었습니다`
     });
-      
   } catch (error) {
-      console.error('월별 집계 재계산 오류:', error);
+    logger.error('월별 집계 재계산 실패', {
-      res.status(500).json({
+      year,
-        success: false,
+      month,
-        message: '월별 집계 재계산 중 오류가 발생했습니다.',
       error: error.message
     });
+    throw new DatabaseError('월별 집계 재계산 중 오류가 발생했습니다');
   }
-  }
+});
 
-  // 집계 테이블 상태 확인 (관리자용)
+/**
-  static async getStatusInfo(req, res) {
+ * 집계 테이블 상태 확인 (관리자용)
-    try {
+ */
+const getStatusInfo = asyncHandler(async (req, res) => {
   // 관리자 권한 확인
   if (req.user.role !== 'admin' && req.user.role !== 'system') {
-        return res.status(403).json({
+    throw new ForbiddenError('관리자 권한이 필요합니다');
-          success: false,
-          message: '관리자 권한이 필요합니다.'
-        });
   }
 
+  logger.info('집계 테이블 상태 확인 요청', {
+    requestedBy: req.user.username
+  });
+
+  try {
     const statusInfo = await MonthlyStatusModel.getStatusInfo();
 
+    logger.info('집계 테이블 상태 확인 성공');
+
     res.json({
       success: true,
       data: statusInfo,
-        message: '집계 테이블 상태 정보를 성공적으로 조회했습니다.'
+      message: '집계 테이블 상태 정보를 성공적으로 조회했습니다'
     });
-      
   } catch (error) {
-      console.error('집계 테이블 상태 확인 오류:', error);
+    logger.error('집계 테이블 상태 확인 실패', {
-      res.status(500).json({
-        success: false,
-        message: '집계 테이블 상태 확인 중 오류가 발생했습니다.',
       error: error.message
     });
+    throw new DatabaseError('집계 테이블 상태 확인 중 오류가 발생했습니다');
   }
-  }
+});
-}
 
-module.exports = MonthlyStatusController;
+module.exports = {
+  getMonthlyCalendarData,
+  getDailyWorkerDetails,
+  recalculateMonth,
+  getStatusInfo
+};