ffe9619abd
주요 변경사항:
1. services/dailyIssueReportService.js 개선 (93 → 170 lines, 83% 증가)
* console.error → logger 교체:
- logger.info: 작업 시작/성공 로깅
- logger.error: 실패 로깅
- logger.warn: 경고 로깅
* Error → 커스텀 에러 클래스 적용:
- ValidationError: 필수 필드 검증 실패
- NotFoundError: 리소스 없음
- DatabaseError: DB 오류
* 상세한 JSDoc 문서화:
- 모든 파라미터 타입 및 설명 추가
- 함수 목적 및 동작 명시
* 구조화된 로깅:
- 모든 요청에 컨텍스트 정보 포함
- 성공/실패 추적 가능
2. controllers/dailyIssueReportController.js 개선 (58 → 65 lines)
* try-catch 제거 → asyncHandler 사용
* console.error 제거
* 에러 처리 자동화
* 표준화된 JSON 응답 형식
3. services/uploadService.js 신규 생성 (96 lines)
* 2개 서비스 함수 구현:
- createUploadService: 문서 업로드 생성
- getAllUploadsService: 전체 문서 조회
* 커스텀 에러 클래스 적용
* 구조화된 로깅 통합
* 필수 필드 검증 (original_name, stored_name, file_path)
* 파일 메타데이터 로깅
4. controllers/uploadController.js 완전 재작성 (26 → 39 lines)
* try-catch 제거 → asyncHandler 사용
* 모든 비즈니스 로직 서비스 레이어로 이동
* 표준화된 JSON 응답 형식
* 에러 처리 자동화
기술적 개선사항:
- 일관된 에러 처리: ValidationError, NotFoundError, DatabaseError
- 구조화된 로깅: 모든 작업 추적 및 디버깅 용이
- 코드 중복 제거: try-catch 패턴 제거
- 테스트 용이성: 서비스 함수 독립적 테스트 가능
- 유지보수성: 비즈니스 로직과 HTTP 레이어 분리
서비스 레이어 진행 상황:
- ✅ dailyWorkReportService.js (Phase 3.1)
- ✅ attendanceService.js (Phase 3.2)
- ✅ issueTypeService.js (Phase 3.4)
- ✅ toolsService.js (Phase 3.4)
- ✅ dailyIssueReportService.js (Phase 3.5 - 개선)
- ✅ uploadService.js (Phase 3.5 - 신규)
전체 진행률:
- 컨트롤러: 16개 중 12개 개선 완료 (75%)
- 서비스 레이어: 6개 생성/개선 완료
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
TK-FB-Project - 통합 실행 가이드
⚙️ 사전 준비
환경 변수 설정 (필수)
처음 실행하기 전에 환경 변수 파일을 생성해야 합니다:
# 1. .env.example을 복사하여 .env 파일 생성
cp .env.example .env
# 2. .env 파일을 편집하여 실제 비밀번호로 변경
nano .env # 또는 vi, code 등 사용
# 3. 강력한 비밀번호로 변경 (예시)
# MYSQL_ROOT_PASSWORD=your_secure_password_here
# MYSQL_PASSWORD=your_secure_password_here
# JWT_SECRET=your_random_jwt_secret_min_32_chars
중요: .env 파일은 절대 Git에 커밋하지 마세요!
🚀 한 번에 모든 서비스 실행
🎯 간편 실행 (권장)
cd /Users/hyungi/docker/TK-FB-Project
./start.sh
🛑 간편 중지
./stop.sh
📋 직접 실행
docker-compose up -d
docker-compose down
📊 서비스 목록
| 서비스 | 포트 | 접속 URL | 설명 |
|---|---|---|---|
| 웹 UI | 20000 | http://localhost:20000 | 메인 웹 인터페이스 |
| API 서버 | 20005 | http://localhost:20005 | Node.js API 서버 ✅ |
| FastAPI 브릿지 | 20010 | http://localhost:20010 | Python FastAPI 서비스 |
| phpMyAdmin | 20080 | http://localhost:20080 | DB 관리도구 |
| MariaDB | 20306 | - | 데이터베이스 서버 |
🛠️ 관리 명령어
모든 서비스 중지
cd /Users/hyungi/docker/TK-FB-Project
docker-compose down
서비스 상태 확인
docker ps | grep fb_
로그 확인
docker-compose logs -f
💾 데이터베이스 정보
- 호스트: localhost:20306
- 데이터베이스: hyungi (
.env파일의MYSQL_DATABASE) - 사용자: hyungi_user (
.env파일의MYSQL_USER) - 비밀번호:
.env파일에서 설정한MYSQL_PASSWORD - Root 비밀번호:
.env파일에서 설정한MYSQL_ROOT_PASSWORD
참고: 실제 비밀번호는 .env 파일을 확인하세요.
✨ 주요 개선사항
- 통합 실행: 한 번의 명령으로 모든 서비스 실행
- 깔끔한 DB 초기화: 마이그레이션 오류 해결
- 일관된 네이밍: fb_ 접두사로 컨테이너 구분
- 안정적인 포트: 20000번대 포트 사용