Files
TK-FB-Project/api.hyungi.net/controllers/attendanceController.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

307 lines
8.3 KiB
JavaScript

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;