用Yii实现多级代理后台的核心是自关联模型设计、代理树权限隔离、事务化关系变更与佣金计算、以及异步树形前端展示；Agent表通过parent_id和path字段支持无限层级，控制器统一拦截数据范围，佣金逻辑封装为独立Service，前端按需加载代理树。
用 Yii 搭建代理商后台并支持多级代理关系，核心在于模型设计、关系映射、权限隔离和业务逻辑分层。不靠第三方插件，纯框架能力就能实现清晰、可扩展的代理层级结构。
代理模型设计：用自关联实现无限层级
一张 agent 表即可支撑多级代理，关键字段包括：id、username、parent_id（指向本表 id）、level（可缓存当前层级，提升查询效率）、status、created_at 等。在 Agent 模型中定义自关联：
-
父代理关系：
getParent()关联Agent::className()，on condition 为'id' => 'parent_id' -
下级代理列表：
getChildren()关联自身，where 条件['parent_id' => $this->id] -
所有下级（含子孙）：用递归查询或闭包表（推荐初期用递归 + 缓存），避免 N+1；也可在创建/移动时更新
path字段（如',1,5,12,'）快速判断归属
后台权限控制：按代理树隔离数据
不能让 A 代理看到 B 代理的数据。在控制器基类（如 AgentController）中统一拦截：
- 登录后从用户获取当前代理记录，并缓存其
id和path（或预查所有可管子节点 ID 数组） - 查询订单、客户、下级等资源时，统一加条件：
andWhere(['like', 'path', ',' . $currentAgent->path])或andWhere(['in', 'agent_id', $allManagedIds]) - RBAC 可复用，但角色分配需绑定代理实体，例如
agent-admin-123角色只对 ID=123 的代理生效
代理关系变更与佣金计算逻辑封装
发展下级、转移代理、升级等级等操作需事务保障，并触发佣金/分润规则：
- 使用
ActiveRecord::transaction()包裹代理绑定、层级更新、日志写入、上级返佣记录生成 - 佣金规则建议抽成独立 Service 类（如
CommissionService），接收订单、当前代理、规则配置，逐层向上计算（最多遍历到平台级），支持固定比例、阶梯比例、冻结期等策略 - 避免在 Controller 中写业务逻辑，把「谁有资格分」、「分多少」、「何时发」拆解为可测试的方法
前端展示与代理树交互优化
后台需直观呈现代理网络，但全量加载会卡顿：
- 树形结构用异步加载：点击「展开」再请求该节点的直接子代理（limit 50），支持搜索+模糊匹配用户名
- 关键指标聚合放列表页：每个代理行显示「直属下级数」「当月订单总额」「待结算佣金」，通过子查询或冗余字段（定期任务更新）保证性能
- 禁止跨层操作 UI，比如三级代理不能直接绑定一级代理；表单提交前校验
parent_id是否为其合法上级（可用isDescendantOf($parentId)方法）
