架构与系统设计 / 系统课时
组织层级设计
组织层级设计
本课完成平台、代理商、商户和门店的统一组织树设计,并给出可落库、可查询、可授权的数据模型。完成后,你可以用一张组织表表达上下级关系,按需加载子节点,并为后续数据权限提供稳定边界。
学习目标
- 理解平台、代理商、商户、门店之间的层级约束
- 设计可扩展的组织表与关键索引
- 实现组织树查询和数据范围过滤
先确定组织树的业务规则
组织树不是简单的分类目录,而是权限与数据归属的基础。平台位于根节点;平台代理商可以管理下级代理商或商户;商户下面可以继续划分门店。每个节点只能有一个直接父节点,但可以拥有多个子节点。
推荐把节点类型限定为 PLATFORM、AGENT、MERCHANT、STORE。类型决定节点能创建什么下级:平台可创建代理商和直属商户,代理商可创建下级代理商或商户,商户只能创建门店,门店不能再创建子节点。这样可以在服务层提前阻止非法层级。

设计统一组织表
使用一张 sys_org 表保存所有组织节点,可以避免平台代理商、商户、门店分别维护树关系。业务详情仍可放在代理商表、商户表和门店表中,通过 biz_id 关联。
CREATE TABLE sys_org (
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '组织节点主键',
parent_id BIGINT NOT NULL DEFAULT 0 COMMENT '父节点,0 表示根节点',
org_type VARCHAR(20) NOT NULL COMMENT 'PLATFORM/AGENT/MERCHANT/STORE',
org_name VARCHAR(100) NOT NULL COMMENT '组织名称',
biz_id BIGINT DEFAULT NULL COMMENT '关联业务表主键',
status TINYINT NOT NULL DEFAULT 1 COMMENT '1 启用,0 停用',
sort_no INT NOT NULL DEFAULT 0 COMMENT '同级排序',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY idx_parent_status_sort (parent_id, status, sort_no, id),
KEY idx_type_biz (org_type, biz_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;生效行为:parent_id 保存直接父子关系,idx_parent_status_sort 支持按父节点分页或懒加载子节点,idx_type_biz 支持从商户、代理商或门店反查组织节点。根节点建议只保留一个平台节点,并由初始化脚本创建。
验证 SQL:
SELECT id, parent_id, org_type, org_name
FROM sys_org
WHERE parent_id = 10
AND status = 1
ORDER BY sort_no, id;预期结果:
id parent_id org_type org_name
21 10 MERCHANT 华南零售商户
22 10 AGENT 华东二级代理实际主键和名称会随测试数据变化,但结果只应包含 parent_id = 10 的直接子节点。
实现懒加载树查询
后台首次进入组织页时,只查询根节点或当前用户可见的顶层节点;展开某个节点时,再按 parent_id 查询直接子节点。相比一次性递归整棵树,懒加载在组织数量较多时更稳定,也更容易结合数据权限。
服务层返回节点时应增加 hasChildren,前端据此决定是否显示展开按钮。可以通过 EXISTS 判断是否存在启用子节点,避免提前加载完整子树。
SELECT o.id,
o.parent_id,
o.org_type,
o.org_name,
EXISTS (
SELECT 1
FROM sys_org c
WHERE c.parent_id = o.id
AND c.status = 1
) AS has_children
FROM sys_org o
WHERE o.parent_id = 0
AND o.status = 1
ORDER BY o.sort_no, o.id;预期结果:
id parent_id org_type org_name has_children
1 0 PLATFORM 企业支付平台 1has_children = 1 表示节点可继续展开,不代表当前用户一定拥有全部子节点权限,真正返回子节点时仍要追加可见范围条件。
把组织关系用于数据权限
组织树只描述“谁属于谁”,数据权限还要描述“当前用户能看哪些节点”。常见范围包括全部组织、当前组织、当前组织及子级、指定组织和仅本人。用户与组织的归属关系可通过 sys_user_org(user_id, org_id) 保存,角色或岗位再决定数据范围类型。
查询订单时,不要先查出全部组织 ID 再拼接超长 IN。规模较小时可以缓存当前组织的后代 ID;规模较大时可增加闭包表或路径字段,避免多层递归。无论使用哪种方案,都必须在服务端生成范围条件,不能信任前端传入的组织 ID。
提示:创建或移动节点时,要校验新父节点类型、禁止把节点移动到自己的后代下面,并在停用父节点前检查仍在使用的子节点。
验收组织树设计
完成实现后,应验证四个结果:根节点唯一;非法层级无法创建;展开节点只返回直接子级;普通商户用户无法查询其他商户或代理商的数据。再使用 EXPLAIN 检查子节点查询是否命中 idx_parent_status_sort。