feat: 다수 기능 개선 - 순찰, 출근, 작업분석, 모바일 UI 등

- 순찰/점검 기능 개선 (zone-detail 페이지 추가)
- 출근/근태 시스템 개선 (연차 조회, 근무현황)
- 작업분석 대분류 그룹화 및 마이그레이션 스크립트
- 모바일 네비게이션 UI 추가
- NAS 배포 도구 및 문서 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

deploy/tkfb-package/api.hyungi.net/controllers/attendanceController.js

@@ -0,0 +1,212 @@
+/**
+ * 근태 관리 컨트롤러
+ *
+ * 근태 기록 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, worker_id } = req.query;
+  const data = await attendanceService.getDailyAttendanceRecordsService(date, worker_id);
+
+  res.json({
+    success: true,
+    data,
+    message: '근태 기록을 성공적으로 조회했습니다'
+  });
+});
+
+/**
+ * 기간별 근태 기록 조회 (월별 조회용)
+ */
+const getAttendanceRecordsByRange = asyncHandler(async (req, res) => {
+  const { start_date, end_date, worker_id } = req.query;
+  const data = await attendanceService.getAttendanceRecordsByRangeService(start_date, end_date, worker_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,
+    worker_id: req.body.worker_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,
+    worker_id: req.body.worker_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 { worker_id } = req.params;
+  const data = await attendanceService.getWorkerVacationBalanceService(parseInt(worker_id));
+
+  res.json({
+    success: true,
+    data,
+    message: '휴가 잔여 정보를 성공적으로 조회했습니다'
+  });
+});
+
+/**
+ * 월별 근태 통계
+ */
+const getMonthlyAttendanceStats = asyncHandler(async (req, res) => {
+  const { year, month, worker_id } = req.query;
+  const data = await attendanceService.getMonthlyAttendanceStatsService(
+    parseInt(year),
+    parseInt(month),
+    worker_id ? parseInt(worker_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: [{worker_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
+};