feat: 포괄적인 성능 최적화 시스템 구축

- 통합 캐싱 시스템 구축:
  * 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 완전 문서화
  * 요청/응답 스키마 및 예시 포함
This commit is contained in:
Hyungi Ahn
2025-11-03 11:05:07 +09:00
parent dea325739a
commit 2b97844ed1
7 changed files with 1270 additions and 14 deletions

View File

@@ -2,6 +2,8 @@
const workerModel = require('../models/workerModel');
const { ApiError, asyncHandler, handleDatabaseError, handleNotFoundError } = require('../utils/errorHandler');
const { validateSchema, schemas } = require('../utils/validator');
const cache = require('../utils/cache');
const { optimizedQueries } = require('../utils/queryOptimizer');
// 1. 작업자 생성
exports.createWorker = asyncHandler(async (req, res) => {
@@ -18,23 +20,38 @@ exports.createWorker = asyncHandler(async (req, res) => {
});
});
// 작업자 관련 캐시 무효화
await cache.invalidateCache.worker();
res.created({ worker_id: lastID }, '작업자가 성공적으로 생성되었습니다.');
} catch (err) {
handleDatabaseError(err, '작업자 생성');
}
});
// 2. 전체 작업자 조회
// 2. 전체 작업자 조회 (캐싱 및 페이지네이션 적용)
exports.getAllWorkers = asyncHandler(async (req, res) => {
const { page = 1, limit = 10, search = '' } = req.query;
// 캐시 키 생성
const cacheKey = cache.createKey('workers', 'list', page, limit, search);
try {
const rows = await new Promise((resolve, reject) => {
workerModel.getAll((err, data) => {
if (err) reject(err);
else resolve(data);
});
});
// 캐시에서 조회
const cachedData = await cache.get(cacheKey);
if (cachedData) {
console.log(`🎯 캐시 히트: ${cacheKey}`);
return res.paginated(cachedData.data, cachedData.pagination.totalCount, page, limit, '작업자 목록 조회 성공 (캐시)');
}
res.list(rows, '작업자 목록 조회 성공');
// 최적화된 쿼리 사용
const result = await optimizedQueries.getWorkersPaged(page, limit, search);
// 캐시에 저장 (5분)
await cache.set(cacheKey, result, cache.TTL.MEDIUM);
console.log(`💾 캐시 저장: ${cacheKey}`);
res.paginated(result.data, result.pagination.totalCount, page, limit, '작업자 목록 조회 성공');
} catch (err) {
handleDatabaseError(err, '작업자 목록 조회');
}