Files
TK-FB-Project/api.hyungi.net/services/workReportService.js
Hyungi Ahn b6f79d7ca7 refactor: Phase 3.6 - Analysis, WorkReport 서비스 레이어 구축 및 개선
주요 변경사항:

1. services/analysisService.js 개선 (48 → 82 lines, 71% 증가)
   * console.error → logger 교체:
     - logger.info: 요청/성공 로깅
     - logger.error: 실패 로깅

   * Error → 커스텀 에러 클래스 적용:
     - ValidationError: 필수 필드 검증
     - DatabaseError: DB 오류

   * 상세한 로깅 추가:
     - 총 근무시간, 프로젝트 수, 작업자 수, 상세 건수 추적

   * JSDoc 문서화 개선

2. controllers/analysisController.js 개선 (22 → 30 lines)
   * try-catch 제거 → asyncHandler 사용
   * console.error 제거
   * 표준화된 JSON 응답 형식

3. services/workReportService.js 신규 생성 (308 lines)
   * 7개 서비스 함수 구현:
     - createWorkReportService: 단일/다중 보고서 생성
     - getWorkReportsByDateService: 날짜별 조회
     - getWorkReportsInRangeService: 기간별 조회
     - getWorkReportByIdService: 단일 조회
     - updateWorkReportService: 수정
     - removeWorkReportService: 삭제
     - getSummaryService: 월간 요약

   * 커스텀 에러 클래스 적용
   * 구조화된 로깅 통합
   * 필수 필드 검증
   * 배열/단일 데이터 모두 지원

4. controllers/workReportController.js 완전 재작성 (134 → 109 lines, 19% 감소)
   * try-catch 제거 → asyncHandler 사용
   * 모든 비즈니스 로직 서비스 레이어로 이동
   * 표준화된 JSON 응답 형식
   * 에러 처리 자동화
   * 7개 엔드포인트 모두 개선

기술적 개선사항:
- 일관된 에러 처리: 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)
-  analysisService.js (Phase 3.6 - 개선)
-  workReportService.js (Phase 3.6)
-  auth.service.js (기존)

총 9개 서비스 레이어 구축 완료

컨트롤러 개선 현황:
-  14/16 개 컨트롤러 개선 완료 (87.5%)

남은 컨트롤러:
- workReportAnalysisController
- workAnalysisController
- monthlyStatusController
- systemController
- authController
- userController (일부)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-11 12:53:53 +09:00

281 lines
7.6 KiB
JavaScript

