feat: 基础框架搭建完毕

internal/handler/router.go

@@ -0,0 +1,60 @@
+// Package handler adapts application services to the HTTP protocol.
+package handler
+
+import (
+	"context"
+	"log/slog"
+	"net/http"
+	"strings"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"github.com/google/uuid"
+
+	"git.sundynix.cn/Blizzard/Veyra/internal/adminui"
+	"git.sundynix.cn/Blizzard/Veyra/internal/service"
+)
+
+func NewRouter(health *service.HealthService, logger *slog.Logger, identity IdentityOptions) http.Handler {
+	gin.SetMode(gin.ReleaseMode)
+	r := gin.New()
+	r.Use(func(c *gin.Context) {
+		ctx, cancel := context.WithTimeout(c.Request.Context(), 5*time.Second)
+		defer cancel()
+		c.Request = c.Request.WithContext(ctx)
+		requestID := uuid.NewString()
+		c.Header("X-Request-ID", requestID)
+		c.Header("X-Content-Type-Options", "nosniff")
+		c.Header("Cache-Control", "no-store")
+		start := time.Now()
+		defer func() {
+			if recover() != nil {
+				logger.Error("request panic", "request_id", requestID)
+				c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": gin.H{"code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": requestID}})
+			}
+			logger.Info("http request", "method", c.Request.Method, "route", c.FullPath(), "status", c.Writer.Status(), "duration_ms", time.Since(start).Milliseconds(), "request_id", requestID)
+		}()
+		c.Next()
+	})
+	r.GET("/healthz", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{"status": "alive"}) })
+	check := func(c *gin.Context) {
+		h := health.Check(c.Request.Context())
+		status := http.StatusOK
+		if h.Status != "ready" {
+			status = http.StatusServiceUnavailable
+		}
+		c.JSON(status, h)
+	}
+	r.GET("/readyz", check)
+	r.GET("/api/v1/system/health", check)
+	bindIdentity(r, identity)
+	console := adminui.Handler()
+	r.NoRoute(func(c *gin.Context) {
+		if !strings.HasPrefix(c.Request.URL.Path, "/api/") && c.Request.URL.Path != "/api" {
+			console.ServeHTTP(c.Writer, c.Request)
+			return
+		}
+		c.JSON(http.StatusNotFound, gin.H{"error": gin.H{"code": "NOT_FOUND", "message": "Endpoint not found"}})
+	})
+	return r
+}