更新示例

internal/apps/custom/routers.go

@@ -0,0 +1,23 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+// Package custom provides custom business handlers
+package custom
+
+import (
+	"net/http"
+
+	"github.com/Rain-kl/Wavelet/internal/util"
+	"github.com/gin-gonic/gin"
+)
+
+// Hello is a sample handler for custom business logic
+// @Summary Sample Hello API
+// @Description A sample business API for customization
+// @Tags custom
+// @Produce json
+// @Success 200 {object} util.ResponseAny{data=string} "成功"
+// @Router /api/v1/custom/hello [get]
+func Hello(c *gin.Context) {
+	c.JSON(http.StatusOK, util.OK("Hello from custom business module!"))
+}

internal/router/custom.go

@@ -0,0 +1,17 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+package router
+
+import (
+	"github.com/Rain-kl/Wavelet/internal/apps/custom"
+	"github.com/gin-gonic/gin"
+)
+
+// registerCustomRoutes registers custom business routes to keep router.go clean and stable.
+func registerCustomRoutes(apiV1Router *gin.RouterGroup) {
+	customRouter := apiV1Router.Group("/custom")
+	{
+		customRouter.GET("/hello", custom.Hello)
+	}
+}

internal/router/router.go

@@ -280,6 +280,9 @@ func registerRoutes(r *gin.Engine) {
 				adminRouter.PUT("/auth-sources/:id/toggle", admin_auth_source.ToggleAuthSource)
 				adminRouter.DELETE("/auth-sources/:id", admin_auth_source.DeleteAuthSource)
 			}
+
+			// Register custom business routes
+			registerCustomRoutes(apiV1Router)
 		}
 	}