nexus/Project/fonrey/PRD/权限管理/权限管理模块PRD.md

PRD: 权限管理模块

状态: Draft
作者: 产品经理
最后更新: 2026-04-24（v1.1 锁定多角色合并规则 = 并集/最宽松）
版本: 1.1
所属系统: Fonrey 房产经纪管理系统
关联模块: 组织人事管理、房源管理、客源管理、系统设置

变更历史

版本	日期	作者	变更说明
v1.0	—	产品经理	初稿
v1.1	2026-04-24	产品经理	锁定多角色合并规则 = 并集 / 最宽松

---

1. 问题陈述

背景

房产经纪公司普遍存在多层级组织结构（总部 → 事业部 → 大区 → 区域 → 门店 → 店组），不同层级员工的业务职责和数据访问边界差异显著。在缺乏系统化权限管控的情况下，经纪公司面临以下核心痛点：

• 数据越权访问风险：经纪人可随意查看他人客户资料、房源联系方式，导致客源保护机制形同虚设，内部业务竞争失控
• 角色权限配置低效：每个系统账号独立配置权限，权限变更需逐一操作；人员增加或角色调整时，管理员重复劳动量巨大
• 权限与岗位不匹配：系统权限未与职务/职级联动，新员工默认权限可能超出岗位职责边界，造成数据安全隐患
• 个性化权限需求无法满足：部分员工因岗位特殊性需要在通用角色基础上增加或收窄特定权限，纯角色制度缺乏灵活性
• 权限变更缺乏追溯：权限调整无操作日志，出现数据纠纷时无法追溯是谁、何时、做了什么操作

目标用户

角色	描述	使用频率
Tenant Admin（租户管理员）	负责角色创建、权限配置、人员权限分配及批量操作，是本模块的核心使用者	每日
店长 / 区域经理	查看下属员工当前权限，按需发起权限变更申请	按需
Agent（经纪人）	受权限约束的数据访问者，感知到功能入口的显示/隐藏变化	被动感知

---

2. 目标与成功指标

目标	指标	当前基准	目标值	衡量周期
提升权限配置效率	完成一次人员权限分配耗时	约 20 分钟（估算，逐条配置）	< 2 分钟（批量设置角色）	上线后 60 天
降低越权访问事件	经纪人越权查看他人客源/联系方式的投诉工单数	待统计	减少 80%	上线后 90 天
提升权限管理透明度	管理员查找某员工当前权限配置的操作步骤数	待统计	≤ 3 步触达	上线后 30 天
降低权限异常率	「权限与角色不一致」人员数量	待统计	< 5%	持续监控

---

3. 非目标（本期不做）

• 不包含细化到行级（Row-level）的数据权限（如仅允许查看特定小区的房源）；本期数据范围控制采用五档模型：本人 / 本组 / 本门店 / 本区域 / 全公司。注意：并非所有权限项均开放五档，各项的实际可选范围以权限编辑页的下拉配置为准（例如某些权限项仅提供「本人 / 本门店 / 全公司」三个选项）
• 不包含权限申请审批工作流（员工自助申请权限需上级审批），本期由管理员直接操作
• 不包含操作日志的可视化看板（日志写入，查询能力在后续版本规划）
• 不包含 IP 白名单、登录时段等安全策略配置（安全策略模块另行规划）
• 不包含移动端 App 独立权限配置（移动端权限为 Web 权限的子集，v2 规划）
• 不包含外部合作伙伴（联合门店）账号的跨租户权限体系

---

4. 用户故事与验收标准

说明：以下用户故事按核心业务流程顺序排列，覆盖权限管理模块的两个子模块：「权限管理（人员维度）」和「角色管理（角色维度）」。

---

Story 1：管理员查看人员权限列表

As Tenant Admin（租户管理员），I want 在人员列表中查看全公司所有员工的当前角色与权限状态，So that 能快速定位权限异常人员并执行调整。

验收标准：

