[25.07.19 / TASK-212] Feature - cache layer, 모듈 추가

.env.sample

@@ -21,6 +21,14 @@ POSTGRES_PASSWORD=vd2
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
 
+# Cache (redis)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=notion-check-plz
+REDIS_DB=0
+REDIS_KEY_PREFIX=vd2:cache:
+CACHE_DEFAULT_TTL=300
+
 # Slack Notification
 SLACK_WEBHOOK_URL=https://hooks.slack.com/services
 

README.md

@@ -41,8 +41,8 @@ pnpm dev
 ```bash
 pnpm dev  # 개발 서버 실행
 pnpm test  # 테스트 실행
-pnpm lint  # 린트 검사
-pnpm lint:fix  # 린트 자동 수정
+pnpm lint  # 린트 검사 (eslint + prettier)
+pnpm lint-staged  # 린트 자동 수정
 
 pnpm build # 프로젝트 빌드
 pnpm start # 빌드된 프로젝트 시작

package.json

@@ -1,27 +1,38 @@
 {
   "name": "velog-dashboard",
   "version": "1.0.0",
-  "description": "",
+  "description": "Velog Dashboard Project, velog의 모든 게시글, 통계 데이터를 한 눈에 편하게 확인할 수 있는 대시보드입니다.",
   "main": "index.js",
   "scripts": {
     "dev": "tsx watch src/index.ts",
     "build": "tsc && tsc-alias -p tsconfig.json",
-    "lint": "eslint src/**/*.ts",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write src/**/*.ts",
+    "lint": "eslint src/**/*.ts && prettier --check src/**/*.ts",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "start": "node dist/index.js"
   },
   "lint-staged": {
-    "*.{ts,tsx}": [
+    ".{ts,tsx}": [
       "eslint --fix",
       "prettier --write"
     ]
   },
-  "keywords": [],
-  "author": "",
+  "keywords": [
+    "velog",
+    "dashboard",
+    "analytics",
+    "blog",
+    "monitoring",
+    "typescript",
+    "express",
+    "node.js",
+    "redis",
+    "postgresql",
+    "api",
+    "swagger"
+  ],
+  "author": "Nuung",
   "license": "ISC",
   "dependencies": {
     "@sentry/node": "^9.36.0",
@@ -33,6 +44,7 @@
     "dotenv": "^16.4.5",
     "express": "^4.21.1",
     "pg": "^8.13.1",
+    "redis": "^5.6.0",
     "reflect-metadata": "^0.2.2",
     "swagger-jsdoc": "^6.2.8",
     "swagger-ui-express": "^5.0.1",
@@ -49,6 +61,7 @@
     "@types/node": "^22.9.0",
     "@types/node-fetch": "^2.6.12",
     "@types/pg": "^8.11.10",
+    "@types/redis": "^4.0.11",
     "@types/swagger-jsdoc": "^6.0.4",
     "@types/swagger-ui-express": "^4.1.7",
     "eslint": "^9.15.0",
@@ -65,4 +78,4 @@
     "typescript-eslint": "^8.15.0",
     "typescript-transform-paths": "^3.5.3"
   }
-}
+}

src/app.ts

@@ -1,44 +1,92 @@
 import 'reflect-metadata';
-import express, { Application } from 'express';
+import express, { Application, Request, Response, NextFunction } from 'express';
 import dotenv from 'dotenv';
 import cors from 'cors';
 import cookieParser from 'cookie-parser';
-import router from './routes';
 import swaggerUi from 'swagger-ui-express';
 import swaggerJSDoc from 'swagger-jsdoc';
+
+import logger from '@/configs/logger.config';
+import router from '@/routes';
+import { NotFoundError } from '@/exception';
+
 import { options } from '@/configs/swagger.config';
-import { errorHandlingMiddleware } from './middlewares/errorHandling.middleware';
-import { NotFoundError } from './exception';
-import { initSentry } from '@/configs/sentry.config';
+import { initSentry, getSentryStatus } from '@/configs/sentry.config';
+import { initCache, getCacheStatus } from '@/configs/cache.config';
+import { errorHandlingMiddleware } from '@/middlewares/errorHandling.middleware';
 
 dotenv.config();
 
-// Sentry 초기화
-initSentry();
+initSentry();  // Sentry 초기화
+initCache();  // Redis 캐시 초기화
 
 const app: Application = express();
+
 // 실제 클라이언트 IP를 알기 위한 trust proxy 설정
-app.set('trust proxy', true);
+app.set('trust proxy', process.env.NODE_ENV === 'production');
+
 const swaggerSpec = swaggerJSDoc(options);
 
 app.use(cookieParser());
-app.use(express.json());
-app.use(express.urlencoded({ extended: true }));
+app.use(express.json({ limit: '10mb' })); // 파일 업로드 대비
+app.use(express.urlencoded({ extended: true, limit: '10mb' }));
+
 app.use(
   cors({
-    origin: process.env.NODE_ENV === 'production' ? process.env.ALLOWED_ORIGINS?.split(',') : 'http://localhost:3000',
+    origin: process.env.NODE_ENV === 'production'
+      ? process.env.ALLOWED_ORIGINS?.split(',').map(origin => origin.trim())
+      : 'http://localhost:3000',
     methods: ['GET', 'POST'],
     allowedHeaders: ['Content-Type', 'Authorization', 'Cookie', 'access_token', 'refresh_token'],
     credentials: true,
   }),
 );
 
-app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));
+// 헬스체크 엔드포인트
+app.get('/health', async (req: Request, res: Response) => {
+  // 기본 정보
+  const healthData = {
+    status: 'OK',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    environment: process.env.NODE_ENV,
+    services: {
+      sentry: false,
+      cache: false
+    }
+  };
+
+  // Sentry 상태 확인
+  try {
+    healthData.services.sentry = getSentryStatus();
+  } catch (error) {
+    healthData.services.sentry = false;
+    logger.error('Failed to health check for sentry:', error);
+  }
+
+  // Cache 상태 확인
+  try {
+    healthData.services.cache = await getCacheStatus();
+  } catch (error) {
+    healthData.services.cache = false;
+    logger.error('Failed to health check for cache:', error);
+  }
+
+  res.status(200).json(healthData);
+});
+
+// Swagger는 개발 환경에서만
+if (process.env.NODE_ENV !== 'production') {
+  app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));
+}
+
 app.use('/api', router);
-app.use((req) => {
-  throw new NotFoundError(`${req.url} not found`);
+
+// 404 에러 핸들링 수정 (throw 대신 next 사용)
+app.use((req: Request, res: Response, next: NextFunction) => {
+  next(new NotFoundError(`${req.url} not found`));
 });
 
 app.use(errorHandlingMiddleware);
 
-export default app;
+export default app;