# 代理角色模板

使用现有 sys_config、sys_role、sys_role_menu、sys_dept、sys_user_role 表，不新增字段、索引或任务表。

平台参数：tenant_id=000000，config_key=agent.role.template.role_id，config_value 为本平台企业的模板角色 ID。开发环境使用 82。模板在企业管理的角色管理维护，正常启用、is_pass=1、数据范围为本机构及下级（4），按钮不允许全部或自定义数据范围。每个企业只能有一个下发模板。

模板修改提交后直接同步直属企业，按 sys_dept.parent_id 定位直属客户、dept_role 定位该企业实际默认角色。通过 created_dept 和上下级关系识别下发角色，不依赖 source_role_id 或 source_dept_id。平台模板切换限定同一企业，旧任务读取当前配置。下级企业维护自己的客户模板，不直接继承平台对孙级的新增授权。

同步保留角色 ID 和账号绑定，每家企业独立事务。单家失败不阻塞其他企业，接口报告同步失败，日志记录失败企业。保存成功和同步成功分开处理；失败时模板可能已保存，修复角色关联后重新保存可幂等重试。不会凭空修复账号绑定。

接口鉴权读取当前权限并与上级企业和平台模板取交集，不依赖长期用户权限缓存。没有有效角色或模板参数无效时拒绝授权。业务角色授权记录不会主动删除，模板恢复权限后仍保留授权的角色可能重新获得权限。前端按钮更新需刷新，后端执行当前鉴权。

采用提交后直接同步，不保证模板保存和全体客户同步原子完成。进程在提交后、同步完成前退出时，需要重新保存触发补偿；没有数据库持久化任务，不承诺自动恢复丢失任务。原有角色同步队列保留兼容重试和旧消息处理，不新增队列配置或定时任务。

正式上线前验证三级企业、参数切换、权限收回、旧登录账号、单家无效角色、重复同步和真实并发请求。同步随直属企业数量增加会延长请求耗时，需结合实际规模验证 API 超时与数据库负载。