• 页面入口路径：顶部导航「人事」→「组织人事」→「权限管理」，面包屑显示「人事OA / 组织人事 / 权限管理」
• 页面包含两个 Tab：「权限管理」（默认选中）和「角色管理」，Tab 切换无需全页刷新
• 页面右上角提供「角色权限帮助」入口链接
• 列表顶部提供两个快速筛选按钮：「全部员工」和「新房交易列表」
• 支持多条件筛选：姓名/员工号（文本输入）、员工部门（下拉选择）、角色（下拉选择）、职务名称（下拉选择）
• 提供「权限与角色权限不一致」快捷筛选按钮（高亮橙色），点击直接筛选出个人权限已被单独修改、与所属角色权限不一致的人员
• 点击「查询」执行筛选，点击「清空条件」重置所有筛选项
• 支持批量操作：勾选员工复选框后，点击「批量设置角色」按钮执行批量角色变更
• 列表支持「导出」功能，导出当前筛选结果
• 员工列表展示列：复选框、员工姓名、工号、部门、职务、角色、管理范围（带「详情」链接）、操作列
• 操作列包含：「修改权限」「复制角色」「扩充范围」「范围」共 4 个操作项
• 管理范围列显示该员工当前数据可见范围（如「上海豪园店二组」），点击「详情」展开管理范围明细
• 列表支持分页：每页显示条数可切换（20 条/页为默认），支持跳转至指定页

---

Story 2：管理员为员工批量设置角色

As Tenant Admin（租户管理员），I want 同时为多名员工批量设置同一角色，So that 在员工入职或组织架构调整时能高效完成权限初始化，无需逐一操作。

验收标准：

• 在人员列表中勾选至少一名员工后，「批量设置角色」按钮从禁用变为可点击
• 点击「批量设置角色」弹出 Modal 对话框，标题为「批量设置角色」
• Modal 内包含必填字段「角色」，为下拉选择器，展示系统中所有可用角色
• 确认后系统将所选角色应用至所有勾选员工，操作成功后给出 Toast 成功提示
• 若批量操作影响了已有个人自定义权限的员工，系统应给出提醒：「该操作将覆盖所选员工的个人自定义权限，请确认」
• 支持取消操作，取消后返回人员列表，已勾选状态保持

---

Story 3：管理员修改个人权限

As Tenant Admin（租户管理员），I want 为特定员工在角色权限基础上进行个性化权限调整，So that 满足因岗位特殊性而需要区别于通用角色权限配置的场景。

验收标准：

• 点击人员列表中某员工操作列的「修改权限」后，进入该员工的权限编辑页
• 页面顶部展示员工信息：员工姓名 - 所属部门，及当前角色（带下拉箭头，支持直接在此页切换角色）
• 页面提供权限名称搜索框，支持关键词快速定位权限项
• 左侧为模块导航树，包含以下一级模块（均可折叠/展开）：
  • 首页
  • 房源（含子菜单：二手 & 租赁、小区、商圈精耕、举证 & 检核、挂牌分析、房源广场等）
  • 新房
  • 客源
  • 交易
  • 数据
  • 营销
  • 人事OA
  • 合同
  • 三网
  • 系统
  • 移动端
  • 智能门店
  • 在线充值
• 点击左侧模块导航，右侧内容区切换至对应模块的权限配置
• 右侧内容区按功能分组展示权限项，每组包含：分组标题（带开关）、权限项列表
• 每个权限项展示：权限名称、说明（权限作用描述）、当前权限值（下拉选项 / 开关 / 数值输入）、「编辑」操作
• 权限值类型包含：
  • 开关型（Toggle）：开启 / 关闭
  • 范围型（Select）：本人 / 本组 / 本门店 / 本区域 / 全公司 等选项（不同权限项的选项范围不同）
  • 数值型（Number）：如每日最多查看联系人数量（0 = 不限制）
• 模块级总开关（分组标题处的 Toggle）关闭后，该模块下所有权限项均置灰，对应菜单入口隐藏
• 「编辑」操作点击后弹出侧边抽屉（Drawer），展示该权限项的详细说明及当前角色应用人数和应用人员名单
• 修改权限后，若该员工权限与其角色默认权限存在差异，系统在人员列表中标记「权限与角色权限不一致」
• 页面提供「保存」按钮，保存成功后给出成功提示

---

Story 4：管理员查看并编辑特定权限项（侧边抽屉）

As Tenant Admin（租户管理员），I want 在编辑单个权限项时，同时看到该权限当前应用该角色的所有人员名单，So that 能了解本次修改的影响范围，再决定是否确认变更。

验收标准：

