TK-FB-Project/DEV_LOG.md

# 개발 진행 로그

## 📅 Recent Updates (2026-01-29)

### 🗺️ 대시보드 작업장 현황 지도 구현 (2026-01-29)
**개요**: 대시보드에 실시간 작업장 현황을 지도로 시각화하여 작업자 및 방문자 현황을 한눈에 파악

**배경**:
- 기존 "오늘의 작업 현황" 테이블 방식은 직관성 부족
- 작업장별 위치와 인원 현황을 시각적으로 표시할 필요
- 작업장 관리 페이지에서 설정한 구역 정보 활용

**구현 내용**:
1. **대시보드 UI 개편**
   - **제거**: "오늘의 작업 현황" 테이블 섹션
   - **추가**: "작업장 현황" 지도 섹션
   - 공장 선택 드롭다운 (제1공장 기본 선택)
   - 실시간 새로고침 버튼

2. **작업장 현황 지도 기능** (`web-ui/js/workplace-status.js`)
   - **데이터 소스**:
     - `map-regions` API: 작업장 관리 페이지에서 정의한 구역 정보
     - `tbm/sessions` API: 금일 TBM 작업 정보
     - `workplace-visits/requests` API: 금일 방문자 신청 정보

   - **시각화 방식**:
     - 모든 작업장 구역을 사각형으로 표시
     - 인원 없음: 회색 테두리 + 작업장 이름
     - 내부 작업자만: 파란색 영역 + 인원 수 배지
     - 외부 방문자만: 보라색 영역 + 인원 수 배지
     - 작업자+방문자: 초록색 영역 + 총 인원 수 배지

   - **상호작용**:
     - 작업장 구역 클릭 → 상세 정보 모달 표시
     - 내부 작업자: 작업명 + 인원 수 + 작업 위치 + 프로젝트명
     - 외부 방문자: 업체명 + 인원 수 + 방문 시간 + 목적

3. **TBM 데이터 통합**
   - 세션별 작업 정보 집계 (`task_name`, `team_member_count`)
   - 조장 포함 총 인원 계산
   - Draft 상태 세션도 예정 작업으로 표시

4. **기술적 구현**:
   - Canvas API 기반 지도 렌더링
   - 사각형 좌표 변환 (퍼센트 → 픽셀)
   - 마우스 클릭 위치를 영역 좌표로 매핑
   - 작업장 관리 페이지와 동일한 `map-regions` API 사용으로 데이터 일관성 보장

**수정 파일**:
- `web-ui/pages/dashboard.html` - 작업장 현황 섹션 추가
- `web-ui/js/workplace-status.js` - 신규 생성 (지도 렌더링 및 데이터 로직)
- `web-ui/js/modern-dashboard.js` - 삭제된 DOM 요소 조건부 체크 추가

**효과**:
- 작업장별 실시간 인원 현황을 시각적으로 파악 가능
- 작업 배치 및 안전 관리 의사결정 지원
- 외부 방문자 위치 추적으로 안전 관리 강화

---

### 🏖️ 휴가 관리 시스템 리팩토링 및 페이지 분리 (2026-01-29)
**개요**: 코딩 가이드 준수를 위해 536줄의 단일 파일을 2개 페이지로 분리하고 공통 함수 라이브러리 생성

**배경**:
- 기존 `vacation-management.html` (536줄) - 코딩 가이드 위반 (파일 길이 초과)
- 단일 파일에 작업자/관리자 기능이 혼재
- 코드 중복 발생

**구조 개선**:
1. **공통 함수 라이브러리 생성**
   - **파일**: `web-ui/js/vacation-common.js`
   - **역할**: 모든 휴가 페이지에서 사용하는 공통 함수 모음
   - **주요 함수**:
     - `loadWorkers()`: 작업자 목록 로드
     - `loadVacationTypes()`: 휴가 유형 로드
     - `getCurrentUser()`: 현재 사용자 정보 조회
     - `renderVacationRequests()`: 휴가 신청 목록 렌더링
     - `approveVacationRequest()`: 휴가 승인
     - `rejectVacationRequest()`: 휴가 거부
     - `deleteVacationRequest()`: 휴가 신청 삭제

