1. 需求确认

2. 结构的一些变更

internal/routes/account.go

@@ -3,22 +3,71 @@ package routes
 import (
 	"github.com/gofiber/fiber/v2"
 
-	"github.com/break/junhong_cmp_fiber/internal/handler"
+	"github.com/break/junhong_cmp_fiber/internal/handler/admin"
+	"github.com/break/junhong_cmp_fiber/internal/model"
+	"github.com/break/junhong_cmp_fiber/pkg/openapi"
 )
 
 // registerAccountRoutes 注册账号相关路由
-func registerAccountRoutes(api fiber.Router, h *handler.AccountHandler) {
+func registerAccountRoutes(api fiber.Router, h *admin.AccountHandler, doc *openapi.Generator, basePath string) {
 	accounts := api.Group("/accounts")
+	groupPath := basePath + "/accounts"
 
 	// 账号 CRUD
-	accounts.Post("", h.Create)       // POST /api/v1/accounts
-	accounts.Get("", h.List)          // GET /api/v1/accounts
-	accounts.Get("/:id", h.Get)       // GET /api/v1/accounts/:id
-	accounts.Put("/:id", h.Update)    // PUT /api/v1/accounts/:id
-	accounts.Delete("/:id", h.Delete) // DELETE /api/v1/accounts/:id
+	Register(accounts, doc, groupPath, "POST", "", h.Create, RouteSpec{
+		Summary: "创建账号",
+		Tags:    []string{"Account"},
+		Input:   new(model.CreateAccountRequest),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(accounts, doc, groupPath, "GET", "", h.List, RouteSpec{
+		Summary: "账号列表",
+		Tags:    []string{"Account"},
+		Input:   new(model.AccountListRequest),
+		Output:  new(model.AccountPageResult),
+	})
+
+	Register(accounts, doc, groupPath, "GET", "/:id", h.Get, RouteSpec{
+		Summary: "获取账号详情",
+		Tags:    []string{"Account"},
+		Input:   new(model.IDReq),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(accounts, doc, groupPath, "PUT", "/:id", h.Update, RouteSpec{
+		Summary: "更新账号",
+		Tags:    []string{"Account"},
+		Input:   new(model.UpdateAccountParams),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(accounts, doc, groupPath, "DELETE", "/:id", h.Delete, RouteSpec{
+		Summary: "删除账号",
+		Tags:    []string{"Account"},
+		Input:   new(model.IDReq),
+		Output:  nil,
+	})
 
 	// 账号-角色关联
-	accounts.Post("/:id/roles", h.AssignRoles)                   // POST /api/v1/accounts/:id/roles
-	accounts.Get("/:id/roles", h.GetRoles)                       // GET /api/v1/accounts/:id/roles
-	accounts.Delete("/:account_id/roles/:role_id", h.RemoveRole) // DELETE /api/v1/accounts/:account_id/roles/:role_id
+	Register(accounts, doc, groupPath, "POST", "/:id/roles", h.AssignRoles, RouteSpec{
+		Summary: "分配角色",
+		Tags:    []string{"Account"},
+		Input:   new(model.AssignRolesParams),
+		Output:  nil, // TODO: Define AccountRole response DTO
+	})
+
+	Register(accounts, doc, groupPath, "GET", "/:id/roles", h.GetRoles, RouteSpec{
+		Summary: "获取账号角色",
+		Tags:    []string{"Account"},
+		Input:   new(model.IDReq),
+		Output:  new([]model.Role),
+	})
+
+	Register(accounts, doc, groupPath, "DELETE", "/:account_id/roles/:role_id", h.RemoveRole, RouteSpec{
+		Summary: "移除角色",
+		Tags:    []string{"Account"},
+		Input:   new(model.RemoveRoleParams),
+		Output:  nil,
+	})
 }