feat(account): 实现平台账号管理功能

- 新增平台账号列表查询接口(自动筛选超级管理员和平台用户) - 新增密码修改和状态切换专用接口 - 增强角色分配功能,支持空数组清空所有角色 - 新增超级管理员保护机制,禁止分配角色 - 新增完整的集成测试和OpenSpec规范文档
2026-01-14 17:00:30 +08:00
parent 5556b1028c
commit b1195c16df
15 changed files with 1713 additions and 51 deletions
--- a/internal/routes/account.go
+++ b/internal/routes/account.go
@@ -70,4 +70,81 @@ func registerAccountRoutes(api fiber.Router, h *admin.AccountHandler, doc *opena
 		Input:   new(model.RemoveRoleParams),
 		Output:  nil,
 	})
+
+	registerPlatformAccountRoutes(api, h, doc, basePath)
+}
+
+func registerPlatformAccountRoutes(api fiber.Router, h *admin.AccountHandler, doc *openapi.Generator, basePath string) {
+	platformAccounts := api.Group("/platform-accounts")
+	groupPath := basePath + "/platform-accounts"
+
+	Register(platformAccounts, doc, groupPath, "GET", "", h.ListPlatformAccounts, RouteSpec{
+		Summary: "平台账号列表",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.PlatformAccountListRequest),
+		Output:  new(model.AccountPageResult),
+	})
+
+	Register(platformAccounts, doc, groupPath, "POST", "", h.Create, RouteSpec{
+		Summary: "新增平台账号",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.CreateAccountRequest),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(platformAccounts, doc, groupPath, "GET", "/:id", h.Get, RouteSpec{
+		Summary: "获取平台账号详情",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.IDReq),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(platformAccounts, doc, groupPath, "PUT", "/:id", h.Update, RouteSpec{
+		Summary: "编辑平台账号",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.UpdateAccountParams),
+		Output:  new(model.AccountResponse),
+	})
+
+	Register(platformAccounts, doc, groupPath, "DELETE", "/:id", h.Delete, RouteSpec{
+		Summary: "删除平台账号",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.IDReq),
+		Output:  nil,
+	})
+
+	Register(platformAccounts, doc, groupPath, "PUT", "/:id/password", h.UpdatePassword, RouteSpec{
+		Summary: "修改密码",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.UpdatePasswordParams),
+		Output:  nil,
+	})
+
+	Register(platformAccounts, doc, groupPath, "PUT", "/:id/status", h.UpdateStatus, RouteSpec{
+		Summary: "启用/禁用账号",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.UpdateStatusParams),
+		Output:  nil,
+	})
+
+	Register(platformAccounts, doc, groupPath, "POST", "/:id/roles", h.AssignRoles, RouteSpec{
+		Summary: "分配角色",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.AssignRolesParams),
+		Output:  nil,
+	})
+
+	Register(platformAccounts, doc, groupPath, "GET", "/:id/roles", h.GetRoles, RouteSpec{
+		Summary: "获取账号角色",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.IDReq),
+		Output:  new([]model.Role),
+	})
+
+	Register(platformAccounts, doc, groupPath, "DELETE", "/:id/roles/:role_id", h.RemoveRole, RouteSpec{
+		Summary: "移除角色",
+		Tags:    []string{"PlatformAccount"},
+		Input:   new(model.RemoveRoleParams),
+		Output:  nil,
+	})
 }