转写说明

本文基于已校验的公开原文进行结构化转写与事实梳理，非原文转载。 转写保留可核验的技术事实，并将工程建议与来源观点明确分开。

核心结论

基于已完成的基类体系，可以直接复用基控制器、仓储和服务层，快速生成管理员账号管理 CRUD 接口。零定制版本代码量极少，主要得益于基类对通用增删改查逻辑的封装。通过自定义 DTO 结构体区分新增与编辑请求，在服务层统一完成密码加密和用户名重复校验，实现数据验证逻辑的集中管理。

能力机制

系统采用三层架构：Handler 处理 HTTP 请求与响应、Service 封装业务逻辑、Repository 负责数据持久化。Handler 层通过嵌入基类 handler.Handler[model.Admin] 获得通用 CRUD 能力，服务层通过嵌入 service.IService[model.Admin] 接口获得通用服务方法。Controller 与 Service 之间通过依赖注入建立关联，Service 持有 Repository 实例完成数据操作。

密码处理采用差异化策略：新增管理员时 password 字段必填且直接加密存储，编辑管理员时 password 字段留空表示不修改、填写则触发加密更新。用户名重复检查在服务层实现，遵循涉及多字段关联的验证逻辑统一放置于服务层的原则。

快速开始

首先确认项目已具备以下前置条件：基控制器基类、基服务基类、Admin 模型定义、管理员登录所用的 Repository。

创建控制器文件 internal/handler/admin/auth/admin.go，定义 AuthAdminHandler 结构体，嵌入基控制器并持有服务层实例，初始化时通过 handler.WithOmitFields 配置创建接口需忽略的字段（id、login_failure、last_login_at、last_login_ip、deleted_at）。

创建服务文件 internal/service/admin/auth/admin.go，定义 AuthAdminService 结构体，嵌入基服务接口并持有 Repository 实例。

定义请求 DTO：AdminUpdateRequest 用于更新，包含 username、nickname、avatar、email、mobile、password、bio、status 字段，其中 username、nickname、status 为必填；AdminCreateRequest 嵌入更新 DTO 并额外要求 password 必填。

在服务层重写新增与编辑方法，实现密码加密逻辑与用户名重复校验。

路由注册调用 handler.RegisterBaseRoutes(h, group) 自动挂载标准 CRUD 路由。

适用边界

当前实现仅支持管理员账号的基础 CRUD 操作，尚未接入权限管理体系。由于缺少管理员分组功能，无法在账号管理中设置管理员所属分组字段，也无法关联分组实现细粒度权限控制。用户名重复校验仅在单表范围内执行，跨系统或分库场景需扩展校验范围。零定制版本适用于对权限控制无要求的内部管理系统快速原型搭建，生产环境建议完善分组与权限模块。

核验清单

基控制器 handler.Handler 与基服务 service.IService 是否已完成封装且可复用。Admin 模型 model.Admin 的字段定义是否满足业务需求。Repository repoAdmin.AdminRepository 是否已完成初始化并注入服务层。服务层是否正确处理密码加密逻辑（新增必加密、编辑有值才加密）。用户名唯一性校验是否在服务层实现。控制器创建与编辑方法的请求参数是否使用自定义 DTO 接收。路由注册后是否验证接口可正常访问。

来源与核验

  • 原始文章
  • 页面事实以原始来源及其引用的官方资料为准；版本、星标和模型能力会随时间变化。
  • AI Stack 不公开抓取到的全文快照，只发布独立转写与来源入口。

站内链接

相关文章