2b97844ed1
- 통합 캐싱 시스템 구축: * 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 완전 문서화 * 요청/응답 스키마 및 예시 포함
TK-FB-Project - 통합 실행 가이드
🚀 한 번에 모든 서비스 실행
🎯 간편 실행 (권장)
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
- 사용자: hyungi
- 비밀번호: hyungi_password_2025
- Root 비밀번호: hyungi_root_password_2025
✨ 주요 개선사항
- 통합 실행: 한 번의 명령으로 모든 서비스 실행
- 깔끔한 DB 초기화: 마이그레이션 오류 해결
- 일관된 네이밍: fb_ 접두사로 컨테이너 구분
- 안정적인 포트: 20000번대 포트 사용