主题
配置权限与智能诊断
一、功能简介
在权限中心把三套权限配下去，并在配完之后用「诊断」验证某个人到底拿到了什么权限。这一篇讲具体怎么操作；三套权限分别管什么，先看权限中心入门。
二、什么时候用它
- 新人入职，要给他开通能用的功能和能看的数据。
- 有人反馈"进得去页面但列表是空的"或"按钮不见了"。
- 想知道某个人现在到底有哪些权限、是从哪来的。
- 要查某个权限是谁、什么时候改的。
三、开始之前
| 项 | 说明 |
|---|---|
| 入口 | 左侧菜单「系统管理 → 权限中心」，页面顶部按 tab 切换：概览 / 功能权限 / 数据权限 / 项目权限 / 权限码注册 / 审计 |
| 操作权限 | 权限中心属于管理员功能。没有权限时相关 tab 或按钮不显示，请联系管理员开通 |
| 配置顺序 | 建议功能权限 → 数据权限 → 项目权限，顺序反了容易出现"能进页面但没数据" |
四、操作步骤
A. 配功能权限（能进哪些页面、点哪些按钮）
- 切到「功能权限」tab，左侧是本组织所有角色。
- 选中一个角色 → 打开角色详情。
- 在权限码区勾选这个角色该有的功能（菜单、按钮）。
- 在成员区把用户加进这个角色。
改完立即生效：无论是改权限码还是改成员（授予/回收角色），都不需要用户重新登录。
〔待补截图 2：功能权限 tab，左侧角色列表 + 右侧角色详情抽屉，框住权限码勾选区与成员区。〕
B. 看智能诊断提醒（配一半会被提醒）
打开角色详情时，系统会根据这个角色包含的权限码，推断它涉及哪些数据维度；如果对应的数据权限还没配，会高亮告警并列出缺哪些维度。
- 例：角色里有「客户查看」但没配客户维度的可见部门 → 提醒你去配，否则成员进得了客户页面却看不到任何客户。
- 这个提醒只提示、不强制，你可以忽略后自行判断。
〔待补截图 3：角色详情里出现的黄色/红色诊断提醒条，框住"缺少 XX 维度数据权限"的文字。〕
C. 配数据权限（同样的"查看"，能看多少）
- 切到「数据权限」tab（或在角色详情里点数据权限）。
- 选择维度（客户 / 目标 / 饱和度 / 积分 等）。
- 给角色选一个档位：「全部」/「指定范围」/「无」。
- 选「指定范围」时，下面有「按部门」「按人员」两个页签，两者取并集：按部门勾（自动含下级），按人员直接搜姓名点人、可跨部门。只放行几个特定的人时可以一个部门都不勾。 ⚠️ 按"部门归属"判定的维度（例如产品管理）没有「按人员」页签，只能按部门配。
同一个「查看客户」的权限，配了不同部门范围的人，看到的客户数量就不同 —— 这正是数据权限的意义。
D. 配项目权限（在具体项目里能干什么）
- 切到「项目权限」tab。
- 在权限组下建项目角色，给角色勾选项目内可做的操作。
- 角色分两类，成员维护的地方不一样：
- 模板角色：跨项目复用，成员在这里维护。
- 项目自带角色：成员要到「项目详情 → 人员」里管，这里改不了。
- 「项目经理」「项目资源」是默认角色，不可删除。
E. 用「用户权限诊断」验证结果
- 回到「概览」tab，找到用户权限诊断卡片。
- 输入用户的 usId（或直接查自己）。
- 一屏看到这个人的功能 / 数据 / 项目三维分别有哪些权限、分别来自哪个角色。
这是排查"他说没权限"最快的办法：先诊断，再决定改哪一维。
〔待补截图 4：概览 tab 的用户权限诊断卡片，输入 usId 后展示三维权限结果。〕
F. 查权限码注册表（给管理员/实施用）
「权限码注册」tab 可以看到已注册的权限码、各自被哪些角色引用，并能识别孤儿权限码（注册了没人用 / 数据库里有码但没注册）。
G. 查审计（谁改过权限）
「审计」tab 记录权限中心内的变更历史：谁、什么时候、对哪个角色或成员做了什么，可按关键字 / 操作人 / 类型 / 动作 / 时间筛选。
五、字段与选项说明
| 概念 | 说明 |
|---|---|
| 角色 | 功能权限的容器：先给角色配权限码，再把人放进角色 |
| 权限码 | 一个具体功能点（进某菜单 / 点某按钮）的开关 |
| 数据维度 | 客户管理 / 目标管理 / 日报审核 / 饱和度 / 积分 / 战绩 等，每个维度单独配可见范围（部门 + 人员） |
| 权限组 | 项目权限的容器，里面放项目角色 |
| 模板角色 / 项目自带角色 | 前者成员在权限中心维护；后者成员在项目详情 → 人员里维护 |
六、常见问题与注意事项
- 进得了页面但列表是空的 —— 典型的"功能权限配了、数据权限没配"。去数据权限 tab 给对应维度配可见范围（部门和/或人员）。
- 改了权限要不要重新登录？ 不用。功能权限改权限码、改成员都是即时生效的；项目权限也即时生效。
- 项目自带角色的成员在这里改不了 —— 那类角色的成员归项目自己维护，去「项目详情 → 人员」。
- 「项目经理」「项目资源」删不掉 —— 系统默认角色，有意保护。
- 权限码不是随便加的 —— 注册表里的码来自后端代码注解。后端没有的操作不要臆造权限码，否则那个按钮会对所有人隐藏。
- 数据权限里的日报维度叫「日报审核」 —— 它管的是"谁的日报我能批"，和项目里的日报审核权限取并集。（历史上短暂移除过一个旧的「日报」维度，现在能选到的是「日报审核」，以页面上当前列出的为准。）
七、相关功能
- 权限中心入门：先搞懂三套权限分别管什么
- 项目成员与项目内角色：项目自带角色的成员在这里维护
- 员工管理：先有账号，才谈权限