代理删除使用指南
这篇文档给后台操作者使用。它不解释接口和数据库，只说明删除代理时应该怎么选、为什么会被拦截，以及遇到提示后应该怎么处理。
删除不可恢复
代理删除是永久操作，不是停用，也不是放入回收站。执行前请先确认删除范围、迁移目标、结算和余额处理都正确。
删除前先确认
删除代理前，建议先确认这些事情：
admin是代理树根节点，不能删除。- 不能删除当前登录代理自己。
- 只能删除自己有权限管理范围内的代理。
- 被删除代理需要处于正常状态。
- 如果弹窗提示源子树中有停用代理，请先启用或处理为正常状态后再删除。
- 代售结算必须处理到“已支付”才算结清。
- 删除范围内的用户、未使用卡密、余额都要按弹窗要求处理。
两种删除方式
打开代理列表或代理树中的代理操作菜单，选择“删除代理”。删除弹窗会提供两种方式：
| 删除方式 | 适合场景 | 会发生什么 |
|---|---|---|
| 删除当前代理并上提子代理 | 只想移除中间节点，保留下级代理继续经营 | 只删除当前代理；它的所有直接子代理会同时挂到当前代理的父级下面 |
| 删除整棵子树 | 当前代理和全部下级都不再需要 | 当前代理和它的所有下级都会被删除 |
例如当前结构是：
上级 P
└─ 代理 A
├─ 子代理 B
│ └─ 子代理 B1
├─ 子代理 C
└─ 子代理 D如果选择“删除当前代理并上提子代理”，删除后会变成：
上级 P
├─ 子代理 B
│ └─ 子代理 B1
├─ 子代理 C
└─ 子代理 D也就是说，多个直接子代理会一起上提，每个子代理下面原有的子树会保留。
如果选择“删除整棵子树”，A/B/B1/C/D 都会进入删除范围。
删除当前代理并上提子代理
这个模式只删除当前代理本身。直接子代理会挂到当前代理的原父级下，子代理自己的授权、卡类型、价格和权限保持不变。
因此，判断结算阻断时只看“当前被删除代理”是否还有未结清结算，不会因为下级之间自己的结算关系而阻止删除当前代理。
举例：
A -> B -> C| 情况 | 删除动作 | 是否阻断 |
|---|---|---|
| 只有 B 对 C 的结算未支付 | 删除 A 并上提 B | 不阻断 |
| A 对 B 的结算未支付 | 删除 A 并上提 B | 阻断 |
| B 对 C 的结算未支付 | 删除 B 并上提 C | 阻断 |
原因很简单：删除 A 时，B 和 C 仍然存在，B 对 C 的结算关系也仍然存在，不需要因为删除 A 而强制处理。删除 B 时，B 本身要消失，所以 B 相关结算必须先结清。
删除整棵子树
这个模式会删除当前代理和全部下级。系统会检查整棵子树：
- 子树里任何代理有未生成、未审核或未支付完成的代售结算，都会阻断。
- 子树里所有用户和未使用卡密都必须按软件迁移到合规目标代理。
- 子树里余额不为 0 的余额充值代理必须转移余额或清零调账。
- 如果选择迁移已激活卡密，也需要为对应软件选择合规目标代理。
如果你只是想去掉一个中间节点，不要选择删除整棵子树。
按软件迁移用户和卡密
删除范围内如果存在用户或卡密，弹窗会按软件列出迁移项。你可以为不同软件选择不同迁移目标。
迁移目标需要满足：
- 代理处于正常状态。
- 在当前操作者可管理范围内。
- 不在本次删除范围内。
- 已拥有对应软件授权。
- 对需要迁移的卡类型拥有授权和价格。
- 目标代理价格不能低于被删除范围内原归属代理的价格。
用户和未使用卡密必须迁移。已激活卡密默认不改归属，也就是说这批已经用过的卡密仍然记录在原代理名下，方便核对历史；如果希望它们也归到新代理名下，可以先勾选“迁移已激活卡密”，再选择迁移目标。
如果某个软件没有可选迁移目标，通常说明目标代理缺少软件授权、卡类型授权或价格。先补齐目标代理，再重新打开删除弹窗预检。
余额处理
如果删除范围内有余额充值代理，且余额不为 0，必须选择一种处理方式：
| 方式 | 说明 |
|---|---|
| 转移余额 | 把余额转入另一个正常、可管理、删除范围外的余额充值代理 |
| 清零调账 | 把余额调整为 0，需要填写原因；没有调账权限时不能使用 |
余额不能转入代售结算代理，也不能转入本次即将删除的代理。
如果代理没有余额，弹窗不会要求你处理余额。
结算阻断怎么看
删除弹窗提示“存在未生成、未审核或未支付完成的代售结算”时，先看弹窗列出的“应结算人”和“被结算人”。
常见状态含义：
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 未生成结算单 | 已产生结算流水，但还没有生成结算单 | 以对应应结算人的视角生成结算单 |
| 未审核 | 结算单已生成，但还没有审核通过 | 审核结算单 |
| 未支付 | 结算单已审核，但还没有标记支付 | 标记支付 |
只有标记为“已支付”的结算才不会阻断删除。只生成结算单、只审核通过都还不够。
结算操作视角
结算单的生成、审核、支付和作废，应由对应“应结算人”的结算视角处理。上级可以查看下级报表，但不要跨级代替下级完成结算动作。
为什么有结算阻断时下方内容会隐藏
如果删除范围内存在未结清结算，删除无论如何都不能执行。这时弹窗可能只显示阻断原因和结算明细，不再展示“按软件迁移”“余额处理”等内容。
这是正常现象。请先把结算处理到已支付，再重新打开删除弹窗。系统会重新生成删除计划，并显示后续需要迁移或处理的内容。
常见提示和处理方式
不能删除平台根代理
admin 是整棵代理树的根，必须保留。请选择 admin 下方的普通代理。
不能删除当前登录代理
你不能删除自己正在登录的代理账号。请使用上级代理或管理员账号操作。
被删除代理不是正常状态
删除前需要让被删除代理处于正常状态。请先启用或处理代理状态，再删除。
源子树中存在已停用代理
删除计划要求源子树处于可确认状态。如果弹窗指出某个下级已停用，请先处理该代理状态，再重新预检。
存在未生成、未审核或未支付完成的结算
按弹窗列出的“应结算人”和“被结算人”处理结算。完成生成、审核、标记支付后，再重新删除。
删除范围外仍有未使用代售卡密引用删除范围
删除范围外还有未使用代售卡密，它的结算链路引用了即将删除的代理。请先处理这些库存卡密，再删除。
常见处理方式是先回收、消耗、作废或迁移相关库存，直到弹窗不再提示这类阻断。
该软件存在需要迁移的用户或卡密
为对应软件选择迁移目标代理。用户和未使用卡密不能留在即将删除的代理名下。
迁移目标缺少软件授权
目标代理没有对应软件授权。请选择另一个目标，或先给目标代理补齐软件授权。
迁移目标缺少卡类型授权或价格
目标代理没有对应卡类型授权，或没有设置该卡类型价格。先补齐授权和价格，再重新预检。
迁移目标价格低于迁出代理成本价
目标代理价格太低，迁移后会造成价格倒挂。请提高目标代理价格，或选择价格满足要求的目标代理。
代理钱包余额非 0
选择“转移余额”或“清零调账”。如果选择清零调账，需要填写原因，并且操作者要有调账权限。
余额转入目标不合规
余额只能转入正常、可管理、删除范围外的余额充值代理。不能转入代售结算代理，也不能转入即将删除的代理。
删除后保留什么
删除完成后：
- 被删除代理账号、授权、价格和钱包配置会被移除。
- 选择迁移的用户、未使用卡密和可选的已激活卡密会归属到新目标代理；未勾选迁移的已激活卡密会保留原有历史归属。
- 已支付结算历史、审计记录、钱包流水等历史记录会保留，用于后续核对。
- 如果是“删除当前代理并上提子代理”，被上提子代理和它们的下级会继续存在。
删除不会重新计算已经完成的历史结算，也不会把历史审计记录抹掉。
建议操作顺序
大规模删除代理前，建议按这个顺序处理：
- 先处理结算：相关结算全部生成、审核并标记支付。
- 再处理状态：确认被删除代理和源子树没有异常状态。
- 再准备迁移目标：按软件确认目标代理拥有授权、卡类型和价格。
- 再处理余额：决定转移余额还是清零调账。
- 最后执行删除，并检查代理树、用户、卡密和余额流水。
如果只是调整代理树结构，优先考虑“删除当前代理并上提子代理”或“迁移节点”；如果整个分支都不再使用，再选择“删除整棵子树”。