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

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

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

deploy/tkfb-package/api.hyungi.net/middlewares/errorHandler.js

@@ -0,0 +1,102 @@
+/**
+ * 에러 핸들러 미들웨어
+ *
+ * 애플리케이션 전역 에러를 처리하는 Express 미들웨어
+ *
+ * @author TK-FB-Project
+ * @since 2025-12-11
+ */
+
+const { AppError } = require('../utils/errors');
+const logger = require('../utils/logger');
+
+/**
+ * 에러 응답 포맷터
+ */
+const formatErrorResponse = (error, req) => {
+  const response = {
+    success: false,
+    error: {
+      message: error.message || '알 수 없는 오류가 발생했습니다',
+      code: error.code || 'INTERNAL_ERROR'
+    },
+    timestamp: new Date().toISOString()
+  };
+
+  // 검증 에러의 경우 상세 정보 포함
+  if (error.details) {
+    response.error.details = error.details;
+  }
+
+  // 개발 환경에서만 스택 트레이스 포함
+  if (process.env.NODE_ENV === 'development') {
+    response.error.stack = error.stack;
+    response.request = {
+      method: req.method,
+      url: req.originalUrl,
+      ip: req.ip,
+      user: req.user?.username || 'anonymous'
+    };
+  }
+
+  return response;
+};
+
+/**
+ * 에러 핸들러 미들웨어
+ */
+const errorHandler = (error, req, res, next) => {
+  // AppError가 아닌 경우 변환
+  if (!(error instanceof AppError)) {
+    error = new AppError(
+      error.message || '서버 내부 오류가 발생했습니다',
+      500,
+      'INTERNAL_ERROR'
+    );
+  }
+
+  // 로깅
+  if (error.statusCode >= 500) {
+    logger.error(error.message, {
+      code: error.code,
+      stack: error.stack,
+      url: req.originalUrl,
+      method: req.method,
+      user: req.user?.username || 'anonymous'
+    });
+  } else {
+    logger.warn(error.message, {
+      code: error.code,
+      url: req.originalUrl,
+      method: req.method,
+      user: req.user?.username || 'anonymous'
+    });
+  }
+
+  // 응답
+  const response = formatErrorResponse(error, req);
+  res.status(error.statusCode).json(response);
+};
+
+/**
+ * 비동기 함수 래퍼 (에러 자동 처리)
+ */
+const asyncHandler = (fn) => {
+  return (req, res, next) => {
+    Promise.resolve(fn(req, res, next)).catch(next);
+  };
+};
+
+/**
+ * 404 Not Found 핸들러
+ */
+const notFoundHandler = (req, res, next) => {
+  const { NotFoundError } = require('../utils/errors');
+  next(new NotFoundError(`경로를 찾을 수 없습니다: ${req.originalUrl}`));
+};
+
+module.exports = {
+  errorHandler,
+  asyncHandler,
+  notFoundHandler
+};