refactor: Phase 3.5 - DailyIssueReport, Upload 서비스 레이어 개선

주요 변경사항:

1. services/dailyIssueReportService.js 개선 (93 → 170 lines, 83% 증가)
   * console.error → logger 교체:
     - logger.info: 작업 시작/성공 로깅
     - logger.error: 실패 로깅
     - logger.warn: 경고 로깅

   * Error → 커스텀 에러 클래스 적용:
     - ValidationError: 필수 필드 검증 실패
     - NotFoundError: 리소스 없음
     - DatabaseError: DB 오류

   * 상세한 JSDoc 문서화:
     - 모든 파라미터 타입 및 설명 추가
     - 함수 목적 및 동작 명시

   * 구조화된 로깅:
     - 모든 요청에 컨텍스트 정보 포함
     - 성공/실패 추적 가능

2. controllers/dailyIssueReportController.js 개선 (58 → 65 lines)
   * try-catch 제거 → asyncHandler 사용
   * console.error 제거
   * 에러 처리 자동화
   * 표준화된 JSON 응답 형식

3. services/uploadService.js 신규 생성 (96 lines)
   * 2개 서비스 함수 구현:
     - createUploadService: 문서 업로드 생성
     - getAllUploadsService: 전체 문서 조회

   * 커스텀 에러 클래스 적용
   * 구조화된 로깅 통합
   * 필수 필드 검증 (original_name, stored_name, file_path)
   * 파일 메타데이터 로깅

4. controllers/uploadController.js 완전 재작성 (26 → 39 lines)
   * try-catch 제거 → asyncHandler 사용
   * 모든 비즈니스 로직 서비스 레이어로 이동
   * 표준화된 JSON 응답 형식
   * 에러 처리 자동화

기술적 개선사항:
- 일관된 에러 처리: ValidationError, NotFoundError, DatabaseError
- 구조화된 로깅: 모든 작업 추적 및 디버깅 용이
- 코드 중복 제거: try-catch 패턴 제거
- 테스트 용이성: 서비스 함수 독립적 테스트 가능
- 유지보수성: 비즈니스 로직과 HTTP 레이어 분리

서비스 레이어 진행 상황:
- ✅ dailyWorkReportService.js (Phase 3.1)
- ✅ attendanceService.js (Phase 3.2)
- ✅ issueTypeService.js (Phase 3.4)
- ✅ toolsService.js (Phase 3.4)
- ✅ dailyIssueReportService.js (Phase 3.5 - 개선)
- ✅ uploadService.js (Phase 3.5 - 신규)

전체 진행률:
- 컨트롤러: 16개 중 12개 개선 완료 (75%)
- 서비스 레이어: 6개 생성/개선 완료

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

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

api.hyungi.net/services/dailyIssueReportService.js

@@ -1,24 +1,55 @@
-// /services/dailyIssueReportService.js
+/**
+ * 일일 이슈 보고서 관리 서비스
+ *
+ * 일일 이슈 보고서 생성, 조회, 삭제 관련 비즈니스 로직 처리
+ *
+ * @author TK-FB-Project
+ * @since 2025-12-11
+ */
+
 const dailyIssueReportModel = require('../models/dailyIssueReportModel');
