b6f79d7ca7
주요 변경사항:
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>
82 lines
2.3 KiB
JavaScript
82 lines
2.3 KiB
JavaScript
/**
|
|
* 프로젝트 분석 서비스
|
|
*
|
|
* 기간별 프로젝트, 작업자, 작업 유형 분석 데이터 처리
|
|
*
|
|
* @author TK-FB-Project
|
|
* @since 2025-12-11
|
|
*/
|
|
|
|
const analysisModel = require('../models/analysisModel');
|
|
const { ValidationError, DatabaseError } = require('../utils/errors');
|
|
const logger = require('../utils/logger');
|
|
|
|
/**
|
|
* 기간별 프로젝트 분석 데이터 조회
|
|
*
|
|
* @param {string} startDate - 시작일 (YYYY-MM-DD)
|
|
* @param {string} endDate - 종료일 (YYYY-MM-DD)
|
|
* @returns {Promise<object>} 가공된 분석 데이터
|
|
*/
|
|
const getAnalysisService = async (startDate, endDate) => {
|
|
// 필수 필드 검증
|
|
if (!startDate || !endDate) {
|
|
throw new ValidationError('시작일과 종료일이 필요합니다', {
|
|
required: ['startDate', 'endDate'],
|
|
received: { startDate, endDate }
|
|
});
|
|
}
|
|
|
|
logger.info('분석 데이터 조회 요청', { startDate, endDate });
|
|
|
|
try {
|
|
const analysisData = await analysisModel.getAnalysis(startDate, endDate);
|
|
|
|
const { summary, byProject, byWorker, byTask, details } = analysisData;
|
|
const totalHours = summary.totalHours || 0;
|
|
|
|
// 비율(percentage) 계산 헬퍼 함수
|
|
const addPercentage = (item) => ({
|
|
...item,
|
|
hours: parseFloat(item.hours.toFixed(1)),
|
|
percentage: totalHours > 0 ? parseFloat((item.hours / totalHours * 100).toFixed(1)) : 0
|
|
});
|
|
|
|
const result = {
|
|
summary: {
|
|
...summary,
|
|
totalHours: parseFloat(totalHours.toFixed(1))
|
|
},
|
|
byProject: byProject.map(addPercentage),
|
|
byWorker: byWorker.map(addPercentage),
|
|
byTask: byTask.map(addPercentage),
|
|
details: details.map(d => ({
|
|
...d,
|
|
work_hours: parseFloat(d.work_hours.toFixed(1))
|
|
}))
|
|
};
|
|
|
|
logger.info('분석 데이터 조회 성공', {
|
|
startDate,
|
|
endDate,
|
|
totalHours: result.summary.totalHours,
|
|
projectCount: result.byProject.length,
|
|
workerCount: result.byWorker.length,
|
|
detailCount: result.details.length
|
|
});
|
|
|
|
return result;
|
|
} catch (error) {
|
|
logger.error('분석 데이터 조회 실패', {
|
|
startDate,
|
|
endDate,
|
|
error: error.message
|
|
});
|
|
throw new DatabaseError('분석 데이터 조회 중 오류가 발생했습니다');
|
|
}
|
|
};
|
|
|
|
module.exports = {
|
|
getAnalysisService
|
|
};
|