• 点击权限项的「编辑」按钮后，页面右侧滑出 Drawer（不覆盖左侧导航）
• Drawer 顶部展示：角色名称 + 应用人数（如「角色：高级业务员 | 应用人数: 12」），并提供「查看详情」链接
• Drawer 内展示该角色下所有应用人员的姓名和所属部门（格式：姓名-部门名）
• Drawer 中列出本权限项的配置表格：权限名称、说明、当前值（下拉选择），支持在 Drawer 内直接修改
• Drawer 底部提供「保存」和「取消」按钮
• 若权限修改后影响角色所有应用人员，系统提示「权限修改后将影响该角色所有应用人员」
• 保存后 Drawer 关闭，右侧内容区对应权限项显示更新后的值

---

Story 5：管理员查看角色列表

As Tenant Admin（租户管理员），I want 在角色管理页查看所有已创建的角色及其基本信息，So that 快速了解当前系统的角色体系，并按需编辑或删除。

验收标准：

• 点击顶部「角色管理」Tab 切换至角色列表页
• 支持多条件筛选：角色名称（文本输入）、角色类别（下拉，全选）、修改时间（日期范围，开始时间 + 结束时间）
• 点击「查询」执行筛选，点击「清空条件」重置
• 操作区提供：「+ 新增角色」按钮（主按钮，橙色）、「批量删除角色」按钮
• 显示总记录条数（如「① 共 5 条」）
• 角色列表展示列：复选框、角色名称（可排序）、角色类别、应用人数（含「查看」链接）、引用该角色配置、创建时间、修改时间、操作列
• 操作列包含：「编辑」「删除」「修改日志」
• 点击「应用人数」旁的「查看」链接，弹出该角色应用人员名单
• 「引用该角色配置」列显示该角色的权限模板是从哪个已有角色复制/引用的（如「初始劝房」）
• 支持分页，默认 20 条/页

---

Story 6：管理员新增角色

As Tenant Admin（租户管理员），I want 新建一个角色并配置其权限，So that 为新增岗位或特殊职能定义标准权限模板，便于批量分配给对应员工。

验收标准：

• 点击「+ 新增角色」按钮弹出 Modal，标题为「添加角色」
• Modal 内包含两个必填字段：
  • 角色名称（文本输入，必填）
  • 角色类别（下拉选择，必填）：包含「置业顾问」「店管」「总经」等类别选项
• Modal 底部提示：「角色类别影响权限，创建后仅本人创建类别可修改」
• Modal 操作按钮：「下一步：设置权限」（橙色主按钮）、「取消」
• 点击「下一步：设置权限」后，跳转至权限配置详情页，进入角色权限编辑状态
• 角色名称未填写或角色类别未选择时，点击「下一步」显示字段级错误提示，阻止提交
• 创建成功后，新角色出现在角色列表中，创建时间为当前时间

---

Story 7：管理员配置角色权限

As Tenant Admin（租户管理员），I want 在角色权限编辑页为角色精细配置各模块的权限开关和数据范围，So that 该角色下所有人员自动继承统一的权限配置，减少重复操作。

验收标准：

• 角色权限编辑页顶部展示：角色名称、角色类别、「编辑」按钮（支持在线修改角色基本信息）
• 顶部操作区包含：「导入角色模板」（从已有角色复制权限配置）、「清空」、「保存」按钮
• 左侧模块导航结构与人员权限编辑页一致（首页、房源、客源、交易、数据、营销、人事OA、合同、三网、系统、移动端、智能门店、在线充值）
• 每个模块有「本模块开启」总开关（Toggle），关闭后该模块下所有权限项置灰，菜单入口隐藏
• 权限项按业务分组展示，分组有独立的开关和说明文字
• 各权限项支持的值类型与人员权限编辑页保持一致（开关型 / 范围型 / 数值型）
• 支持「导入角色模板」：选择一个已有角色，将其权限配置复制到当前角色（覆盖当前配置，需二次确认）
• 点击「清空」重置所有权限为默认最小值（需二次确认）
• 点击「保存」保存权限配置，成功后 Toast 提示；应用该角色的所有员工权限实时生效

---

Story 8：管理员修改角色（切换员工角色）

As Tenant Admin（租户管理员），I want 在员工权限编辑页直接切换员工所属角色，So that 快速完成角色变更而不需要退出到人员列表再操作。