/**
* 작업 보고서 관리 서비스
*
* 작업 보고서 CRUD 및 조회 관련 비즈니스 로직 처리
*
* @author TK-FB-Project
* @since 2025-12-11
*/
const workReportModel = require('../models/workReportModel');
const { ValidationError, NotFoundError, DatabaseError } = require('../utils/errors');
const logger = require('../utils/logger');
/**
* 작업 보고서 생성 (단일 또는 다중)
*/
const createWorkReportService = async (reportData) => {
const reports = Array.isArray(reportData) ? reportData : [reportData];
if (reports.length === 0) {
throw new ValidationError('보고서 데이터가 필요합니다');
}
logger.info('작업 보고서 생성 요청', { count: reports.length });
const workReport_ids = [];
try {
for (const report of reports) {
const id = await new Promise((resolve, reject) => {
workReportModel.create(report, (err, insertId) => {
if (err) reject(err);
else resolve(insertId);
});
});
workReport_ids.push(id);
}
logger.info('작업 보고서 생성 성공', {
count: workReport_ids.length,
ids: workReport_ids
});
return { workReport_ids };
} catch (error) {
logger.error('작업 보고서 생성 실패', {
count: reports.length,
error: error.message
});
throw new DatabaseError('작업 보고서 생성 중 오류가 발생했습니다');
}
};
/**
* 날짜별 작업 보고서 조회
*/
const getWorkReportsByDateService = async (date) => {
if (!date) {
throw new ValidationError('날짜가 필요합니다', {
required: ['date'],
received: { date }
});
}
logger.info('작업 보고서 날짜별 조회 요청', { date });
try {
const rows = await new Promise((resolve, reject) => {
workReportModel.getAllByDate(date, (err, data) => {
if (err) reject(err);
else resolve(data);
});
});
logger.info('작업 보고서 조회 성공', { date, count: rows.length });
return rows;
} catch (error) {
logger.error('작업 보고서 조회 실패', { date, error: error.message });
throw new DatabaseError('작업 보고서 조회 중 오류가 발생했습니다');
}
};
/**
* 기간별 작업 보고서 조회
*/
const getWorkReportsInRangeService = async (start, end) => {
if (!start || !end) {
throw new ValidationError('시작일과 종료일이 필요합니다', {
required: ['start', 'end'],
received: { start, end }
});
}
logger.info('작업 보고서 기간별 조회 요청', { start, end });
try {
const rows = await new Promise((resolve, reject) => {
workReportModel.getByRange(start, end, (err, data) => {
if (err) reject(err);
else resolve(data);
});
});
logger.info('작업 보고서 조회 성공', { start, end, count: rows.length });
return rows;
} catch (error) {
logger.error('작업 보고서 조회 실패', { start, end, error: error.message });
throw new DatabaseError('작업 보고서 조회 중 오류가 발생했습니다');
}
};
/**
* 단일 작업 보고서 조회
*/
const getWorkReportByIdService = async (id) => {
if (!id) {
throw new ValidationError('보고서 ID가 필요합니다');
}
logger.info('작업 보고서 조회 요청', { report_id: id });
try {
const row = await new Promise((resolve, reject) => {
workReportModel.getById(id, (err, data) => {
if (err) reject(err);
else resolve(data);
});
});
if (!row) {
logger.warn('작업 보고서를 찾을 수 없음', { report_id: id });
throw new NotFoundError('작업 보고서를 찾을 수 없습니다');
}
logger.info('작업 보고서 조회 성공', { report_id: id });
return row;
} catch (error) {
if (error instanceof NotFoundError) {
throw error;
}
logger.error('작업 보고서 조회 실패', { report_id: id, error: error.message });
throw new DatabaseError('작업 보고서 조회 중 오류가 발생했습니다');
}
};
/**
* 작업 보고서 수정
*/
const updateWorkReportService = async (id, updateData) => {
if (!id) {
throw new ValidationError('보고서 ID가 필요합니다');
}
logger.info('작업 보고서 수정 요청', { report_id: id });
try {
const changes = await new Promise((resolve, reject) => {
workReportModel.update(id, updateData, (err, affectedRows) => {
if (err) reject(err);
else resolve(affectedRows);
});
});
if (changes === 0) {
logger.warn('작업 보고서를 찾을 수 없거나 변경사항 없음', { report_id: id });
throw new NotFoundError('작업 보고서를 찾을 수 없습니다');
}
logger.info('작업 보고서 수정 성공', { report_id: id, changes });
return { changes };
} catch (error) {
if (error instanceof NotFoundError) {
throw error;
}
logger.error('작업 보고서 수정 실패', { report_id: id, error: error.message });
throw new DatabaseError('작업 보고서 수정 중 오류가 발생했습니다');
}
};
/**
* 작업 보고서 삭제
*/
const removeWorkReportService = async (id) => {
if (!id) {
throw new ValidationError('보고서 ID가 필요합니다');
}
logger.info('작업 보고서 삭제 요청', { report_id: id });
try {
const changes = await new Promise((resolve, reject) => {
workReportModel.remove(id, (err, affectedRows) => {
if (err) reject(err);
else resolve(affectedRows);
});
});
if (changes === 0) {
logger.warn('작업 보고서를 찾을 수 없음', { report_id: id });
throw new NotFoundError('작업 보고서를 찾을 수 없습니다');
}
logger.info('작업 보고서 삭제 성공', { report_id: id, changes });
return { changes };
} catch (error) {
if (error instanceof NotFoundError) {
throw error;
}
logger.error('작업 보고서 삭제 실패', { report_id: id, error: error.message });
throw new DatabaseError('작업 보고서 삭제 중 오류가 발생했습니다');
}
};
/**
* 월간 요약 조회
*/
const getSummaryService = async (year, month) => {
if (!year || !month) {
throw new ValidationError('연도와 월이 필요합니다', {
required: ['year', 'month'],
received: { year, month }
});
}
const start = `${year.padStart(4, '0')}-${month.padStart(2, '0')}-01`;
const end = `${year.padStart(4, '0')}-${month.padStart(2, '0')}-31`;
logger.info('작업 보고서 월간 요약 조회 요청', { year, month, start, end });
try {
const rows = await new Promise((resolve, reject) => {
workReportModel.getByRange(start, end, (err, data) => {
if (err) reject(err);
else resolve(data);
});
});
if (!rows || rows.length === 0) {
logger.warn('월간 요약 데이터 없음', { year, month });
throw new NotFoundError('해당 기간의 작업 보고서가 없습니다');
}
logger.info('작업 보고서 월간 요약 조회 성공', {
year,
month,
count: rows.length
});
return rows;
} catch (error) {
if (error instanceof NotFoundError) {
throw error;
}
logger.error('작업 보고서 월간 요약 조회 실패', {
year,
month,
error: error.message
});
throw new DatabaseError('월간 요약 조회 중 오류가 발생했습니다');
}
};
module.exports = {
createWorkReportService,
getWorkReportsByDateService,
getWorkReportsInRangeService,
getWorkReportByIdService,
updateWorkReportService,
removeWorkReportService,
getSummaryService
};