2. **2개 페이지로 분리**
   - **`vacation-request.html`** (작업자 휴가 신청)
     - 역할: 휴가 신청 및 본인 신청 내역 확인
     - 권한: 모든 작업자 (자동으로 본인 선택됨)
     - 기능:
       - 휴가 잔여 현황 표시
       - 휴가 신청 폼
       - 내 신청 내역 (삭제 가능 - pending만)

   - **`vacation-management.html`** (관리자 휴가 관리)
     - 역할: 휴가 승인/직접입력/전체내역 관리 (3개 탭)
     - 권한: 관리자 전용 (system/admin)
     - 기능:
       - **탭 1: 승인 대기 목록** - 승인/거부 버튼
       - **탭 2: 직접 입력** - 승인 절차 없이 휴가 정보 직접 입력
         - 작업자 선택 시 휴가 잔여 표시
         - 입력 즉시 승인 상태로 저장
         - 최근 입력 내역 표시
       - **탭 3: 전체 신청 내역** - 날짜 필터링 지원

3. **데이터베이스 페이지 등록**
   - **마이그레이션**: `20260129000003_update_vacation_pages.js`
   - **변경사항**:
     - 기존 `vacation-management` 페이지 삭제
     - 신규 2개 페이지 등록 (vacation-request, vacation-management)
     - `is_admin_only` 플래그로 권한 구분 (vacation-request: 0, vacation-management: 1)
     - `display_order`로 표시 순서 관리

4. **파일 정리**
   - 기존: `vacation-management.html` → `.old` 확장자로 이름 변경
   - 향후: 충분한 테스트 후 삭제 예정

**기술적 개선사항**:
- 코드 중복 제거: 공통 함수를 vacation-common.js로 추출
- 권한 체크 강화: 페이지 로드 시 access_level 확인 및 리다이렉트
- 이벤트 기반 UI 업데이트: 'vacation-updated' 이벤트로 페이지 간 동기화
- 역할 기반 접근 제어: 작업자는 본인 정보만, 관리자는 전체 관리
- 탭 기반 UI: 관리자 페이지는 3개 탭으로 기능 구분

**파일 변경사항**:
```
[NEW] web-ui/js/vacation-common.js (공통 함수 라이브러리)
[NEW] web-ui/pages/common/vacation-request.html (작업자 휴가 신청)
[NEW] web-ui/pages/common/vacation-management.html (관리자 3-탭 관리)
[NEW] api.hyungi.net/db/migrations/20260129000003_update_vacation_pages.js
[UPDATED] web-ui/pages/dashboard.html (휴가 관련 링크 업데이트)
[RENAMED] web-ui/pages/common/vacation-management.html → vacation-management.html.old
```

**코딩 가이드 준수**:
- ✅ 파일 길이 제한 준수 (기존 536줄 → 각 350줄 이하)
- ✅ 공통 로직 분리 (DRY 원칙)
- ✅ 단일 책임 원칙 (각 페이지가 명확한 역할)
- ✅ 역할 기반 접근 제어 명확화

---

## 📅 Previous Updates (2025-12-19)

### WorkAnalysis 리팩토링 완료
**내용**: 복잡한 통계 로직을 포함하던 `workAnalysisController.js`를 리팩토링함.
- **[NEW] Service Layer**: `services/workAnalysisService.js` 생성. 비즈니스 로직 이관.
- **[UPDATE] Model Layer**: Raw SQL 쿼리를 Controller에서 Model(`models/WorkAnalysis.js`)로 이동. `getProjectWorkTypeRawData` 메서드 추가.
- **[CLEANUP] Controller**: `getProjectWorkTypeAnalysis` 메서드가 Service를 호출하도록 단순화.

### 🐛 심각한 버그 수정 및 시스템 정상화 (2025-12-19)
**개요**: 로그인 500 에러 및 대시보드 데이터 미표시 문제 해결.

1.  **DB 정상화 (Login 500 Fix)**
    - **원인**: 초기화된 DB(Empty) 및 테이블명 대소문자 불일치(`Users` vs `users`).
    - **조치**: `hyungi.sql` 복원 후, 컨벤션에 맞춰 테이블명 일괄 변경(`Users`→`users`, `Projects`→`projects`, `Workers`→`workers`, `Tasks`→`tasks`).
    - **코드 수정**: `userModel.js`, `authController.js` 등 관련 코드의 테이블 참조 수정.

