Files
TK-FB-Project/api.hyungi.net/controllers/monthlyStatusController.js
Hyungi Ahn 746e09420b feat: 캘린더 기반 작업 현황 확인 시스템 구현
- 월별 캘린더 UI로 작업 현황을 한눈에 확인 가능
- 미입력(빨강), 부분입력(주황), 확인필요(보라), 이상없음(초록) 상태 표시
- 범례 아이콘(●)을 사용한 직관적인 상태 표시
- 날짜 클릭 시 해당일 작업자별 상세 현황 모달
- 작업자 클릭 시 개별 작업 입력/수정 모달
- 휴가 처리 기능 (연차, 반차, 반반차, 조퇴)
- 월별 집계 데이터 최적화로 API 호출 최소화

백엔드:
- monthly_worker_status, monthly_summary 테이블 추가
- 자동 집계 stored procedure 및 trigger 구현
- 확인필요(12시간 초과) 상태 감지 로직
- 출석 관리 시스템 확장

프론트엔드:
- 캘린더 그리드 UI 구현
- 상태별 색상 및 아이콘 표시
- 모달 기반 상세 정보 표시
- 반응형 디자인 적용
2025-11-04 10:12:07 +09:00

202 lines
6.5 KiB
JavaScript

// controllers/monthlyStatusController.js
// 월별 작업자 상태 집계 컨트롤러
const MonthlyStatusModel = require('../models/monthlyStatusModel');
class MonthlyStatusController {
// 월별 캘린더 데이터 조회
static async getMonthlyCalendarData(req, res) {
try {
const { year, month } = req.query;
if (!year || !month) {
return res.status(400).json({
success: false,
message: '연도(year)와 월(month)이 필요합니다.'
});
}
const yearNum = parseInt(year);
const monthNum = parseInt(month);
if (yearNum < 2020 || yearNum > 2030 || monthNum < 1 || monthNum > 12) {
return res.status(400).json({
success: false,
message: '유효하지 않은 연도 또는 월입니다.'
});
}
console.log(`📅 월별 캘린더 데이터 조회: ${year}${month}`);
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 형식으로 변환
calendarData[dateKey] = {
totalWorkers: day.total_workers,
workingWorkers: day.working_workers,
hasIssues: day.has_issues,
hasErrors: day.has_errors,
hasOvertimeWarning: day.has_overtime_warning,
incompleteWorkers: day.incomplete_workers,
partialWorkers: day.partial_workers,
errorWorkers: day.error_workers,
overtimeWarningWorkers: day.overtime_warning_workers,
totalHours: parseFloat(day.total_work_hours || 0),
totalTasks: day.total_work_count,
errorCount: day.total_error_count,
lastUpdated: day.last_updated
};
});
res.json({
success: true,
data: calendarData,
message: `${year}${month}월 캘린더 데이터를 성공적으로 조회했습니다.`
});
} catch (error) {
console.error('월별 캘린더 데이터 조회 오류:', error);
res.status(500).json({
success: false,
message: '월별 캘린더 데이터 조회 중 오류가 발생했습니다.',
error: error.message
});
}
}
// 특정 날짜의 작업자별 상세 상태 조회
static async getDailyWorkerDetails(req, res) {
try {
const { date } = req.query;
if (!date) {
return res.status(400).json({
success: false,
message: '날짜(date)가 필요합니다.'
});
}
console.log(`👥 일별 작업자 상세 조회: ${date}`);
const workerDetails = await MonthlyStatusModel.getDailyWorkerStatus(date);
// 프론트엔드에서 사용하기 쉽도록 데이터 변환
const formattedData = workerDetails.map(worker => ({
workerId: worker.worker_id,
workerName: worker.worker_name,
jobType: worker.job_type,
totalHours: parseFloat(worker.total_work_hours || 0),
actualWorkHours: parseFloat(worker.actual_work_hours || 0),
vacationHours: parseFloat(worker.vacation_hours || 0),
totalWorkCount: worker.total_work_count,
regularWorkCount: worker.regular_work_count,
errorWorkCount: worker.error_work_count,
status: worker.work_status,
hasVacation: worker.has_vacation,
hasError: worker.has_error,
hasIssues: worker.has_issues,
lastUpdated: worker.last_updated
}));
// 요약 정보 계산
const summary = {
totalWorkers: formattedData.length,
totalHours: formattedData.reduce((sum, w) => sum + w.totalHours, 0),
totalTasks: formattedData.reduce((sum, w) => sum + w.totalWorkCount, 0),
errorCount: formattedData.reduce((sum, w) => sum + w.errorWorkCount, 0)
};
res.json({
success: true,
data: {
workers: formattedData,
summary
},
message: `${date} 작업자 상세 정보를 성공적으로 조회했습니다.`
});
} catch (error) {
console.error('일별 작업자 상세 조회 오류:', error);
res.status(500).json({
success: false,
message: '일별 작업자 상세 조회 중 오류가 발생했습니다.',
error: error.message
});
}
}
// 월별 집계 재계산 (관리자용)
static async recalculateMonth(req, res) {
try {
const { year, month } = req.body;
if (!year || !month) {
return res.status(400).json({
success: false,
message: '연도(year)와 월(month)이 필요합니다.'
});
}
// 관리자 권한 확인
if (req.user.role !== 'admin' && req.user.role !== 'system') {
return res.status(403).json({
success: false,
message: '관리자 권한이 필요합니다.'
});
}
console.log(`🔄 월별 집계 재계산 시작: ${year}${month}`);
const result = await MonthlyStatusModel.recalculateMonth(parseInt(year), parseInt(month));
res.json({
success: true,
data: result,
message: `${year}${month}월 집계 재계산이 완료되었습니다.`
});
} catch (error) {
console.error('월별 집계 재계산 오류:', error);
res.status(500).json({
success: false,
message: '월별 집계 재계산 중 오류가 발생했습니다.',
error: error.message
});
}
}
// 집계 테이블 상태 확인 (관리자용)
static async getStatusInfo(req, res) {
try {
// 관리자 권한 확인
if (req.user.role !== 'admin' && req.user.role !== 'system') {
return res.status(403).json({
success: false,
message: '관리자 권한이 필요합니다.'
});
}
const statusInfo = await MonthlyStatusModel.getStatusInfo();
res.json({
success: true,
data: statusInfo,
message: '집계 테이블 상태 정보를 성공적으로 조회했습니다.'
});
} catch (error) {
console.error('집계 테이블 상태 확인 오류:', error);
res.status(500).json({
success: false,
message: '집계 테이블 상태 확인 중 오류가 발생했습니다.',
error: error.message
});
}
}
}
module.exports = MonthlyStatusController;