验收标准：

• 在员工权限编辑页顶部，角色名称旁有下拉箭头，点击展开角色选择器
• 角色选择器展示当前系统中所有可用角色（多选，支持同时分配多个角色）
• 已选择的角色显示为 Tag 形式，可通过 × 取消
• 修改角色后，右侧权限配置区自动刷新至新角色权限设置
• 若新角色权限与员工当前个人自定义权限存在差异，系统提示是否保留个人自定义权限或以角色权限覆盖
• 操作通过「修改角色」弹窗完成，弹窗关闭后权限编辑页显示新角色配置

---

5. 功能说明

5.1 子模块结构

权限管理模块分为两个子模块，均位于「人事OA / 组织人事 / 权限管理」路径下：

子模块	功能定位
权限管理（人员视角）	以员工为维度，查看、分配、个性化调整每个员工的权限
角色管理（角色视角）	以角色为维度，创建和配置权限模板，供批量分配使用

---

5.2 权限模型设计

Fonrey 采用 RBAC（基于角色的访问控制）+ 个人权限叠加 的混合权限模型：

员工实际权限 = 角色基础权限 + 个人定制权限覆盖

• 角色权限：角色是权限的"模板"，相同角色的员工拥有一致的默认权限
• 个人权限：管理员可在角色基础上为特定员工增加或收窄特定权限项，形成个人定制权限
• 个人权限优先：当个人权限与角色权限存在差异时，个人权限值生效
• 不一致标记：系统在人员列表中标记「权限与角色权限不一致」的员工，方便管理员识别并决定是否同步

---

5.3 权限管理 - 人员列表

5.3.1 列表结构

字段	说明
员工姓名	显示姓名，可作为搜索关键词
工号	员工系统工号
部门	当前所属部门
职务	当前职务
角色	当前分配的角色名称
管理范围	该员工数据可见范围（如「上海豪园店二组」），点击「详情」查看明细
操作	修改权限 / 复制角色 / 扩充范围 / 范围

5.3.2 筛选条件

筛选项	类型	说明
搜索	文本输入	支持姓名、员工号模糊搜索
员工部门	下拉	选择部门过滤
角色	下拉	按角色名过滤
职务名称	下拉	按职务过滤
权限与角色权限不一致	快捷筛选按钮	一键筛选个人权限已被单独定制的员工

5.3.3 行级操作说明

操作	说明
修改权限	进入该员工的个人权限编辑页，在角色权限基础上进行个性化调整
复制角色	将当前员工的角色（包含个人定制权限）复制给其他员工
扩充范围	调整该员工的数据可见范围（如从「本组」扩展到「本门店」）
范围	查看当前员工的管理范围详情

---

5.4 权限管理 - 个人权限编辑页

5.4.1 模块导航（左侧树形菜单）

模块	子菜单（示例）
首页	首页
房源	二手 & 租赁 / 小区 / 商圈精耕 / 举证 & 检核 / 挂牌分析 / 房源广场
新房	新房楼盘管理 / 新房（置业顾问视角）
客源	客源
交易	交易管理 / 二手房售后管理 / 新房售后管理
数据	报表管理 / 资料客统计 / 行程量化 / 房客权益查询
营销	短视频 / 巧克力（营销工具）
人事OA	组织 / 审批 / 考勤 / 任务 / 内容
合同	合同管理
三网	三网经纪人后台 / 三网授权管理
系统	系统工具 / 业务工具 / 安装与登录授权
移动端	移动端
智能门店	智慧大屏 / VR 换装
在线充值	电话充值 / 增值服务

5.4.2 权限值类型

类型	控件形式	示例权限项
开关型	Toggle（开 / 关）	今日新上房源是否显示、管理点赞信息和屏蔽点赞
范围型	下拉选择	查看私客列表（本人 / 本组 / 本门店 / 全公司）
数值型	数字输入框	每日最多查看联系人数量（0 = 不限制）

5.4.3 客源模块权限分组（参考截图详细梳理）

客源模块的权限按以下分组组织：

私客基础权限

