- 월별 캘린더 UI로 작업 현황을 한눈에 확인 가능 - 미입력(빨강), 부분입력(주황), 확인필요(보라), 이상없음(초록) 상태 표시 - 범례 아이콘(●)을 사용한 직관적인 상태 표시 - 날짜 클릭 시 해당일 작업자별 상세 현황 모달 - 작업자 클릭 시 개별 작업 입력/수정 모달 - 휴가 처리 기능 (연차, 반차, 반반차, 조퇴) - 월별 집계 데이터 최적화로 API 호출 최소화 백엔드: - monthly_worker_status, monthly_summary 테이블 추가 - 자동 집계 stored procedure 및 trigger 구현 - 확인필요(12시간 초과) 상태 감지 로직 - 출석 관리 시스템 확장 프론트엔드: - 캘린더 그리드 UI 구현 - 상태별 색상 및 아이콘 표시 - 모달 기반 상세 정보 표시 - 반응형 디자인 적용
282 lines
10 KiB
JavaScript
282 lines
10 KiB
JavaScript
const dailyWorkReportModel = require('../models/dailyWorkReportModel');
|
|
|
|
/**
|
|
* 일일 작업 보고서를 생성하는 비즈니스 로직을 처리합니다.
|
|
* @param {object} reportData - 컨트롤러에서 전달된 보고서 데이터
|
|
* @returns {Promise<object>} 생성 결과 또는 에러
|
|
*/
|
|
const createDailyWorkReportService = async (reportData) => {
|
|
const { report_date, worker_id, work_entries, created_by, created_by_name } = reportData;
|
|
|
|
// 1. 기본 유효성 검사
|
|
if (!report_date || !worker_id || !work_entries) {
|
|
throw new Error('필수 필드(report_date, worker_id, work_entries)가 누락되었습니다.');
|
|
}
|
|
|
|
if (!Array.isArray(work_entries) || work_entries.length === 0) {
|
|
throw new Error('최소 하나의 작업 항목(work_entries)이 필요합니다.');
|
|
}
|
|
|
|
if (!created_by) {
|
|
throw new Error('사용자 인증 정보(created_by)가 없습니다.');
|
|
}
|
|
|
|
// 2. 작업 항목 유효성 검사
|
|
for (let i = 0; i < work_entries.length; i++) {
|
|
const entry = work_entries[i];
|
|
const requiredFields = ['project_id', 'task_id', 'work_hours'];
|
|
|
|
for (const field of requiredFields) {
|
|
if (entry[field] === undefined || entry[field] === null || entry[field] === '') {
|
|
throw new Error(`작업 항목 ${i + 1}의 '${field}' 필드가 누락되었습니다.`);
|
|
}
|
|
}
|
|
|
|
// is_error가 true일 때 error_type_code_id 필수 검사
|
|
if (entry.is_error === true && !entry.error_type_code_id) {
|
|
throw new Error(`작업 항목 ${i + 1}이 에러 상태인 경우 'error_type_code_id'가 필요합니다.`);
|
|
}
|
|
|
|
const hours = parseFloat(entry.work_hours);
|
|
if (isNaN(hours) || hours <= 0 || hours > 24) {
|
|
throw new Error(`작업 항목 ${i + 1}의 작업 시간이 유효하지 않습니다 (0 초과 24 이하).`);
|
|
}
|
|
}
|
|
|
|
// 3. 모델에 전달할 데이터 준비
|
|
const modelData = {
|
|
report_date,
|
|
worker_id: parseInt(worker_id),
|
|
entries: work_entries.map(entry => ({
|
|
project_id: entry.project_id,
|
|
task_id: entry.task_id,
|
|
work_hours: parseFloat(entry.work_hours),
|
|
is_error: entry.is_error || false,
|
|
error_type_code_id: entry.error_type_code_id || null,
|
|
created_by_user_id: created_by
|
|
}))
|
|
};
|
|
|
|
console.log('📝 [Service] 작업보고서 생성 요청:', {
|
|
date: report_date,
|
|
worker: worker_id,
|
|
creator: created_by_name,
|
|
entries_count: modelData.entries.length
|
|
});
|
|
|
|
// 4. 모델 함수 호출
|
|
try {
|
|
const result = await dailyWorkReportModel.createReportEntries(modelData);
|
|
console.log('✅ [Service] 작업보고서 생성 성공:', result);
|
|
return {
|
|
message: '작업보고서가 성공적으로 생성되었습니다.',
|
|
...result
|
|
};
|
|
} catch (error) {
|
|
console.error('[Service] 작업보고서 생성 중 오류 발생:', error);
|
|
// 모델에서 발생한 오류를 그대로 상위로 전달
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* 사용자 권한과 요청 파라미터에 따라 일일 작업 보고서를 조회하는 비즈니스 로직을 처리합니다.
|
|
* @param {object} queryParams - 컨트롤러에서 전달된 쿼리 파라미터
|
|
* @param {object} userInfo - 요청을 보낸 사용자의 정보 (id, role 등)
|
|
* @returns {Promise<Array>} 조회된 작업 보고서 배열
|
|
*/
|
|
const getDailyWorkReportsService = async (queryParams, userInfo) => {
|
|
const { date, start_date, end_date, worker_id, created_by: requested_created_by, view_all } = queryParams;
|
|
const { user_id: current_user_id, role } = userInfo;
|
|
|
|
// 날짜 또는 날짜 범위 중 하나는 필수
|
|
if (!date && (!start_date || !end_date)) {
|
|
throw new Error('조회를 위해 날짜(date) 또는 날짜 범위(start_date, end_date)가 필요합니다.');
|
|
}
|
|
|
|
// 관리자 여부 확인
|
|
const isAdmin = role === 'system' || role === 'admin';
|
|
const canViewAll = isAdmin || view_all === 'true';
|
|
|
|
// 모델에 전달할 조회 옵션 객체 생성
|
|
const options = {};
|
|
|
|
if (date) {
|
|
options.date = date;
|
|
} else {
|
|
options.start_date = start_date;
|
|
options.end_date = end_date;
|
|
}
|
|
|
|
if (worker_id) {
|
|
options.worker_id = parseInt(worker_id);
|
|
}
|
|
|
|
// 최종적으로 필터링할 작성자 ID 결정
|
|
if (!canViewAll) {
|
|
// 관리자가 아니면 자신의 데이터만 보거나, 명시적으로 요청된 자신의 ID만 허용
|
|
options.created_by_user_id = requested_created_by ? Math.min(requested_created_by, current_user_id) : current_user_id;
|
|
} else if (requested_created_by) {
|
|
// 관리자는 다른 사람의 데이터도 조회 가능
|
|
options.created_by_user_id = parseInt(requested_created_by);
|
|
}
|
|
// created_by_user_id가 명시되지 않으면 모든 작성자의 데이터를 조회
|
|
|
|
console.log('📊 [Service] 작업보고서 조회 요청:', { ...options, requester: current_user_id, isAdmin });
|
|
|
|
try {
|
|
// 모델 함수 호출
|
|
const reports = await dailyWorkReportModel.getReportsWithOptions(options);
|
|
console.log(`✅ [Service] 작업보고서 ${reports.length}개 조회 성공`);
|
|
return reports;
|
|
} catch (error) {
|
|
console.error('[Service] 작업보고서 조회 중 오류 발생:', error);
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* 특정 작업 보고서 항목을 수정하는 비즈니스 로직을 처리합니다.
|
|
* @param {string} reportId - 수정할 보고서의 ID
|
|
* @param {object} updateData - 수정할 데이터
|
|
* @param {object} userInfo - 요청을 보낸 사용자의 정보
|
|
* @returns {Promise<object>} 수정 결과
|
|
*/
|
|
const updateWorkReportService = async (reportId, updateData, userInfo) => {
|
|
const { user_id: updated_by } = userInfo;
|
|
|
|
if (!reportId || !updateData || Object.keys(updateData).length === 0) {
|
|
throw new Error('수정을 위해 보고서 ID와 수정할 데이터가 필요합니다.');
|
|
}
|
|
|
|
const modelUpdateData = { ...updateData, updated_by_user_id: updated_by };
|
|
|
|
console.log(`✏️ [Service] 작업보고서 수정 요청: id=${reportId}`);
|
|
|
|
try {
|
|
const affectedRows = await dailyWorkReportModel.updateReportById(reportId, modelUpdateData);
|
|
|
|
if (affectedRows === 0) {
|
|
// 에러를 발생시켜 컨트롤러에서 404 처리를 할 수 있도록 함
|
|
const notFoundError = new Error('수정할 작업보고서를 찾을 수 없습니다.');
|
|
notFoundError.statusCode = 404;
|
|
throw notFoundError;
|
|
}
|
|
|
|
console.log(`✅ [Service] 작업보고서 수정 성공: id=${reportId}`);
|
|
return {
|
|
message: '작업보고서가 성공적으로 수정되었습니다.',
|
|
report_id: reportId,
|
|
affected_rows: affectedRows
|
|
};
|
|
} catch (error) {
|
|
console.error(`[Service] 작업보고서 수정 중 오류 발생 (id: ${reportId}):`, error);
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* 특정 작업 보고서 항목을 삭제하는 비즈니스 로직을 처리합니다.
|
|
* @param {string} reportId - 삭제할 보고서의 ID
|
|
* @param {object} userInfo - 요청을 보낸 사용자의 정보
|
|
* @returns {Promise<object>} 삭제 결과
|
|
*/
|
|
const removeDailyWorkReportService = async (reportId, userInfo) => {
|
|
const { user_id: deleted_by } = userInfo;
|
|
|
|
if (!reportId) {
|
|
throw new Error('삭제를 위해 보고서 ID가 필요합니다.');
|
|
}
|
|
|
|
console.log(`🗑️ [Service] 작업보고서 삭제 요청: id=${reportId}`);
|
|
|
|
try {
|
|
// 모델 함수는 삭제 전 권한 검사를 위해 deleted_by 정보를 받을 수 있습니다 (현재 모델에서는 미사용).
|
|
const affectedRows = await dailyWorkReportModel.removeReportById(reportId, deleted_by);
|
|
|
|
if (affectedRows === 0) {
|
|
const notFoundError = new Error('삭제할 작업보고서를 찾을 수 없습니다.');
|
|
notFoundError.statusCode = 404;
|
|
throw notFoundError;
|
|
}
|
|
|
|
console.log(`✅ [Service] 작업보고서 삭제 성공: id=${reportId}`);
|
|
return {
|
|
message: '작업보고서가 성공적으로 삭제되었습니다.',
|
|
report_id: reportId,
|
|
affected_rows: affectedRows
|
|
};
|
|
} catch (error) {
|
|
console.error(`[Service] 작업보고서 삭제 중 오류 발생 (id: ${reportId}):`, error);
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* 기간별 작업 보고서 통계를 조회하는 비즈니스 로직을 처리합니다.
|
|
* @param {object} queryParams - 컨트롤러에서 전달된 쿼리 파라미터 (start_date, end_date)
|
|
* @returns {Promise<object>} 통계 데이터
|
|
*/
|
|
const getStatisticsService = async (queryParams) => {
|
|
const { start_date, end_date } = queryParams;
|
|
|
|
if (!start_date || !end_date) {
|
|
throw new Error('통계 조회를 위해 시작일(start_date)과 종료일(end_date)이 모두 필요합니다.');
|
|
}
|
|
|
|
console.log(`📈 [Service] 통계 조회 요청: ${start_date} ~ ${end_date}`);
|
|
|
|
try {
|
|
// 모델의 getStatistics 함수가 Promise를 반환하도록 수정 필요
|
|
const statsData = await dailyWorkReportModel.getStatistics(start_date, end_date);
|
|
|
|
console.log('✅ [Service] 통계 조회 성공');
|
|
return {
|
|
...statsData,
|
|
metadata: {
|
|
period: `${start_date} ~ ${end_date}`,
|
|
timestamp: new Date().toISOString()
|
|
}
|
|
};
|
|
} catch (error) {
|
|
console.error('[Service] 통계 조회 중 오류 발생:', error);
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* 일일 또는 작업자별 작업 요약 정보를 조회하는 비즈니스 로직을 처리합니다.
|
|
* @param {object} queryParams - 컨트롤러에서 전달된 쿼리 파라미터 (date 또는 worker_id)
|
|
* @returns {Promise<object>} 요약 데이터
|
|
*/
|
|
const getSummaryService = async (queryParams) => {
|
|
const { date, worker_id } = queryParams;
|
|
|
|
if (!date && !worker_id) {
|
|
throw new Error('일일 또는 작업자별 요약 조회를 위해 날짜(date) 또는 작업자 ID(worker_id)가 필요합니다.');
|
|
}
|
|
|
|
try {
|
|
if (date) {
|
|
console.log(`📊 [Service] 일일 요약 조회 요청: date=${date}`);
|
|
// 모델의 getSummaryByDate 함수가 Promise를 반환하도록 수정 필요
|
|
return await dailyWorkReportModel.getSummaryByDate(date);
|
|
} else { // worker_id
|
|
console.log(`📊 [Service] 작업자별 요약 조회 요청: worker_id=${worker_id}`);
|
|
// 모델의 getSummaryByWorker 함수가 Promise를 반환하도록 수정 필요
|
|
return await dailyWorkReportModel.getSummaryByWorker(worker_id);
|
|
}
|
|
} catch (error) {
|
|
console.error('[Service] 요약 정보 조회 중 오류 발생:', error);
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
module.exports = {
|
|
createDailyWorkReportService,
|
|
getDailyWorkReportsService,
|
|
updateWorkReportService,
|
|
removeDailyWorkReportService,
|
|
getStatisticsService,
|
|
getSummaryService,
|
|
};
|