feat: 캘린더 기반 작업 현황 확인 시스템 구현
- 월별 캘린더 UI로 작업 현황을 한눈에 확인 가능 - 미입력(빨강), 부분입력(주황), 확인필요(보라), 이상없음(초록) 상태 표시 - 범례 아이콘(●)을 사용한 직관적인 상태 표시 - 날짜 클릭 시 해당일 작업자별 상세 현황 모달 - 작업자 클릭 시 개별 작업 입력/수정 모달 - 휴가 처리 기능 (연차, 반차, 반반차, 조퇴) - 월별 집계 데이터 최적화로 API 호출 최소화 백엔드: - monthly_worker_status, monthly_summary 테이블 추가 - 자동 집계 stored procedure 및 trigger 구현 - 확인필요(12시간 초과) 상태 감지 로직 - 출석 관리 시스템 확장 프론트엔드: - 캘린더 그리드 UI 구현 - 상태별 색상 및 아이콘 표시 - 모달 기반 상세 정보 표시 - 반응형 디자인 적용
This commit is contained in:
Hyungi Ahn
306
api.hyungi.net/controllers/attendanceController.js
Normal file
306
api.hyungi.net/controllers/attendanceController.js
Normal file
@@ -0,0 +1,306 @@
|
||||
const AttendanceModel = require('../models/attendanceModel');
|
||||
|
||||
class AttendanceController {
|
||||
// 일일 근태 현황 조회 (대시보드용)
|
||||
static async getDailyAttendanceStatus(req, res) {
|
||||
try {
|
||||
const { date } = req.query;
|
||||
|
||||
if (!date) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '날짜가 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const attendanceStatus = await AttendanceModel.getWorkerAttendanceStatus(date);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: attendanceStatus,
|
||||
message: '근태 현황을 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('근태 현황 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '근태 현황 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 일일 근태 기록 조회
|
||||
static async getDailyAttendanceRecords(req, res) {
|
||||
try {
|
||||
const { date, worker_id } = req.query;
|
||||
|
||||
if (!date) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '날짜가 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const records = await AttendanceModel.getDailyAttendanceRecords(date, worker_id);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: records,
|
||||
message: '근태 기록을 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('근태 기록 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '근태 기록 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 근태 기록 생성/업데이트
|
||||
static async upsertAttendanceRecord(req, res) {
|
||||
try {
|
||||
const {
|
||||
record_date,
|
||||
worker_id,
|
||||
total_work_hours,
|
||||
attendance_type_id,
|
||||
vacation_type_id,
|
||||
is_vacation_processed,
|
||||
overtime_approved,
|
||||
status,
|
||||
notes
|
||||
} = req.body;
|
||||
|
||||
// 필수 필드 검증
|
||||
if (!record_date || !worker_id) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '날짜와 작업자 ID가 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const recordData = {
|
||||
record_date,
|
||||
worker_id,
|
||||
total_work_hours: total_work_hours || 0,
|
||||
attendance_type_id,
|
||||
vacation_type_id,
|
||||
is_vacation_processed: is_vacation_processed || false,
|
||||
overtime_approved: overtime_approved || false,
|
||||
status: status || 'incomplete',
|
||||
notes,
|
||||
created_by: req.user.user_id
|
||||
};
|
||||
|
||||
const result = await AttendanceModel.upsertAttendanceRecord(recordData);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: result,
|
||||
message: '근태 기록이 성공적으로 저장되었습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('근태 기록 저장 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '근태 기록 저장 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 휴가 처리
|
||||
static async processVacation(req, res) {
|
||||
try {
|
||||
const { worker_id, date, vacation_type } = req.body;
|
||||
|
||||
// 필수 필드 검증
|
||||
if (!worker_id || !date || !vacation_type) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '작업자 ID, 날짜, 휴가 유형이 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
// 휴가 유형 검증
|
||||
const validVacationTypes = ['ANNUAL_FULL', 'ANNUAL_HALF', 'ANNUAL_QUARTER'];
|
||||
if (!validVacationTypes.includes(vacation_type)) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '유효하지 않은 휴가 유형입니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const result = await AttendanceModel.processVacation(
|
||||
worker_id,
|
||||
date,
|
||||
vacation_type,
|
||||
req.user.user_id
|
||||
);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: result,
|
||||
message: '휴가 처리가 성공적으로 완료되었습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('휴가 처리 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '휴가 처리 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 초과근무 승인
|
||||
static async approveOvertime(req, res) {
|
||||
try {
|
||||
const { worker_id, date } = req.body;
|
||||
|
||||
// 필수 필드 검증
|
||||
if (!worker_id || !date) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '작업자 ID와 날짜가 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const result = await AttendanceModel.approveOvertime(
|
||||
worker_id,
|
||||
date,
|
||||
req.user.user_id
|
||||
);
|
||||
|
||||
if (result) {
|
||||
res.json({
|
||||
success: true,
|
||||
message: '초과근무가 성공적으로 승인되었습니다.'
|
||||
});
|
||||
} else {
|
||||
res.status(404).json({
|
||||
success: false,
|
||||
message: '해당 날짜의 근태 기록을 찾을 수 없습니다.'
|
||||
});
|
||||
}
|
||||
} catch (error) {
|
||||
console.error('초과근무 승인 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '초과근무 승인 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 근로 유형 목록 조회
|
||||
static async getAttendanceTypes(req, res) {
|
||||
try {
|
||||
const attendanceTypes = await AttendanceModel.getAttendanceTypes();
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: attendanceTypes,
|
||||
message: '근로 유형 목록을 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('근로 유형 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '근로 유형 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 휴가 유형 목록 조회
|
||||
static async getVacationTypes(req, res) {
|
||||
try {
|
||||
const vacationTypes = await AttendanceModel.getVacationTypes();
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: vacationTypes,
|
||||
message: '휴가 유형 목록을 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('휴가 유형 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '휴가 유형 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 작업자 휴가 잔여 조회
|
||||
static async getWorkerVacationBalance(req, res) {
|
||||
try {
|
||||
const { worker_id } = req.params;
|
||||
const { year } = req.query;
|
||||
|
||||
if (!worker_id) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '작업자 ID가 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const balance = await AttendanceModel.getWorkerVacationBalance(
|
||||
parseInt(worker_id),
|
||||
year ? parseInt(year) : null
|
||||
);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: balance,
|
||||
message: '휴가 잔여 정보를 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('휴가 잔여 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '휴가 잔여 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// 월별 근태 통계
|
||||
static async getMonthlyAttendanceStats(req, res) {
|
||||
try {
|
||||
const { year, month, worker_id } = req.query;
|
||||
|
||||
if (!year || !month) {
|
||||
return res.status(400).json({
|
||||
success: false,
|
||||
message: '연도와 월이 필요합니다.'
|
||||
});
|
||||
}
|
||||
|
||||
const stats = await AttendanceModel.getMonthlyAttendanceStats(
|
||||
parseInt(year),
|
||||
parseInt(month),
|
||||
worker_id ? parseInt(worker_id) : null
|
||||
);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: stats,
|
||||
message: '월별 근태 통계를 성공적으로 조회했습니다.'
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('월별 근태 통계 조회 오류:', error);
|
||||
res.status(500).json({
|
||||
success: false,
|
||||
message: '월별 근태 통계 조회 중 오류가 발생했습니다.',
|
||||
error: error.message
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = AttendanceController;
|
||||
201
api.hyungi.net/controllers/monthlyStatusController.js
Normal file
201
api.hyungi.net/controllers/monthlyStatusController.js
Normal file
@@ -0,0 +1,201 @@
|
||||
// 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;
|
||||
Reference in New Issue
Block a user