权限项	值类型	说明
个人私客数量上限	数值型	999+ = 不限制，0 = 不允许
查看私客房源进出页（非保护客）	范围型	控制查看客源保护的私客房源进出页
查看私客房源进出页（保护客）	范围型	控制已保护客的私客房源进出页
私客转公客	范围型	—
查看私客（保护客）	范围型	查看己经纪人名下的保护客
查看私客（合保客）	范围型	—
编辑私客（保护客）	范围型	编辑本人工员工名下保护的私客信息
设置取消私客保护范围	范围型	设置取消相关员工的私客的保护范围
私客（非保护）承接客	范围型	私客（非保护客）承接客的范围
私客（保护客）承接客	范围型	私客（保护客）承接客的范围

公客基础权限

权限项	值类型	说明
公客查看范围	范围型	控制公客查看范围
查看公客详情	开关型	—
查看公私特殊客	开关型	跟公客查看范围和相同，启用后，还可对对查看范围内的公客特殊客，若关闭，无法在公客查看私客
改公客状态	开关型	—
编辑公客	开关型	—
公客开客资格	范围型	公客开客资格的范围
公客详情跟进记录查看范围	范围型	以跟客人为准，控制跟进记录可看到的跟客历史记录

成交客基础权限

权限项	值类型	说明
查看成交（私客类型）	范围型	控制员工查看的成交情况范围
查看成交（公客类型）	范围型	控制员工查看公客号码的成交来源范围；查看成交权限为本组时，支持查看本组及以上共享层级的成交
查看成交跟进	范围型	—
成交客查看范围切换	开关型	跟成交客查看范围和相同，启用后，还可对对查看范围内的成交客实两次切换，若关闭，无法在成交客查看范围以外切换
查看成交编辑来源人员限来的成交来源字段	范围型	控制查看成交编辑来源人员填写的成交来源字段
查看成交客备注	范围型	—
形成成交客列列表	开关型	成交客列号列表

联系人基础权限

权限项	值类型	说明
私客（非保护客）成交查看号码	范围型	控制查看客源保护的私客、私客的号码范围
成交客查看号码	范围型	控制查看成交客的私客的号码范围；支持查看本组及以上共享层级的成交号码
私客（保护客）号码	范围型	控制查看保护客的号码范围
营销短信/成交联系人【联系人名称】最多个数	数值型	—
查看【公客人号码】最多个数	数值型	控制公客查看号码的范围，999+ = 不限制
拨打私客（非保护客）电话	范围型	控制拨打非保护私客的号码范围
拨打私客（保护客）电话	范围型	控制拨打保护私客的号码范围
成交客打电话	范围型	控制拨打成交客的号码范围
公客拨打电话	开关型	控制拨打公客的号码范围
编辑私客（非保护客）& 成交联系人	范围型	控制修改保护客、私客的号码信息，有权时对对刷新联系人
编辑私客（保护客）联系人	范围型	控制修改保护客联系人号码信息，有权时对对刷新联系人
编辑私客（非保护客）& 成交联系人号码	范围型	控制修改保护客、私客的号码信息
编辑私客（保护客）联系人号码	范围型	—
公客联系人号码	范围型	控制公客联系人号码范围

管理权限

权限项	值类型	说明
前跑源（查看已跑跑前源）	开关型	—
不公客查看号码可划打次数限制	开关型	—
手动原客户为公客	开关型	—
某个范围修改关联员工	范围型	可修改么么范围内的关联员工，包括添加合作人
批量修改私客 / 公客来源	开关型	—
查看客户客人操作日志	开关型	启用后，可查看某人评语中手号码模板、客户客人不可过...
不受到拨号手号码打划打次数限制	开关型	—
跑跑跑	开关型	—
查看客户号码，超频强制刷回跑跑跑	开关型	乙乙，可以查看更改不超限制号码，普通产业学刷回
查看备案客	开关型	查看客户学记录
接管跑跑新客	开关型	查看化学优化修改客跑跑新接管员工
拆解员工划协办	范围型	控制拆解员工人员划协办
置换跑跑工跑跑户	范围型	控制置换跑跑客跑跑户范围
允许合并自己的私跑跑	开关型	开启后，允许合并入跑客人登录人员合并入本人的私跑跑

空客

权限项	值类型	说明
空跑跑单中哪些单元号房号查看	下拉选择	以置业顾问人为准
空跑跑跑单查看范围	范围型	以置业顾问人为准
空跑跑单中件查看范围	范围型	以上述人为准

带看/随行权限

