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:
9
migrations/000002_rbac_data_permission.down.sql
Normal file
9
migrations/000002_rbac_data_permission.down.sql
Normal file
@@ -0,0 +1,9 @@
|
||||
-- RBAC 表结构回滚迁移
|
||||
-- 删除所有 RBAC 相关表
|
||||
|
||||
-- 删除表(按依赖顺序反向删除)
|
||||
DROP TABLE IF EXISTS tb_role_permission;
|
||||
DROP TABLE IF EXISTS tb_account_role;
|
||||
DROP TABLE IF EXISTS tb_permission;
|
||||
DROP TABLE IF EXISTS tb_role;
|
||||
DROP TABLE IF EXISTS tb_account;
|
||||
20
migrations/000003_add_owner_id_shop_id.down.sql
Normal file
20
migrations/000003_add_owner_id_shop_id.down.sql
Normal file
@@ -0,0 +1,20 @@
|
||||
-- 000003_add_owner_id_shop_id.down.sql
|
||||
-- 示例迁移:回滚 owner_id 和 shop_id 字段
|
||||
-- 注:此为模板迁移,实际业务表由项目需求决定
|
||||
|
||||
-- 示例:回滚订单表的数据权限字段
|
||||
-- DROP INDEX IF EXISTS idx_orders_owner_shop;
|
||||
-- DROP INDEX IF EXISTS idx_orders_shop_id;
|
||||
-- DROP INDEX IF EXISTS idx_orders_owner_id;
|
||||
-- ALTER TABLE tb_orders DROP COLUMN IF EXISTS shop_id;
|
||||
-- ALTER TABLE tb_orders DROP COLUMN IF EXISTS owner_id;
|
||||
|
||||
-- 示例:回滚商品表的数据权限字段
|
||||
-- DROP INDEX IF EXISTS idx_products_owner_shop;
|
||||
-- DROP INDEX IF EXISTS idx_products_shop_id;
|
||||
-- DROP INDEX IF EXISTS idx_products_owner_id;
|
||||
-- ALTER TABLE tb_products DROP COLUMN IF EXISTS shop_id;
|
||||
-- ALTER TABLE tb_products DROP COLUMN IF EXISTS owner_id;
|
||||
|
||||
-- 占位语句(避免空迁移文件报错)
|
||||
SELECT 1;
|
||||
34
migrations/000003_add_owner_id_shop_id.up.sql
Normal file
34
migrations/000003_add_owner_id_shop_id.up.sql
Normal file
@@ -0,0 +1,34 @@
|
||||
-- 000003_add_owner_id_shop_id.up.sql
|
||||
-- 示例迁移:为业务表添加 owner_id 和 shop_id 字段
|
||||
-- 注:此为模板迁移,实际业务表由项目需求决定
|
||||
-- 使用方法:
|
||||
-- 1. 复制此模板
|
||||
-- 2. 修改表名为实际业务表
|
||||
-- 3. 根据业务需求调整字段类型和约束
|
||||
|
||||
-- 示例:为订单表添加数据权限字段
|
||||
-- ALTER TABLE tb_orders ADD COLUMN owner_id BIGINT;
|
||||
-- ALTER TABLE tb_orders ADD COLUMN shop_id BIGINT;
|
||||
--
|
||||
-- -- 创建索引以支持数据权限过滤
|
||||
-- CREATE INDEX idx_orders_owner_id ON tb_orders(owner_id) WHERE deleted_at IS NULL;
|
||||
-- CREATE INDEX idx_orders_shop_id ON tb_orders(shop_id) WHERE deleted_at IS NULL;
|
||||
-- CREATE INDEX idx_orders_owner_shop ON tb_orders(owner_id, shop_id) WHERE deleted_at IS NULL;
|
||||
|
||||
-- 示例:为商品表添加数据权限字段
|
||||
-- ALTER TABLE tb_products ADD COLUMN owner_id BIGINT;
|
||||
-- ALTER TABLE tb_products ADD COLUMN shop_id BIGINT;
|
||||
--
|
||||
-- CREATE INDEX idx_products_owner_id ON tb_products(owner_id) WHERE deleted_at IS NULL;
|
||||
-- CREATE INDEX idx_products_shop_id ON tb_products(shop_id) WHERE deleted_at IS NULL;
|
||||
-- CREATE INDEX idx_products_owner_shop ON tb_products(owner_id, shop_id) WHERE deleted_at IS NULL;
|
||||
|
||||
-- 通用数据权限字段规范:
|
||||
-- owner_id: 数据所有者账号 ID,关联 tb_account.id
|
||||
-- shop_id: 数据所属店铺 ID,用于店铺级别的数据隔离
|
||||
--
|
||||
-- 过滤条件示例:
|
||||
-- WHERE owner_id IN (当前用户及所有下级 ID) AND shop_id = 当前用户 shop_id
|
||||
|
||||
-- 占位语句(避免空迁移文件报错)
|
||||
SELECT 1;
|
||||
Reference in New Issue
Block a user