✨ 주요 기능
- 프로젝트별 → 작업유형별 데이터 취합 및 표시
- Production Report 스타일 테이블 구현
- 연차/휴무 별도 처리 (주말 제외, 녹색 테마)
- Job No. 정확한 표시 (중복 제거)
🔧 API 개선
- recent-work API에 job_no 필드 추가
- MySQL 쿼리 결과 처리 수정 (results[0] 사용)
- Projects 테이블 대소문자 조인 문제 해결
🎨 UI/UX 개선
- 탭 기반 분석 인터페이스
- 색상 팔레트 개선 (파란색/녹색/노란색 계열)
- 텍스트 방향 수정 (가로 표시)
- 프로젝트별 합계 행 추가
📊 계산 로직
- 공수: 시간 ÷ 8
- 부하율: (개별 시간 ÷ 전체 시간) × 100%
- 인건비: 공수 × 350,000원
- 주말 연차 자동 제외
✨ 새로운 기능:
- 작업 분석 페이지 구현 (기간별, 프로젝트별, 작업자별, 오류별)
- 개별 분석 실행 버튼으로 API 부하 최적화
- 연차/휴무 집계 방식 개선 (주말 제외, 작업내용 통합)
- 프로젝트 관리 시스템 (활성화/비활성화)
- 작업자 관리 시스템 (CRUD 기능)
- 코드 관리 시스템 (작업유형, 작업상태, 오류유형)
🎨 UI/UX 개선:
- 기간별 작업 현황을 테이블 형태로 변경
- 작업자별 rowspan 그룹화로 가독성 향상
- 연차/휴무 프로젝트 하단 배치 및 시각적 구분
- 기간 확정 시스템으로 사용자 경험 개선
- 반응형 디자인 적용
🔧 기술적 개선:
- Rate Limiting 제거 (내부 시스템 최적화)
- 주말 연차/휴무 자동 제외 로직
- 작업공수 계산 정확도 향상
- 데이터베이스 마이그레이션 추가
- API 엔드포인트 확장 및 최적화
🐛 버그 수정:
- projectSelect 요소 참조 오류 해결
- 차트 높이 무한 증가 문제 해결
- 날짜 표시 형식 단순화
- 작업보고서 저장 validation 오류 수정
- 월별 캘린더 UI로 작업 현황을 한눈에 확인 가능
- 미입력(빨강), 부분입력(주황), 확인필요(보라), 이상없음(초록) 상태 표시
- 범례 아이콘(●)을 사용한 직관적인 상태 표시
- 날짜 클릭 시 해당일 작업자별 상세 현황 모달
- 작업자 클릭 시 개별 작업 입력/수정 모달
- 휴가 처리 기능 (연차, 반차, 반반차, 조퇴)
- 월별 집계 데이터 최적화로 API 호출 최소화
백엔드:
- monthly_worker_status, monthly_summary 테이블 추가
- 자동 집계 stored procedure 및 trigger 구현
- 확인필요(12시간 초과) 상태 감지 로직
- 출석 관리 시스템 확장
프론트엔드:
- 캘린더 그리드 UI 구현
- 상태별 색상 및 아이콘 표시
- 모달 기반 상세 정보 표시
- 반응형 디자인 적용
- 통합 캐싱 시스템 구축:
* utils/cache.js: Redis + 메모리 캐시 하이브리드 시스템
* Redis 연결 실패 시 자동 메모리 캐시 fallback
* 캐시 키 생성, TTL 관리, 패턴 기반 무효화
* 캐시 미들웨어 및 무효화 헬퍼 함수
- 데이터베이스 쿼리 최적화:
* utils/queryOptimizer.js: 쿼리 성능 분석 및 최적화
* 페이지네이션 헬퍼 (최대 100개 제한)
* 인덱스 최적화 제안 시스템
* 배치 삽입 최적화 (100개 단위)
* 최적화된 쿼리 템플릿 (작업자, 프로젝트, 작업보고서)
- 응답 압축 및 최적화:
* gzip 압축 미들웨어 (1KB 이상, 레벨 6)
* 압축 제외 헤더 지원 (x-no-compression)
* 성능 모니터링 시스템
- 성능 모니터링 API:
* /api/performance/* 엔드포인트 추가
* 캐시 통계 및 관리 (조회, 초기화)
* DB 성능 통계 (연결 수, 슬로우 쿼리)
* 인덱스 분석 및 최적화 제안
* 쿼리 실행 계획 분석 (EXPLAIN)
* 시스템 리소스 모니터링
- 실제 적용 사례:
* workerController.js에 캐싱 및 페이지네이션 적용
* 캐시 히트/미스 로깅
* 캐시 무효화 자동 처리
- 보안 및 권한:
* 성능 관련 API는 관리자 권한 필요
* 쿼리 분석은 시스템/관리자만 접근 가능
* 캐시 초기화는 관리자 전용
- Swagger 문서화:
* 모든 성능 API 완전 문서화
* 요청/응답 스키마 및 예시 포함
- 새로운 에러 처리 시스템 적용:
* asyncHandler로 비동기 함수 래핑
* ApiError 클래스로 유효성 검사 에러 처리
* handleDatabaseError로 DB 에러 표준화
* handleNotFoundError로 404 에러 표준화
- 새로운 응답 포맷터 적용:
* res.created() - 작업 생성 성공 응답
* res.list() - 작업 목록 조회 응답
* res.success() - 단일 작업 조회 응답
* res.updated() - 작업 수정 성공 응답
* res.deleted() - 작업 삭제 성공 응답
- 유효성 검사 개선:
* ID 파라미터 유효성 검사 추가
* NaN 체크로 잘못된 ID 요청 차단
- 함수별 개선사항:
* createTask: 생성 응답 포맷터 적용
* getAllTasks: 목록 응답 포맷터 적용
* getTaskById: ID 검증 및 404 처리 개선
* updateTask: ID 검증 및 수정 응답 포맷터
* removeTask: ID 검증 및 삭제 응답 포맷터
- 새로운 에러 처리 시스템 적용:
* asyncHandler로 비동기 함수 래핑
* ApiError 클래스로 유효성 검사 에러 처리
* handleDatabaseError로 DB 에러 표준화
- 새로운 응답 포맷터 적용:
* res.created() - 작업보고서 생성 성공 응답
* res.success() - 기여자별 요약 조회 응답
- 유효성 검사 시스템 적용:
* validateSchema로 스키마 기반 검증
* schemas.createDailyWorkReport 스키마 사용
- 함수별 개선사항:
* createDailyWorkReport: 스키마 검증 및 생성 응답 포맷터
* getContributorsSummary: Promise 래핑 및 성공 응답 포맷터
- 참고: 파일이 크므로 핵심 함수들만 우선 적용
추후 나머지 함수들도 점진적으로 리팩토링 예정
- 새로운 에러 처리 시스템 적용:
* asyncHandler로 비동기 함수 래핑
* ApiError 클래스로 유효성 검사 에러 처리
* handleDatabaseError로 DB 에러 표준화
* handleNotFoundError로 404 에러 표준화
- 새로운 응답 포맷터 적용:
* res.created() - 프로젝트 생성 성공 응답
* res.list() - 프로젝트 목록 조회 응답
* res.success() - 단일 프로젝트 조회 응답
* res.updated() - 프로젝트 수정 성공 응답
* res.deleted() - 프로젝트 삭제 성공 응답
- 유효성 검사 시스템 적용:
* validateSchema로 스키마 기반 검증
* schemas.createProject 스키마 사용
* ID 파라미터 유효성 검사 추가
- 함수별 개선사항:
* createProject: 스키마 검증 및 생성 응답 포맷터
* getAllProjects: 목록 응답 포맷터 적용
* getProjectById: ID 검증 및 404 처리 개선
* updateProject: ID 검증 및 수정 응답 포맷터
* removeProject: ID 검증 및 삭제 응답 포맷터
- 새로운 에러 처리 시스템 적용:
* asyncHandler로 비동기 함수 래핑
* ApiError 클래스로 유효성 검사 에러 처리
* handleDatabaseError로 DB 에러 표준화
* handleNotFoundError로 404 에러 표준화
- 새로운 응답 포맷터 적용:
* res.created() - 작업자 생성 성공 응답
* res.list() - 작업자 목록 조회 응답
* res.success() - 단일 작업자 조회 응답
* res.updated() - 작업자 수정 성공 응답
* res.deleted() - 작업자 삭제 성공 응답
- 유효성 검사 시스템 적용:
* validateSchema로 스키마 기반 검증
* schemas.createWorker 스키마 사용
* ID 파라미터 유효성 검사 추가
- 함수별 개선사항:
* createWorker: 스키마 검증 및 생성 응답 포맷터
* getAllWorkers: 목록 응답 포맷터 적용
* getWorkerById: ID 검증 및 404 처리 개선
* updateWorker: ID 검증 및 수정 응답 포맷터
* removeWorker: ID 검증 및 삭제 응답 포맷터
- 새로운 에러 처리 시스템 적용:
* asyncHandler로 비동기 함수 래핑
* ApiError 클래스 사용으로 일관된 에러 처리
* handleDatabaseError로 DB 에러 표준화
- 새로운 응답 포맷터 적용:
* res.health() - 시스템 상태 응답
* res.success() - 일반 성공 응답
* res.list() - 목록 조회 응답
* res.created() - 생성 성공 응답
- 유효성 검사 시스템 적용:
* validateSchema로 스키마 기반 검증
* schemas.createUser 스키마 사용
- 함수별 개선사항:
* getSystemStatus: 헬스체크 포맷터 적용
* getDatabaseStatus: 성공 응답 포맷터 적용
* getAllUsers: 목록 응답 포맷터 적용
* createUser: 스키마 검증 및 생성 응답 포맷터 적용
- 통합 에러 처리 시스템 구축:
* utils/errorHandler.js: ApiError 클래스 및 에러 미들웨어
* 데이터베이스, 유효성 검사, 권한 에러 표준화
* 비동기 함수 래퍼 (asyncHandler) 추가
- 응답 포맷터 시스템 구축:
* utils/responseFormatter.js: 일관된 API 응답 형식
* 성공, 페이지네이션, 인증, 파일업로드 등 전용 포맷터
* Express 응답 확장 미들웨어
- 유효성 검사 시스템 구축:
* utils/validator.js: 스키마 기반 유효성 검사
* 필수 필드, 타입, 길이, 형식 검사 함수들
* 일반적인 스키마 정의 (사용자, 프로젝트, 작업보고서 등)
- 코드 정리 및 표준화:
* 삭제된 테이블 참조 제거 (work_report_audit_log 등)
* 대문자 테이블명을 소문자로 통일 (Users -> users)
* authController.js에 새로운 유틸리티 적용 예시
- 미들웨어 통합:
* index.js에 에러 핸들러 및 응답 포맷터 적용
* 헬스체크 엔드포인트 개선
- 삭제된 DB 테이블들과 관련 코드 정리:
* 12개 사용하지 않는 테이블 삭제 (activity_logs, CuttingPlan, DailyIssueReports 등)
* 관련 모델, 컨트롤러, 라우트 파일들 삭제
* index.js에서 삭제된 라우트들 제거
- 웹 UI 페이지 정리:
* 21개 사용하지 않는 페이지 삭제
* issue-reports 폴더 전체 삭제
* 모든 사용자 권한을 그룹장 대시보드로 통일
- 데이터베이스 스키마 정리:
* v1 스키마로 통일 (daily_work_reports 테이블)
* JSON 데이터 임포트 스크립트 구현
* 외래키 관계 정리 및 데이터 일관성 확보
- 통합 Docker Compose 설정:
* 모든 서비스를 단일 docker-compose.yml로 통합
* 20000번대 포트 유지
* JWT 시크릿 및 환경변수 설정
- 문서화:
* DATABASE_SCHEMA.md: 현재 DB 스키마 문서화
* DELETED_TABLES.md: 삭제된 테이블 목록
* DELETED_PAGES.md: 삭제된 페이지 목록
- 시스템 관리자 전용 웹페이지 구현 (system.html)
- 깔끔한 흰색 배경의 올드스쿨 스타일 적용
- 반응형 그리드 레이아웃으로 카드 배치 개선
- ES6 모듈 방식으로 JavaScript 구조 개선
- 이벤트 리스너 방식으로 버튼 클릭 처리 변경
- 시스템 상태, 사용자 통계, 계정 관리 기능 구현
- 시스템 로그 조회 기능 추가
- 나머지 관리 기능들 스켈레톤 구현 (개발 중 상태)
- 인코딩 문제 해결을 위한 영어 로그 메시지 적용
- hyungi 계정을 system 권한으로 설정
- JWT 토큰에 role 필드 추가
- 시스템 전용 API 엔드포인트 구현
주요 변경사항:
- web-ui/pages/dashboard/system.html: 시스템 관리자 전용 페이지
- web-ui/css/system-dashboard.css: 시스템 대시보드 전용 스타일
- web-ui/js/system-dashboard.js: 시스템 대시보드 로직
- api.hyungi.net/controllers/systemController.js: 시스템 API 컨트롤러
- api.hyungi.net/routes/systemRoutes.js: 시스템 API 라우트
- api.hyungi.net/controllers/authController.js: 시스템 권한 로그인 처리
- api.hyungi.net/services/auth.service.js: JWT 토큰에 role 필드 추가
- npm audit fix로 tar-fs, brace-expansion 취약점 해결
- analysisRoutes.js에서 authMiddleware import 오류 수정
- dailyWorkReportController.js에 누락된 getAccumulatedReports 함수 추가
- JWT 인증 시스템 정상 작동 확인 완료
- dailyWorkReportController의 생성 로직을 Service와 Model로 분리
- Service: 데이터 유효성 검사 등 비즈니스 로직 담당
- Model: 트랜잭션을 사용한 DB 쿼리 담당
- Controller: HTTP 요청/응답 처리만 담당하도록 단순화