权限项	值类型	说明
带跑跑新增	开关型	—
带跑跑单中哪些单元号查看	范围型	以某某人为准
带跑跑编辑、作废	范围型	—
私客/成交跑跑记录查看范围	范围型	以某某人为准
查看单中中体查看	范围型	以上述人为准
公客详情跑跑用应用单查看	范围型	以上述人为准，此时以跑跑员及跑跑项实项目生效

5.4.4 楼盘（小区）模块权限分组

楼盘管理

权限项	值类型	说明
楼盘管理查看	开关型	关闭后，则不显示楼盘管理系统模块
楼盘结构查看	开关型	开启后，可以查看楼栋-单元-房号数据
新增/批量新增楼盘	开关型	允许新增楼盘
新增/批量新增楼栋、单元、房号	开关型	新增楼栋、单元、房号数据
编辑楼盘	开关型	编辑楼盘
编辑楼栋/单元/房号信息	开关型	编辑楼栋、单元、房号信息
关联标准库/取关	开关型	若启用，则可关联至标准楼盘、标准楼栋、单元、房号
删除楼盘	开关型	删除楼盘
删除楼盘数据（一并删除房源）	开关型	若启用，则可无视是否存在房源，对不同层级及以下的数据全部删除
删除楼栋、单元、房号	开关型	删除楼栋、单元、房号
合并楼盘	开关型	若启用，则可合并不同层级楼盘数据（楼栋、单元、房号）
移动楼栋/单元/房号数据	开关型	若启用，则可将A楼盘楼栋单元及以下数据移动至B楼盘；转移房号不能跨小区进行转移
锁定/解锁楼盘	开关型	操作锁定解锁楼盘
候审房源地址数据查看范围	范围型	设置员工是否查看部门内其他员工的候审房源地址数据
楼盘挂牌成交数据	开关型	开启后，显示楼盘挂牌及成交数据信息
司内成交明细及套数	开关型	开启后，显示公司成交的房源明细信息及成交套数
区域管理	开关型	若启用，则可对区域商圈进行新增、合并、关联操作
查看销控盘	开关型	开启后，可在楼盘管理系统-楼盘里，查看销控盘；注意：员工查看销控盘时房源地址是直接可见的，建议只给管理层开启！！！
查看销控盘时，只可查看本部门作业范围内的楼盘	开关型	开启后，只可查看本部门作业范围内的楼盘的销控盘；关闭，则跟作业范围无关，「查看销控盘」权限开启即可查看所有楼盘的销控盘；Tenant Admin（租户管理员）不受限制

楼盘资料管理

权限项	值类型	说明
楼盘照片	开关型	开启后，显示楼盘照片列表
管理照片	开关型	楼盘管理系统-楼盘照片，包含上传照片、设为封面
删除照片	开关型	允许删除照片
下载照片	开关型	允许下载照片
楼盘附件	开关型	开启后，显示楼盘附件模块
管理附件	开关型	允许上传楼盘附件
下载附件	开关型	允许下载楼盘附件
删除附件	开关型	允许删除楼盘附件
周边配套	开关型	开启后，显示周边配套模块
学校管理列表	开关型	开启后，显示楼盘管理系统中的学校管理列表
学校管理	开关型	包含新增、编辑、删除

楼盘处理

权限项	值类型	说明
楼盘反馈列表	范围型	可查看小区反馈列表的数据范围
楼盘反馈处理	开关型	包含处理、不予处理操作

---

5.5 角色管理

5.5.1 角色列表

字段	说明
角色名称	角色唯一名称，支持排序
角色类别	如置业顾问、店管、总经等类别，影响权限可选范围
应用人数	当前使用该角色的员工数量，点击「查看」查看名单
引用该角色配置	该角色权限是基于哪个角色模板创建的
创建时间	角色创建时间
修改时间	最后一次权限修改时间

5.5.2 已知系统内置角色

以下角色为系统内置角色，用户可新增角色，但这些角色不可删除。

角色名称
置业顾问
店管
区管
区总
副总
总经
其他职能

5.5.3 角色类别说明

角色类别在创建时必选，且创建后不可随意修改（仅允许创建者修改），原因是角色类别会直接影响权限的可配置范围（不同类别允许的权限上限不同）。

---

5.6 数据范围（管理范围）说明

