tk-factory-services/system1-factory/api/controllers/attendanceController.js

/**
 * 근태 관리 컨트롤러
 *
 * 근태 기록 API 엔드포인트 핸들러
 *
 * @author TK-FB-Project
 * @since 2025-12-11
 */

const attendanceService = require('../services/attendanceService');
const { asyncHandler } = require('../middlewares/errorHandler');

/**
 * 일일 근태 현황 조회 (대시보드용)
 */
const getDailyAttendanceStatus = asyncHandler(async (req, res) => {
  const { date } = req.query;
  const data = await attendanceService.getDailyAttendanceStatusService(date);

  res.json({
    success: true,
    data,
    message: '근태 현황을 성공적으로 조회했습니다'
  });
});

/**
 * 일일 근태 기록 조회
 */
const getDailyAttendanceRecords = asyncHandler(async (req, res) => {
  const { date, user_id } = req.query;
  const data = await attendanceService.getDailyAttendanceRecordsService(date, user_id);

  res.json({
    success: true,
    data,
    message: '근태 기록을 성공적으로 조회했습니다'
  });
});

/**
 * 기간별 근태 기록 조회 (월별 조회용)
 */
const getAttendanceRecordsByRange = asyncHandler(async (req, res) => {
  const { start_date, end_date, user_id } = req.query;
  const data = await attendanceService.getAttendanceRecordsByRangeService(start_date, end_date, user_id);

  res.json({
    success: true,
    data,
    message: '근태 기록을 성공적으로 조회했습니다'
  });
});

/**
 * 근태 기록 생성/업데이트
 */
const upsertAttendanceRecord = asyncHandler(async (req, res) => {
  const recordData = {
    ...req.body,
    created_by: req.user?.user_id || req.user?.id
  };

  const result = await attendanceService.upsertAttendanceRecordService(recordData);

  res.json({
    success: true,
    data: result,
    message: '근태 기록이 성공적으로 저장되었습니다'
  });
});

/**
 * 휴가 처리
 */
const processVacation = asyncHandler(async (req, res) => {
  const vacationData = {
    record_date: req.body.date,
    user_id: req.body.user_id,
    vacation_type_id: req.body.vacation_type,
    created_by: req.user?.user_id || req.user?.id
  };

  const result = await attendanceService.processVacationService(vacationData);

  res.json({
    success: true,
    data: result,
    message: '휴가 처리가 성공적으로 완료되었습니다'
  });
});

/**
 * 초과근무 승인
 */
const approveOvertime = asyncHandler(async (req, res) => {
  const overtimeData = {
    record_date: req.body.date,
    user_id: req.body.user_id,
    overtime_approved: true,
    approved_by: req.user?.user_id || req.user?.id
  };

  const result = await attendanceService.approveOvertimeService(overtimeData);

  res.json({
    success: true,
    data: result,
    message: '초과근무가 성공적으로 승인되었습니다'
  });
});

/**
 * 근로 유형 목록 조회
 */
const getAttendanceTypes = asyncHandler(async (req, res) => {
  const data = await attendanceService.getAttendanceTypesService();

  res.json({
    success: true,
    data,
    message: '근로 유형 목록을 성공적으로 조회했습니다'
  });
});

/**
 * 휴가 유형 목록 조회
 */
const getVacationTypes = asyncHandler(async (req, res) => {
  const data = await attendanceService.getVacationTypesService();

  res.json({
    success: true,
    data,
    message: '휴가 유형 목록을 성공적으로 조회했습니다'
  });
});

/**
 * 작업자 휴가 잔여 조회
 */
const getWorkerVacationBalance = asyncHandler(async (req, res) => {
  const { user_id } = req.params;
  const data = await attendanceService.getWorkerVacationBalanceService(parseInt(user_id));

  res.json({
    success: true,
    data,
    message: '휴가 잔여 정보를 성공적으로 조회했습니다'
  });
});

/**
 * 월별 근태 통계
 */
const getMonthlyAttendanceStats = asyncHandler(async (req, res) => {
  const { year, month, user_id } = req.query;
  const data = await attendanceService.getMonthlyAttendanceStatsService(
    parseInt(year),
    parseInt(month),
    user_id ? parseInt(user_id) : null
  );

  res.json({
    success: true,
    data,
    message: '월별 근태 통계를 성공적으로 조회했습니다'
  });
});

/**
 * 출근 체크 목록 조회 (아침용, 휴가 정보 포함)
 */
const getCheckinList = asyncHandler(async (req, res) => {
  const { date } = req.query;
  const data = await attendanceService.getCheckinListService(date);

  res.json({
    success: true,
    data,
    message: '출근 체크 목록을 성공적으로 조회했습니다'
  });
});

/**
 * 출근 체크 저장 (일괄 처리)
 */
const saveCheckins = asyncHandler(async (req, res) => {
  const { date, checkins } = req.body; // checkins: [{user_id, is_present}, ...]
  const result = await attendanceService.saveCheckinsService(date, checkins);

  res.json({
    success: true,
    data: result,
    message: '출근 체크가 성공적으로 저장되었습니다'
  });
});

module.exports = {
  getDailyAttendanceStatus,
  getDailyAttendanceRecords,
  getAttendanceRecordsByRange,
  upsertAttendanceRecord,
  processVacation,
  approveOvertime,
  getAttendanceTypes,
  getVacationTypes,
  getWorkerVacationBalance,
  getMonthlyAttendanceStats,
  getCheckinList,
  saveCheckins
};