2.  **프로젝트 조회 오류 수정 (Project API 500 Fix)**
    - **원인**: 구버전 스키마 복원으로 인한 `projects` 테이블 컬럼 부족(`is_active`, `project_status`, `completed_date`).
    - **조치**: 마이그레이션 실행하여 누락된 컬럼 추가.

3.  **대시보드 작업자 미표시 수정**
    - **원인 1 (Data)**: `workers` 테이블 내 `status` 값이 유효하지 않음(`..`). → `active`로 일괄 수정.
    - **원인 2 (Logic)**: `INNER JOIN` 사용으로 통계가 없는 작업자 누락. → `LEFT JOIN`으로 쿼리 개선(`MonthlyStatusModel.js`).

4.  **테스트 계정 생성**
    - `tester` / `000000` 관리자(Leader) 계정 생성.

### 🛠️ 작업자 및 프로젝트 관리 기능 개선 (2026-01-06)
**개요**: 작업자/프로젝트의 비활성화(퇴사/종료) 처리가 즉시 반영되지 않는 문제 및 로직 오류 수정.

1.  **캐시 무효화 및 필터링 적용 (Cache & Filtering)**
    - **문제**: 작업자/프로젝트 상태 변경 후에도 캐시가 남아있어 드롭다운 목록에서 사라지지 않음.
    - **해결**:
        - `WorkerController`, `ProjectController`: 생성/수정/삭제 시 `request` 단위의 캐시 즉시 무효화 로직 추가.
        - `WorkerController`: 목록 조회 시 `status` 파라미터 지원 추가.
        - `daily-work-report.js`: 작업보고서 작성 시 `active` 상태인 작업자만 필터링하여 조회하도록 수정.

2.  **작업자 비활성화 오류 수정 (Bug Fix)**
    - **원인**: `workerModel.update` 쿼리에 DB에 존재하지 않는 `join_date` 컬럼을 업데이트하려는 시도가 있어 SQL 에러 발생.
    - **해결**: `workerModel.js`에서 잘못된 컬럼(`join_date`) 참조 제거. (올바른 컬럼 `hire_date`는 유지)


3.  **일일 근태 추적 시스템 구현 (Daily Attendance Tracking)**
    - **Backend**:
        - `AttendanceModel.initializeDailyRecords` 추가: 모든 활성 작업자에 대해 'incomplete' 상태의 근태 기록 자동 생성 (Lazy Initialization).
        - `AttendanceModel.syncWithWorkReports` 추가: 작업 보고서 작성/수정/삭제 시 근태 상태(미제출/부분/완료/초과) 자동 동기화.
        - `dailyWorkReportModel.js`에 동기화 로직 통합 (트랜잭션 후 처리).
        - `attendanceService`에서 상태 조회 시 초기화 로직 수행.
    - **Frontend**:
        - `group-leader-dashboard.js` 리팩토링: 모의 데이터 대신 실제 API(`/attendance/daily-status`) 연동.
        - `modern-dashboard.css`: 근태 현황 카드(`worker-card`) 및 그리드 스타일 추가.
        - `group-leader.html`: 스크립트 로드 추가 및 DOM 구조 확인.

---

## 🛡보안 및 검토 리포트 (History)

### 2025-07-29 보안 취약점 분석
`api.hyungi.net` 백엔드 서버 취약점 점검 결과.

| 라이브러리 | 심각도 | 상태 | 조치사항 |
|---|---|---|---|
| `tar-fs` | **High** | 해결가능 | `npm audit fix` 권장 (완료됨) |
| `brace-expansion` | Low | 해결가능 | `npm audit fix` 권장 (완료됨) |
| `pm2` | Low | 미해결 | 업데이트 대기 필요 |

---

## 📋 향후 계획
1. **테스트 커버리지 확보**: 리팩토링된 Service Layer에 대한 Unit Test 보강.
2. **Knex 마이그레이션**: 남은 Raw SQL(Model Layer)을 Knex 쿼리빌더로 점진적 전환.
3. **API 문서화**: Swagger/OpenAPI 도입 검토.