权限管理中「数据范围」是权限系统的核心维度，控制员工可以看到哪个层级的业务数据：

数据范围值	说明
本人	仅查看/操作自己名下的数据
本组	查看/操作所在店组的数据
本门店	查看/操作所在门店的所有数据
本区域	查看/操作所在区域范围内的数据
全公司	查看/操作公司所有数据（管理层权限）
无	无权查看/操作

注：不同权限项的可选范围不同，如某权限项只有「本人 / 本门店 / 全公司」三个选项，另一权限项可能有完整的五档选项。具体可选范围以权限编辑页的下拉选项为准。

---

6. 技术考量

依赖关系

依赖系统 / 模块	用途	风险等级
组织人事管理（org 模块）	员工 / 部门数据读取，权限与员工身份绑定	高
django-tenants	权限数据必须严格按租户 Schema 隔离，严禁跨租户查询	高
Redis 缓存	员工权限频繁读取，建议缓存员工权限快照，更新时主动失效	中

已知风险

风险	可能性	影响	缓解策略
权限变更实时生效的一致性问题	中	高	角色/个人权限变更后主动清除 Redis 中该员工权限缓存，强制下次请求重新加载
权限项数量巨大（14+ 模块，数百个权限项）导致编辑页性能问题	中	中	左侧导航按模块懒加载权限数据，避免一次性加载全部权限项
多角色合并规则（已锁定 v1.1）	-	-	规则：同一员工多角色取并集（最宽松原则）。BOOLEAN→OR；SCOPE→MAX（self<store<zone<area<region<division<company）；INTEGER（限额类）→MAX，0 视为无上限。详见 DATA_MODEL_PERMISSION.md
角色删除影响已分配员工	低	高	删除角色前校验是否有员工仍使用该角色，有则阻止删除并提示转移员工角色

待确认开放问题

• 多角色权限合并规则：当员工被分配了多个角色时，权限取并集（最宽松）还是交集（最严格）？ 已确认（v1.1，2026-04-24）：取并集/最宽松。BOOLEAN=OR，SCOPE=MAX，INTEGER=MAX（0=∞）。权威实现见 DATA_MODEL_PERMISSION.md 附录 E PermissionChecker 伪代码。
• 个人权限与角色权限冲突优先级：个人定制权限是否始终覆盖角色权限，还是支持「继承角色 + 仅扩展」模式？— Owner: 产品负责人 — Deadline: 开发启动前
• 权限操作日志：是否需要记录管理员对权限的变更记录（谁、何时、将哪个权限从什么改成什么）？截图中「修改日志」入口存在，需确认日志颗粒度 — Owner: 产品负责人 — Deadline: 开发启动前
• 角色类别的完整枚举值：当前已知「置业顾问 / 店管 / 总经」，需确认完整的角色类别列表及各类别允许的权限上限 — Owner: 产品负责人 — Deadline: 开发启动前

---

7. 上线计划

阶段	时间	受众	通过标准
内部 Alpha	TBD	研发 + 产品团队	角色 CRUD 流程通畅，权限编辑保存无误
封闭 Beta	TBD	1-2 家试点门店Tenant Admin（租户管理员）	批量设置角色 / 个人权限修改功能可用，无 P0 Bug
正式上线	TBD	全部租户Tenant Admin（租户管理员）	权限变更实时生效，错误率 < 0.5%，Tenant Admin（租户管理员） CSAT ≥ 4/5

回滚标准：若权限写入后错误率 > 2%，或出现跨租户数据泄漏问题，立即回滚并通知所有租户管理员。

---

8. 附录

8.1 截图参考索引

