Files
TK-FB-Project/api.hyungi.net/controllers/workerController.js
Hyungi Ahn 2b97844ed1 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 완전 문서화
  * 요청/응답 스키마 및 예시 포함
2025-11-03 11:05:07 +09:00

138 lines
4.0 KiB
JavaScript

// controllers/workerController.js
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) => {
const workerData = req.body;
// 스키마 기반 유효성 검사
validateSchema(workerData, schemas.createWorker);
try {
const lastID = await new Promise((resolve, reject) => {
workerModel.create(workerData, (err, id) => {
if (err) reject(err);
else resolve(id);
});
});
// 작업자 관련 캐시 무효화
await cache.invalidateCache.worker();
res.created({ worker_id: lastID }, '작업자가 성공적으로 생성되었습니다.');
} catch (err) {
handleDatabaseError(err, '작업자 생성');
}
});
// 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 cachedData = await cache.get(cacheKey);
if (cachedData) {
console.log(`🎯 캐시 히트: ${cacheKey}`);
return res.paginated(cachedData.data, cachedData.pagination.totalCount, page, limit, '작업자 목록 조회 성공 (캐시)');
}
// 최적화된 쿼리 사용
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, '작업자 목록 조회');
}
});
// 3. 단일 작업자 조회
exports.getWorkerById = asyncHandler(async (req, res) => {
const id = parseInt(req.params.worker_id, 10);
if (isNaN(id)) {
throw new ApiError('유효하지 않은 작업자 ID입니다.', 400);
}
try {
const row = await new Promise((resolve, reject) => {
workerModel.getById(id, (err, data) => {
if (err) reject(err);
else resolve(data);
});
});
if (!row) {
handleNotFoundError('작업자', id);
}
res.success(row, '작업자 조회 성공');
} catch (err) {
handleDatabaseError(err, '작업자 조회');
}
});
// 4. 작업자 수정
exports.updateWorker = asyncHandler(async (req, res) => {
const id = parseInt(req.params.worker_id, 10);
if (isNaN(id)) {
throw new ApiError('유효하지 않은 작업자 ID입니다.', 400);
}
const workerData = { ...req.body, worker_id: id };
try {
const changes = await new Promise((resolve, reject) => {
workerModel.update(workerData, (err, affected) => {
if (err) reject(err);
else resolve(affected);
});
});
if (changes === 0) {
handleNotFoundError('작업자', id);
}
res.updated({ changes }, '작업자 정보가 성공적으로 수정되었습니다.');
} catch (err) {
handleDatabaseError(err, '작업자 수정');
}
});
// 5. 작업자 삭제
exports.removeWorker = asyncHandler(async (req, res) => {
const id = parseInt(req.params.worker_id, 10);
if (isNaN(id)) {
throw new ApiError('유효하지 않은 작업자 ID입니다.', 400);
}
try {
const changes = await new Promise((resolve, reject) => {
workerModel.remove(id, (err, affected) => {
if (err) reject(err);
else resolve(affected);
});
});
if (changes === 0) {
handleNotFoundError('작업자', id);
}
res.deleted('작업자가 성공적으로 삭제되었습니다.');
} catch (err) {
handleDatabaseError(err, '작업자 삭제');
}
});