feat: LoL Temporal 포지션 선호도 기반 5:5 팀 매칭 알고리즘 구현 (#84)

cmd/server.go

@@ -152,12 +152,20 @@ func main() {
 	// Storage module - provides R2 storage integration for images
 	storageDeps := storage.ProvideStorageDependencies(appRouter)
 
+	// Set storage port for contest thumbnail upload
+	if storageDeps != nil {
+		contestDeps.ContestService.SetStoragePort(storageDeps.StoragePort)
+	}
+
 	// Banner module - provides main banner management for homepage
 	bannerDeps := banner.ProvideBannerDependencies(db, appRouter)
 
 	// Notification module - provides SSE real-time notifications
 	notificationDeps := notification.ProvideNotificationDependencies(db, appRouter)
 
+	// Wire score table port for point calculation during contest application
+	contestDeps.ApplicationService.SetScoreTablePort(pointDeps.ScoreTableRepository)
+
 	// Wire notification handler to contest and game services
 	contestDeps.ApplicationService.SetNotificationHandler(notificationDeps.Service)
 	gameDeps.TeamService.SetNotificationHandler(notificationDeps.Service)
@@ -176,6 +184,7 @@ func startServer(engine interface{}) {
 	log.Println("===========================================")
 	log.Println("Server:          http://localhost:8080")
 	log.Println("Health Check:    http://localhost:8080/health")
+	log.Println("Metrics:         http://localhost:8080/metrics")
 	log.Println("Swagger UI:      http://localhost:8080/swagger/index.html")
 	log.Println("===========================================")
 
@@ -207,9 +216,11 @@ func setupRouter(
 	notificationDeps *notification.Dependencies,
 ) *router.Router {
 
+	appRouter.Engine().Use(middleware.PrometheusMetrics())
 	appRouter.Engine().Use(middleware.GlobalErrorHandler())
 
 	appRouter.RegisterHealthCheck()
+	appRouter.RegisterMetrics()
 	appRouter.RegisterSwagger(ginSwagger.WrapHandler(swaggerFiles.Handler))
 
 	authDeps.Controller.RegisterRoutes()

db/migrations/000025_add_valorant_fields_to_contests_members.down.sql

@@ -0,0 +1,3 @@
+ALTER TABLE contests_members
+    DROP COLUMN valorant_roles,
+    DROP COLUMN description;

db/migrations/000025_add_valorant_fields_to_contests_members.up.sql

@@ -0,0 +1,3 @@
+ALTER TABLE contests_members
+    ADD COLUMN valorant_roles JSON DEFAULT NULL AFTER point,
+    ADD COLUMN description VARCHAR(64) DEFAULT '' AFTER valorant_roles;

docker/.env.example

@@ -0,0 +1,2 @@
+GRAFANA_ADMIN_USER=admin
+GRAFANA_ADMIN_PASSWORD=your_secure_password

docker/docker-compose.yaml

@@ -13,6 +13,44 @@ services:
     networks:
       - gamers-network
 
+  prometheus:
+    image: prom/prometheus:v2.53.1
+    container_name: gamers-prometheus
+    volumes:
+      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - prometheus-data:/prometheus
+    command:
+      - "--config.file=/etc/prometheus/prometheus.yml"
+      - "--storage.tsdb.retention.time=15d"
+    ports:
+      - "9090:9090"
+    networks:
+      - gamers-network
+    restart: unless-stopped
+
+  grafana:
+    image: grafana/grafana:12.0.1
+    container_name: gamers-grafana
+    volumes:
+      - ./grafana/provisioning:/etc/grafana/provisioning:ro
+      - ./grafana/dashboards:/etc/grafana/dashboards:ro
+      - grafana-data:/var/lib/grafana
+    environment:
+      GF_SECURITY_ADMIN_USER: ${GRAFANA_ADMIN_USER}
+      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_ADMIN_PASSWORD}
+      GF_USERS_ALLOW_SIGN_UP: "false"
+    ports:
+      - "3001:3000"
+    networks:
+      - gamers-network
+    depends_on:
+      - prometheus
+    restart: unless-stopped
+
+volumes:
+  prometheus-data:
+  grafana-data:
+
 networks:
   gamers-network:
     external: true

docker/grafana/dashboards/gamers-api.json

@@ -0,0 +1,111 @@
+{
+  "title": "GAMERS API",
+  "uid": "gamers-api",
+  "schemaVersion": 39,
+  "version": 1,
+  "refresh": "10s",
+  "time": { "from": "now-1h", "to": "now" },
+  "panels": [
+    {
+      "id": 1,
+      "title": "RPS (Requests Per Second)",
+      "type": "timeseries",
+      "gridPos": { "x": 0, "y": 0, "w": 12, "h": 8 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "sum(rate(http_requests_total[1m])) by (method, path)",
+          "legendFormat": "{{method}} {{path}}"
+        }
+      ]
+    },
+    {
+      "id": 2,
+      "title": "Error Rate (5xx / total)",
+      "type": "timeseries",
+      "gridPos": { "x": 12, "y": 0, "w": 12, "h": 8 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "sum(rate(http_requests_total{status=~\"5..\"}[1m])) / sum(rate(http_requests_total[1m]))",
+          "legendFormat": "error rate"
+        }
+      ]
+    },
+    {
+      "id": 3,
+      "title": "Request Duration p50 / p95 / p99",
+      "type": "timeseries",
+      "gridPos": { "x": 0, "y": 8, "w": 12, "h": 8 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "histogram_quantile(0.50, sum(rate(http_request_duration_seconds_bucket[1m])) by (le))",
+          "legendFormat": "p50"
+        },
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket[1m])) by (le))",
+          "legendFormat": "p95"
+        },
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "histogram_quantile(0.99, sum(rate(http_request_duration_seconds_bucket[1m])) by (le))",
+          "legendFormat": "p99"
+        }
+      ]
+    },
+    {
+      "id": 4,
+      "title": "In-Flight Requests",
+      "type": "timeseries",
+      "gridPos": { "x": 12, "y": 8, "w": 12, "h": 8 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "http_requests_in_flight",
+          "legendFormat": "in-flight"
+        }
+      ]
+    },
+    {
+      "id": 5,
+      "title": "Goroutines",
+      "type": "timeseries",
+      "gridPos": { "x": 0, "y": 16, "w": 8, "h": 7 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "go_goroutines",
+          "legendFormat": "goroutines"
+        }
+      ]
+    },
+    {
+      "id": 6,
+      "title": "Heap Alloc (MB)",
+      "type": "timeseries",
+      "gridPos": { "x": 8, "y": 16, "w": 8, "h": 7 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "go_memstats_heap_alloc_bytes / 1024 / 1024",
+          "legendFormat": "heap alloc MB"
+        }
+      ]
+    },
+    {
+      "id": 7,
+      "title": "GC Pause Duration (p99, ms)",
+      "type": "timeseries",
+      "gridPos": { "x": 16, "y": 16, "w": 8, "h": 7 },
+      "targets": [
+        {
+          "datasource": { "type": "prometheus" },
+          "expr": "histogram_quantile(0.99, sum(rate(go_gc_duration_seconds_bucket[1m])) by (le)) * 1000",
+          "legendFormat": "gc p99 ms"
+        }
+      ]
+    }
+  ]
+}

docker/grafana/provisioning/dashboards/dashboards.yml

@@ -0,0 +1,10 @@
+apiVersion: 1
+
+providers:
+  - name: GAMERS
+    folder: GAMERS
+    type: file
+    disableDeletion: false
+    editable: true
+    options:
+      path: /etc/grafana/dashboards

docker/grafana/provisioning/datasources/prometheus.yml

@@ -0,0 +1,9 @@
+apiVersion: 1
+
+datasources:
+  - name: Prometheus
+    type: prometheus
+    access: proxy
+    url: http://prometheus:9090
+    isDefault: true
+    editable: false

docker/prometheus/prometheus.yml

@@ -0,0 +1,9 @@
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+scrape_configs:
+  - job_name: "gamers-api"
+    static_configs:
+      - targets: ["app:8080"]
+    metrics_path: /metrics