主要功能: - 实现完整的 RBAC 权限系统(账号、角色、权限的多对多关联) - 基于 owner_id + shop_id 的自动数据权限过滤 - 使用 PostgreSQL WITH RECURSIVE 查询下级账号 - Redis 缓存优化下级账号查询性能(30分钟过期) - 支持多租户数据隔离和层级权限管理 技术实现: - 新增 Account、Role、Permission 模型及关联关系表 - 实现 GORM Scopes 自动应用数据权限过滤 - 添加数据库迁移脚本(000002_rbac_data_permission、000003_add_owner_id_shop_id) - 完善错误码定义(1010-1027 为 RBAC 相关错误) - 重构 main.go 采用函数拆分提高可读性 测试覆盖: - 添加 Account、Role、Permission 的集成测试 - 添加数据权限过滤的单元测试和集成测试 - 添加下级账号查询和缓存的单元测试 - 添加 API 回归测试确保向后兼容 文档更新: - 更新 README.md 添加 RBAC 功能说明 - 更新 CLAUDE.md 添加技术栈和开发原则 - 添加 docs/004-rbac-data-permission/ 功能总结和使用指南 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
164 lines
4.2 KiB
Go
164 lines
4.2 KiB
Go
package handler
|
|
|
|
import (
|
|
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
|
"github.com/break/junhong_cmp_fiber/pkg/response"
|
|
"strconv"
|
|
|
|
"github.com/gofiber/fiber/v2"
|
|
|
|
"github.com/break/junhong_cmp_fiber/internal/model"
|
|
accountService "github.com/break/junhong_cmp_fiber/internal/service/account"
|
|
)
|
|
|
|
// AccountHandler 账号 Handler
|
|
type AccountHandler struct {
|
|
service *accountService.Service
|
|
}
|
|
|
|
// NewAccountHandler 创建账号 Handler
|
|
func NewAccountHandler(service *accountService.Service) *AccountHandler {
|
|
return &AccountHandler{service: service}
|
|
}
|
|
|
|
// Create 创建账号
|
|
// POST /api/v1/accounts
|
|
func (h *AccountHandler) Create(c *fiber.Ctx) error {
|
|
var req model.CreateAccountRequest
|
|
if err := c.BodyParser(&req); err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
|
|
}
|
|
|
|
account, err := h.service.Create(c.UserContext(), &req)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, account)
|
|
}
|
|
|
|
// Get 获取账号详情
|
|
// GET /api/v1/accounts/:id
|
|
func (h *AccountHandler) Get(c *fiber.Ctx) error {
|
|
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
account, err := h.service.Get(c.UserContext(), uint(id))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, account)
|
|
}
|
|
|
|
// Update 更新账号
|
|
// PUT /api/v1/accounts/:id
|
|
func (h *AccountHandler) Update(c *fiber.Ctx) error {
|
|
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
var req model.UpdateAccountRequest
|
|
if err := c.BodyParser(&req); err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
|
|
}
|
|
|
|
account, err := h.service.Update(c.UserContext(), uint(id), &req)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, account)
|
|
}
|
|
|
|
// Delete 删除账号
|
|
// DELETE /api/v1/accounts/:id
|
|
func (h *AccountHandler) Delete(c *fiber.Ctx) error {
|
|
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
if err := h.service.Delete(c.UserContext(), uint(id)); err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, nil)
|
|
}
|
|
|
|
// List 查询账号列表
|
|
// GET /api/v1/accounts
|
|
func (h *AccountHandler) List(c *fiber.Ctx) error {
|
|
var req model.AccountListRequest
|
|
if err := c.QueryParser(&req); err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
|
|
}
|
|
|
|
accounts, total, err := h.service.List(c.UserContext(), &req)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.SuccessWithPagination(c, accounts, total, req.Page, req.PageSize)
|
|
}
|
|
|
|
// AssignRoles 为账号分配角色
|
|
// POST /api/v1/accounts/:id/roles
|
|
func (h *AccountHandler) AssignRoles(c *fiber.Ctx) error {
|
|
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
var req model.AssignRolesRequest
|
|
if err := c.BodyParser(&req); err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
|
|
}
|
|
|
|
ars, err := h.service.AssignRoles(c.UserContext(), uint(id), req.RoleIDs)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, ars)
|
|
}
|
|
|
|
// GetRoles 获取账号的所有角色
|
|
// GET /api/v1/accounts/:id/roles
|
|
func (h *AccountHandler) GetRoles(c *fiber.Ctx) error {
|
|
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
roles, err := h.service.GetRoles(c.UserContext(), uint(id))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, roles)
|
|
}
|
|
|
|
// RemoveRole 移除账号的角色
|
|
// DELETE /api/v1/accounts/:account_id/roles/:role_id
|
|
func (h *AccountHandler) RemoveRole(c *fiber.Ctx) error {
|
|
accountID, err := strconv.ParseUint(c.Params("account_id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的账号 ID")
|
|
}
|
|
|
|
roleID, err := strconv.ParseUint(c.Params("role_id"), 10, 64)
|
|
if err != nil {
|
|
return errors.New(errors.CodeInvalidParam, "无效的角色 ID")
|
|
}
|
|
|
|
if err := h.service.RemoveRole(c.UserContext(), uint(accountID), uint(roleID)); err != nil {
|
|
return err
|
|
}
|
|
|
|
return response.Success(c, nil)
|
|
}
|