feat: 实现 RBAC 权限系统和数据权限控制 (004-rbac-data-permission)

主要功能:
- 实现完整的 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>
This commit is contained in:
2025-11-18 16:44:06 +08:00
parent e8eb5766cb
commit eaa70ac255
86 changed files with 15395 additions and 245 deletions

View File

@@ -0,0 +1,49 @@
package model
// CreateAccountRequest 创建账号请求
type CreateAccountRequest struct {
Username string `json:"username" validate:"required,min=3,max=50"`
Phone string `json:"phone" validate:"required,len=11"`
Password string `json:"password" validate:"required,min=8,max=32"`
UserType int `json:"user_type" validate:"required,min=1,max=4"`
ShopID *uint `json:"shop_id"`
ParentID *uint `json:"parent_id"`
}
// UpdateAccountRequest 更新账号请求
type UpdateAccountRequest struct {
Username *string `json:"username" validate:"omitempty,min=3,max=50"`
Phone *string `json:"phone" validate:"omitempty,len=11"`
Password *string `json:"password" validate:"omitempty,min=8,max=32"`
Status *int `json:"status" validate:"omitempty,min=0,max=1"`
}
// AccountListRequest 账号列表查询请求
type AccountListRequest struct {
Page int `json:"page" query:"page" validate:"omitempty,min=1"`
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100"`
Username string `json:"username" query:"username" validate:"omitempty,max=50"`
Phone string `json:"phone" query:"phone" validate:"omitempty,max=20"`
UserType *int `json:"user_type" query:"user_type" validate:"omitempty,min=1,max=4"`
Status *int `json:"status" query:"status" validate:"omitempty,min=0,max=1"`
}
// AccountResponse 账号响应
type AccountResponse struct {
ID uint `json:"id"`
Username string `json:"username"`
Phone string `json:"phone"`
UserType int `json:"user_type"`
ShopID *uint `json:"shop_id,omitempty"`
ParentID *uint `json:"parent_id,omitempty"`
Status int `json:"status"`
Creator uint `json:"creator"`
Updater uint `json:"updater"`
CreatedAt string `json:"created_at"`
UpdatedAt string `json:"updated_at"`
}
// AssignRolesRequest 分配角色请求
type AssignRolesRequest struct {
RoleIDs []uint `json:"role_ids" validate:"required,min=1"`
}