截图文件	完整路径	对应功能
权限管理-人员列表.png	Project/fonrey/screenshots/权限管理/权限管理-人员列表.png	5.3 权限管理人员列表
权限管理-修改个人权限-客源.png	Project/fonrey/screenshots/权限管理/权限管理-修改个人权限-客源.png	5.4 个人权限编辑 - 客源模块
权限管理-人员编辑特定权限.png	Project/fonrey/screenshots/权限管理/权限管理-人员编辑特定权限.png	Story 4 - 侧边 Drawer 编辑单个权限项
权限管理-批量设置角色.png	Project/fonrey/screenshots/权限管理/权限管理-批量设置角色.png	Story 2 - 批量设置角色 Modal
角色管理-角色列表.png	Project/fonrey/screenshots/权限管理/角色管理-角色列表.png	5.5.1 角色列表
角色管理-添加角色1.png	Project/fonrey/screenshots/权限管理/原始图片/角色管理-添加角色1.png	Story 6 - 新增角色 Modal
角色管理-修改角色.png	Project/fonrey/screenshots/权限管理/原始图片/角色管理-修改角色.png	Story 8 - 修改角色（切换员工角色）
权限-房源-小区.png	Project/fonrey/screenshots/权限管理/权限-房源-小区.png	5.4.4 楼盘（小区）模块权限分组
权限-客源-客源.png	Project/fonrey/screenshots/权限管理/权限-客源-客源.png	5.4.3 客源模块权限分组（角色编辑视角）
权限-房源-挂牌分析.png	Project/fonrey/screenshots/权限管理/权限-房源-挂牌分析.png	5.4 房源 - 挂牌分析模块权限
权限-房源-商圈精耕.png	Project/fonrey/screenshots/权限管理/权限-房源-商圈精耕.png	5.4 房源 - 商圈精耕模块权限
权限-房源-举证检核.png	Project/fonrey/screenshots/权限管理/权限-房源-举证检核.png	5.4 房源 - 举证检核模块权限
权限-客源-客源-table.png	Project/fonrey/screenshots/权限管理/权限-客源-客源-table.png	5.4.3 客源权限表格视图
权限-合同-合同管理.png	Project/fonrey/screenshots/权限管理/权限-合同-合同管理.png	5.4 合同管理模块权限
权限-人事QA-考勤.png	Project/fonrey/screenshots/权限管理/权限-人事QA-考勤.png	5.4 人事OA - 考勤权限
权限-人事QA-组织.png	Project/fonrey/screenshots/权限管理/权限-人事QA-组织.png	5.4 人事OA - 组织权限
权限-人事QA-审批.png	Project/fonrey/screenshots/权限管理/权限-人事QA-审批.png	5.4 人事OA - 审批权限
权限-人事QA-任务.png	Project/fonrey/screenshots/权限管理/权限-人事QA-任务.png	5.4 人事OA - 任务权限
权限-人事QA-内容.png	Project/fonrey/screenshots/权限管理/权限-人事QA-内容.png	5.4 人事OA - 内容权限
权限-交易-交易管理.jpg	Project/fonrey/screenshots/权限管理/权限-交易-交易管理.jpg	5.4 交易 - 交易管理权限
权限-交易-二手房售后管理.png	Project/fonrey/screenshots/权限管理/权限-交易-二手房售后管理.png	5.4 交易 - 二手房售后管理权限
权限-交易-新房售后管理.png	Project/fonrey/screenshots/权限管理/权限-交易-新房售后管理.png	5.4 交易 - 新房售后管理权限
权限-三网-三网经纪人后台.png	Project/fonrey/screenshots/权限管理/权限-三网-三网经纪人后台.png	5.4 三网 - 三网经纪人后台权限

8.2 权限模块完整导航结构

基于截图梳理的权限配置模块树（以角色编辑页左侧导航为准）：

权限配置
├── 首页
├── 房源
│   ├── 二手 & 租赁
│   ├── 小区（楼盘管理）
│   ├── 商圈精耕
│   ├── 举证 & 检核
│   ├── 挂牌分析
│   └── 房源广场
├── 新房
│   ├── 新房
├── 客源
│   ├── 客源
├── 交易
│   ├── 交易管理
│   ├── 二手房售后管理
│   └── 新房售后管理
├── 数据
│   ├── 报表管理
│   ├── 资料客统计
│   ├── 行程量化
│   └── 房客权益查询
├── 营销
│   ├── 短视频
│   └── 巧克力
├── 人事OA
│   ├── 组织
│   ├── 审批
│   ├── 考勤
│   ├── 任务
│   └── 内容
├── 合同
│   └── 合同管理
├── 三网
│   ├── 三网经纪人后台
│   └── 三网授权管理
├── 系统
│   ├── 系统工具
│   ├── 业务工具
│   └── 安装与登录授权
├── 移动端
│   ├── 移动端
├── 智能门店
│   ├── 智慧大屏
│   └── VR 换装
└── 在线充值
    ├── 电话充值
    └── 增值服务