多租户的后台管理系统框架涉及到在不同租户之间隔离数据(字段隔离)------------升鲜宝供应链管理系统NestJs版本(一)
在多租户系统中,为了区分平台级用户和租户级用户,我们通常会使用一个特定的租户ID来表示平台级用户和角色。这种设计确保了平台级用户和角色能够被正确识别和管理,而不会与任何具体租户的用户和角色混淆。 ### 设计方案 1. **特定租户ID**:使用一个特定的租户ID(例如,`0` 或 `1`)来表示平台级用户和角色。这样可以明确区分平台级用户和租户级用户。 2. **数据库字段**:在`ns_user`和`ns_role`表中使用这个特定的租户ID来标识平台级用户和角色。 ### 修改数据字典 #### **1. ns_tenant (租户表)** 无需修改,继续存储租户的基本信息。 #### **2. ns_user (用户表)** 添加注释以说明特定的租户ID用于平台级用户。 ```sql CREATE TABLE `ns_user` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键。平台用户使用特定租户ID,如0', `name` VARCHAR(255) NOT NULL COMMENT '用户名', `email` VARCHAR(255) UNIQUE COMMENT '邮箱', `password` VARCHAR(255) COMMENT '密码', `role_id` BIGINT COMMENT '角色ID,外键', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`), FOREIGN KEY (`role_id`) REFERENCES `ns_role` (`id`) ) COMMENT='用户表,存储租户内用户的信息,平台用户使用特定租户ID'; ``` #### **3. ns_role (角色表)** 添加注释以说明特定的租户ID用于平台级角色。 ```sql CREATE TABLE `ns_role` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键。平台角色使用特定租户ID,如0', `name` VARCHAR(255) NOT NULL COMMENT '角色名称', `description` TEXT COMMENT '角色描述', `role_type` VARCHAR(50) COMMENT '角色类型(如 platform_admin, tenant_admin)', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`) ) COMMENT='角色表,定义租户内不同的角色和它们的基本信息,平台角色使用特定租户ID'; ``` ### 完整的 SQL 语句 结合以上调整,以下是完整的SQL创建语句: ```sql -- 创建租户表 CREATE TABLE `ns_tenant` ( `id` BIGINT AUTO_INCREMENT, `name` VARCHAR(255) NOT NULL COMMENT '租户名称', `description` TEXT COMMENT '租户描述', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`) ) COMMENT='租户表,存储租户基本信息'; -- 创建用户表 CREATE TABLE `ns_user` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键。平台用户使用特定租户ID,如0', `name` VARCHAR(255) NOT NULL COMMENT '用户名', `email` VARCHAR(255) UNIQUE COMMENT '邮箱', `password` VARCHAR(255) COMMENT '密码', `role_id` BIGINT COMMENT '角色ID,外键', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`), FOREIGN KEY (`role_id`) REFERENCES `ns_role` (`id`) ) COMMENT='用户表,存储租户内用户的信息,平台用户使用特定租户ID'; -- 创建角色表 CREATE TABLE `ns_role` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键。平台角色使用特定租户ID,如0', `name` VARCHAR(255) NOT NULL COMMENT '角色名称', `description` TEXT COMMENT '角色描述', `role_type` VARCHAR(50) COMMENT '角色类型(如 platform_admin, tenant_admin)', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`) ) COMMENT='角色表,定义租户内不同的角色和它们的基本信息,平台角色使用特定租户ID'; -- 创建权限表 CREATE TABLE `ns_permission` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键', `name` VARCHAR(255) NOT NULL COMMENT '权限名称', `description` TEXT COMMENT '权限描述', `resource_type` VARCHAR(50) COMMENT '资源类型(如 button, menu, column)', `resource_name` VARCHAR(255) COMMENT '资源名称', `action` VARCHAR(50) COMMENT '允许的操作(如 read, write)', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`) ) COMMENT='权限表,定义系统内的权限和它们的作用范围'; -- 创建组织机构表 CREATE TABLE `ns_org` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID,外键', `name` VARCHAR(255) NOT NULL COMMENT '组织名称', `description` TEXT COMMENT '组织描述', `parent_id` BIGINT COMMENT '父组织ID', `sort_code` INT COMMENT '排序码', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`), FOREIGN KEY (`parent_id`) REFERENCES `ns_org` (`id`) ) COMMENT='组织机构表,用于管理租户内的组织结构,如部门或团队'; -- 创建菜单表 CREATE TABLE `ns_menu` ( `id` BIGINT AUTO_INCREMENT, `parent_id` BIGINT COMMENT '父菜单ID,用于创建菜单层级', `title` VARCHAR(255) NOT NULL COMMENT '菜单标题', `path` VARCHAR(255) COMMENT '菜单对应的路径', `icon` VARCHAR(100) COMMENT '菜单项图标', `sort_order` INT COMMENT '菜单排序', `enabled` INT DEFAULT 1 COMMENT '状态 (0 禁用, 1 启用)', `remark` TEXT COMMENT '备注', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`parent_id`) REFERENCES `ns_menu` (`id`) ) COMMENT='菜单表,存储系统菜单项,通常用于构建用户界面的导航系统'; -- 创建角色菜单表 CREATE TABLE `ns_role_menu` ( `id` BIGINT AUTO_INCREMENT, `role_id` BIGINT COMMENT '角色ID', `menu_id` BIGINT COMMENT '菜单ID', `permission` VARCHAR(50) COMMENT '对该菜单的具体权限(如查看、编辑)', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`role_id`) REFERENCES `ns_role` (`id`), FOREIGN KEY (`menu_id`) REFERENCES `ns_menu` (`id`) ) COMMENT='角色菜单表,定义角色和菜单之间的关系,控制不同角色可访问的菜单项'; -- 创建角色机构权限范围表 CREATE TABLE `ns_role_org_permission` ( `id` BIGINT AUTO_INCREMENT, `role_id` BIGINT COMMENT '角色ID', `org_id` BIGINT COMMENT '组织机构ID', `permission` VARCHAR(50) COMMENT '权限类型(如读、写)', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`role_id`) REFERENCES `ns_role` (`id`), FOREIGN KEY (`org_id`) REFERENCES `ns_org` (`id`) ) COMMENT='角色机构权限范围表,定义角色在不同组织结构中的数据访问权限'; -- 创建角色数据列权限表 CREATE TABLE `ns_role_column_permission` ( `id` BIGINT AUTO_INCREMENT, `role_id` BIGINT COMMENT '角色ID', `table_name` VARCHAR(255) COMMENT '数据表名称', `column_name` VARCHAR(255) COMMENT '列名称', `permission_type` VARCHAR(50) COMMENT '权限类型(如读、写)', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`role_id`) REFERENCES `ns_role` (`id`) ) COMMENT='角色数据列权限表,管理角色对不同数据表列的访问权限'; -- 创建支付明细费用表 CREATE TABLE `ns_payment_detail` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID', `package_id` BIGINT COMMENT '套餐ID', `subscription_id` BIGINT COMMENT '订阅ID,关联`ns_tenant_package_subscription`表', `amount` DECIMAL(10, 2) COMMENT '支付金额', `payment_method` VARCHAR(255) COMMENT '支付方式(如信用卡、PayPal、转账等)', `payment_status` VARCHAR(50) COMMENT '支付状态(如`pending`, `completed`, `failed`)', `transaction_id` VARCHAR(255) COMMENT '交易流水号', `payment_date` DATETIME COMMENT '支付日期', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`), FOREIGN KEY (`package_id`) REFERENCES `ns_package` (`id`), FOREIGN KEY (`subscription_id`) REFERENCES `ns_tenant_package_subscription` (`id`) ) COMMENT='支付明细费用表,用于记录租户订购套餐时的支付明细'; -- 创建租户套餐订阅表 CREATE TABLE `ns_tenant_package_subscription` ( `id` BIGINT AUTO_INCREMENT, `tenant_id` BIGINT COMMENT '租户ID', `package_id` BIGINT COMMENT '套餐ID', `subscription_date` DATE COMMENT '订阅日期', `expiration_date` DATE COMMENT '到期日期', `status` VARCHAR(50) COMMENT '状态(如激活、过期)', `created_by` BIGINT COMMENT '创建人ID', `updated_by` BIGINT COMMENT '更新人ID', `is_deleted` BOOLEAN DEFAULT FALSE COMMENT '是否删除', `created_date` DATETIME COMMENT '创建时间', `updated_date` DATETIME COMMENT '更新时间', PRIMARY KEY (`id`), FOREIGN KEY (`tenant_id`) REFERENCES `ns_tenant` (`id`), FOREIGN KEY (`package_id`) REFERENCES `ns_package` (`id`) ) COMMENT='租户套餐订阅表,管理租户订阅套餐的详情'; ``` 在上述设计中: - `tenant_id`字段为`0`时表示平台级用户和角色。 - 普通租户用户和角色使用具体的`tenant_id`来标识其所属的租户。 这种设计确保了平台级用户和角色能够被正确识别和管理,不会与任何具体租户的用户和角色混淆。