feat: 백엔드 수평 확장 및 Socket.IO 분산 상태 지원

.github/pull_request_template.md

@@ -0,0 +1,53 @@
+# 성능 개선
+
+## 🚀 개선 내용
+
+- 개선 대상:
+- 변경 내용:
+
+## 🔍 문제 및 원인
+
+- 확인된 문제:
+- 원인:
+
+## 📊 개선 결과
+
+| 지표       | 개선 전 | 개선 후 |
+| ---------- | ------: | ------: |
+| TPS / RPS  |         |         |
+| Avg        |         |         |
+| P95        |         |         |
+| P99        |         |         |
+| Error Rate |         |         |
+
+## ✅ 추가 확인
+
+- 추가 테스트 또는 확인이 필요한 부분:
+
+---
+
+# 테스트
+
+## 🧪 테스트 내용
+
+- 테스트 대상:
+- 테스트 목적:
+
+## ⚙️ 테스트 조건
+
+- VU:
+- 테스트 시간:
+- 요청 수 / 요청 빈도:
+
+## 📊 테스트 결과
+
+- TPS / RPS:
+- Avg:
+- P95:
+- P99:
+- Error Rate:
+
+## 🔍 확인된 문제
+
+- 특이사항 또는 확인된 병목:
+- 추가 확인이 필요한 부분:

.gitignore

@@ -0,0 +1,18 @@
+node_modules/
+**/node_modules/
+
+**/.next/
+
+# IDE / OS local files
+.idea/
+.vscode/
+.DS_Store
+
+# 환경 변수
+.env
+.env.*
+!.env.example
+
+# Java / Maven build
+**/target/
+.pnpm-store/

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "java.compile.nullAnalysis.mode": "automatic"
+}

apps/backend/.env.template

@@ -5,11 +5,44 @@ ENCRYPTION_SALT=change_me_32_hex_chars________________
 JWT_SECRET=change_me_secure_jwt_secret
 
 MONGO_URI=mongodb://localhost:27017/bootcamp-chat
+
+MONGO_MAX_POOL_SIZE=100
+MONGO_MIN_POOL_SIZE=0
+MONGO_MAX_WAIT_TIME_MS=120000
+
 REDIS_HOST=localhost
 REDIS_PORT=6379
 REDIS_PASSWORD=ktb
 
 PORT=5001
 WS_PORT=5002
+SOCKETIO_PRESENCE_REFRESH_INTERVAL=5m
+ROOM_ACTIVITY_FLUSH_DELAY=1s
+ROOM_ACTIVITY_DEBOUNCE_WINDOW=1s
+
+# Storage: local (default) or s3. In production, prefer an instance IAM role
+# instead of static AWS credentials.
+FILE_STORAGE_TYPE=local
+AWS_REGION=ap-northeast-2
+S3_BUCKET=
+S3_ENDPOINT=
+S3_PATH_STYLE=false
+S3_KEY_PREFIX=
+S3_PRESIGN_TTL=10m
 
 OPENAI_API_KEY=sk-...
+
+TOMCAT_THREADS_MAX=100
+TOMCAT_THREADS_MIN_SPARE=10
+TOMCAT_ACCEPT_COUNT=500
+TOMCAT_MAX_CONNECTIONS=1000
+
+SOCKETIO_LOG_LEVEL=WARN
+SOCKETIO_LIBRARY_LOG_LEVEL=WARN
+
+# CloudFront
+CLOUDFRONT_ENABLED=false
+CLOUDFRONT_BASE_URL=https://chat.goorm-ktb-012.goorm.team
+CLOUDFRONT_KEY_PAIR_ID=
+CLOUDFRONT_PRIVATE_KEY_PATH=/run/secrets/cloudfront-private-key.pem
+CLOUDFRONT_URL_TTL=5m

apps/backend/Dockerfile.runtime

@@ -0,0 +1,9 @@
+FROM eclipse-temurin:25-jre
+
+WORKDIR /app
+
+COPY ktb-chat-backend-0.0.1-SNAPSHOT.jar app.jar
+
+EXPOSE 5001 5002
+
+ENTRYPOINT ["java", "-jar", "app.jar"]

apps/backend/docker-compose.o11y.yaml

@@ -39,15 +39,15 @@ services:
     container_name: grafana-ktb
     restart: unless-stopped
     ports:
-      - "3000:3000"
+      - "9091:3000"
     environment:
       - GF_SECURITY_ADMIN_USER=${GRAFANA_ADMIN_USER:-admin}
       - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
       - GF_USERS_ALLOW_SIGN_UP=false
       # Behind the ALB Grafana must know its public name, or its redirects and
       # asset links point at the container. The default is the local port
       # mapping in this file, not the 9091 the dev compose uses.
-      - GF_SERVER_ROOT_URL=${GRAFANA_ROOT_URL:-http://localhost:3000}
+      - GF_SERVER_ROOT_URL=${GRAFANA_ROOT_URL:-http://localhost:9091}
       - GF_ANALYTICS_REPORTING_ENABLED=false
     volumes:
       - grafana_data:/var/lib/grafana