+const { ValidationError, NotFoundError, DatabaseError } = require('../utils/errors');
+const logger = require('../utils/logger');
 
 /**
- * 일일 이슈 보고서를 생성하는 비즈니스 로직을 처리합니다.
+ * 일일 이슈 보고서 생성
+ *
  * 한 번에 여러 작업자에 대해 동일한 이슈를 등록할 수 있습니다.
+ *
  * @param {object} issueData - 컨트롤러에서 전달된 이슈 데이터
+ * @param {string} issueData.date - 이슈 발생 날짜 (YYYY-MM-DD)
+ * @param {number} issueData.project_id - 프로젝트 ID
+ * @param {string} issueData.start_time - 이슈 시작 시간
+ * @param {string} issueData.end_time - 이슈 종료 시간
+ * @param {number} issueData.issue_type_id - 이슈 유형 ID
+ * @param {number[]} issueData.worker_ids - 작업자 ID 배열
  * @returns {Promise<object>} 생성 결과
  */
 const createDailyIssueReportService = async (issueData) => {
   const { date, project_id, start_time, end_time, issue_type_id, worker_ids } = issueData;
 
-  // 1. 유효성 검사
+  // 필수 필드 검증
   if (!date || !project_id || !start_time || !end_time || !issue_type_id || !worker_ids) {
-    throw new Error('필수 필드가 누락되었습니다.');
-  }
-  if (!Array.isArray(worker_ids) || worker_ids.length === 0) {
-    throw new Error('worker_ids는 최소 한 명 이상의 작업자를 포함하는 배열이어야 합니다.');
+    throw new ValidationError('필수 필드가 누락되었습니다', {
+      required: ['date', 'project_id', 'start_time', 'end_time', 'issue_type_id', 'worker_ids'],
+      received: { date, project_id, start_time, end_time, issue_type_id, worker_ids: !!worker_ids }
+    });
   }
 
-  // 2. 모델에 전달할 데이터 준비
+  if (!Array.isArray(worker_ids) || worker_ids.length === 0) {
+    throw new ValidationError('worker_ids는 최소 한 명 이상의 작업자를 포함하는 배열이어야 합니다', {
+      received: { worker_ids, isArray: Array.isArray(worker_ids), length: worker_ids?.length }
+    });
+  }
+
+  logger.info('이슈 보고서 생성 요청', {
+    date,
+    project_id,
+    issue_type_id,
+    worker_count: worker_ids.length
+  });
+
+  // 모델에 전달할 데이터 준비
   const reportsToCreate = worker_ids.map(worker_id => ({
     date,
     project_id,
@@ -28,66 +59,112 @@ const createDailyIssueReportService = async (issueData) => {
     worker_id
   }));
 
-  // 3. 모델 함수 호출 (모델에 createMany와 같은 함수가 필요)
   try {
     const insertedIds = await dailyIssueReportModel.createMany(reportsToCreate);
+
+    logger.info('이슈 보고서 생성 성공', {
+      count: insertedIds.length,
+      issue_report_ids: insertedIds
+    });
+
     return {
-      message: `${insertedIds.length}개의 이슈 보고서가 성공적으로 생성되었습니다.`,
+      message: `${insertedIds.length}개의 이슈 보고서가 성공적으로 생성되었습니다`,
       issue_report_ids: insertedIds
     };
   } catch (error) {
-    console.error('[Service] 이슈 보고서 생성 중 오류 발생:', error);
-    throw error;
+    logger.error('이슈 보고서 생성 실패', {
+      date,
+      project_id,
+      worker_ids,
+      error: error.message
+    });
+    throw new DatabaseError('이슈 보고서 생성 중 오류가 발생했습니다');
   }
 };
 
 /**
- * 특정 날짜의 모든 이슈 보고서를 조회합니다.
+ * 특정 날짜의 모든 이슈 보고서 조회
+ *
  * @param {string} date - 조회할 날짜 (YYYY-MM-DD)
  * @returns {Promise<Array>} 조회된 이슈 보고서 배열
  */
 const getDailyIssuesByDateService = async (date) => {
   if (!date) {
-    throw new Error('조회를 위해 날짜(date)는 필수입니다.');
+    throw new ValidationError('날짜가 필요합니다', {
+      required: ['date'],
+      received: { date }
+    });
   }
+
+  logger.info('이슈 보고서 날짜별 조회 요청', { date });
+
   try {
     const issues = await dailyIssueReportModel.getAllByDate(date);
+
+    logger.info('이슈 보고서 조회 성공', {
+      date,
+      count: issues.length
+    });
+
     return issues;
   } catch (error) {
-    console.error(`[Service] ${date}의 이슈 보고서 조회 중 오류 발생:`, error);
-    throw error;
+    logger.error('이슈 보고서 조회 실패', {
+      date,
+      error: error.message
+    });
+    throw new DatabaseError('이슈 보고서 조회 중 오류가 발생했습니다');
   }
 };
 
 /**
- * 특정 ID의 이슈 보고서를 삭제합니다.
- * @param {string} issueId - 삭제할 이슈 보고서의 ID
+ * 특정 ID의 이슈 보고서 삭제
+ *
+ * @param {string|number} issueId - 삭제할 이슈 보고서의 ID
  * @returns {Promise<object>} 삭제 결과
  */
 const removeDailyIssueService = async (issueId) => {
   if (!issueId) {
-    throw new Error('삭제를 위해 이슈 보고서 ID가 필요합니다.');
+    throw new ValidationError('이슈 보고서 ID가 필요합니다', {
+      required: ['issue_id'],
+      received: { issueId }
+    });
   }
+
+  logger.info('이슈 보고서 삭제 요청', { issue_id: issueId });
+
   try {
     const affectedRows = await dailyIssueReportModel.remove(issueId);
+
     if (affectedRows === 0) {
-      const notFoundError = new Error('삭제할 이슈 보고서를 찾을 수 없습니다.');
-      notFoundError.statusCode = 404;
-      throw notFoundError;
+      logger.warn('삭제할 이슈 보고서를 찾을 수 없음', { issue_id: issueId });
+      throw new NotFoundError('삭제할 이슈 보고서를 찾을 수 없습니다');
     }
-    return { 
-        message: '이슈 보고서가 성공적으로 삭제되었습니다.',
-        deleted_id: issueId,
-        affected_rows: affectedRows 
+
+    logger.info('이슈 보고서 삭제 성공', {
+      issue_id: issueId,
+      affected_rows: affectedRows
+    });
+
+    return {
+      message: '이슈 보고서가 성공적으로 삭제되었습니다',
+      deleted_id: issueId,
+      affected_rows: affectedRows
     };
   } catch (error) {
-    console.error(`[Service] 이슈 보고서(id: ${issueId}) 삭제 중 오류 발생:`, error);
-    throw error;
+    if (error instanceof NotFoundError) {
+      throw error;
+    }
+
+    logger.error('이슈 보고서 삭제 실패', {
+      issue_id: issueId,
+      error: error.message
+    });
+    throw new DatabaseError('이슈 보고서 삭제 중 오류가 발생했습니다');
   }
 };
 
 module.exports = {
   createDailyIssueReportService,
   getDailyIssuesByDateService,
-  removeDailyIssueService,
-}; 
+  removeDailyIssueService
+};