ishenwei/nexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Permission seed 文档

Browse Source
This commit is contained in:
Shen Wei
2026-04-30 12:47:35 +08:00
parent 91fc0b06d6
commit 1da12a27f0
6 changed files with 882 additions and 141 deletions
Download Patch File Download Diff File Expand all files Collapse all files

340
Project/fonrey/PRD/权限管理/PERMISSION_SEED_MVP_BATCH1.md Normal file
View File

@@ -0,0 +1,340 @@
# PermissionDef 种子数据规格 — MVP 批次 1
> **数据来源**：竞品权限参考文档 + 各模块 PRD
> **实施方式**：Django Data Migration（RunPython）写入 `public` schema
> **字段说明**：`default_value` 用于租户首次配置前的兜底值；`scope` 类型取值 `none/self/dept/all`（对应无/本人/本部/全部）；`integer` 类型 `-1` = 不限制，`0` = 不允许
---
## 房源模块（二手租赁）（66 条）
### 房源基础
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| ------------------------------------ | ------------ | ---------- | ------------- | ------------------------- | --- | --- | --- | --- |
| `property.listing.create` | 新增房源 | boolean | `false` | 是否可新增房源 | True | False | True | 1 |
| `property.listing.view_scope` | 维护房源查看范围 | scope | `self` | 按维护人范围查看房源列表：无/本人/本部/全部 | True | False | True | 1 |
| `property.listing.view_public` | 公盘查看 | boolean | `false` | 是否可查看公盘房源 | True | False | True | 1 |
| `property.listing.view_private` | 私盘查看 | boolean | `false` | 是否可查看私盘房源 | True | False | True | 1 |
| `property.listing.set_public` | 将房源改为公盘 | boolean | `false` | 是否可将房源属性改为公盘 | True | False | True | 1 |
| `property.listing.set_private` | 将房源改为私盘 | boolean | `false` | 是否可将房源属性改为私盘 | True | False | True | 1 |
| `property.listing.set_locked` | 将房源改为封盘 | boolean | `false` | 是否可将房源属性改为封盘 | True | False | True | 1 |
| `property.listing.set_special` | 将房源改为特盘 | boolean | `false` | 是否可将房源属性改为特盘 | True | False | True | 1 |
| `property.listing.delete` | 删除房源 | boolean | `false` | 是否可删除房源 | True | False | True | 1 |
| `property.listing.restore` | 恢复已删除房源 | boolean | `false` | 是否可恢复已删除的房源 | True | False | True | 1 |
| `property.listing.export` | 房源列表数据导出 | boolean | `false` | 是否可将房源列表数据导出 | True | False | True | 1 |
| `property.listing.edit_description` | 修改房屋介绍信息 | boolean | `false` | 是否可修改营销标题、核心卖点、户型介绍等介绍信息 | True | False | True | 1 |
| `property.listing.view_deal` | 成交房源列表及价格信息 | boolean | `false` | 是否可查看成交房源列表及价格历史 | True | False | True | 1 |
| `property.listing.price_read` | 价格解读 | boolean | `false` | 是否可查看房源详情页的价格解读 | True | False | True | 1 |
| `property.listing.view_history` | 查看房源挂牌历史 | boolean | `false` | 是否可查看房源挂牌历史记录 | True | False | True | 1 |
| `property.listing.view_owner_others` | 查看同业主其他房源 | boolean | `false` | 是否可在房源详情页查看同业主的其他房源 | True | False | True | 1 |
| `property.listing.set_protected` | 修改房源保护设置 | boolean | `false` | 是否可修改房源的保护期/保护房设置 | True | False | True | 1 |
| `property.listing.view_protected` | 查看保护期内房源 | boolean | `false` | 是否可查看保护期内（我租/我售/已售/已租）房源 | True | False | True | 1 |
| `property.listing.change_keeper` | 修改相关方范围 | scope | `none` | 可修改哪个范围内房源的相关方：无/本人/本部/全部 | True | False | True | 1 |
| `property.listing.merge_duplicate` | 重复房源合并 | boolean | `false` | 是否可合并重复房源 | True | False | True | 1 |
| `property.listing.status_sold` | 修改为我售/我租状态 | boolean | `false` | 是否可修改房源为我售/我租状态 | True | False | True | 1 |
| `property.listing.grade_set_a` | 将房源等级设为A | boolean | `false` | 是否可将挂牌中房源等级设为A（急迫） | True | False | True | 1 |
| `property.listing.grade_set_e` | 将房源等级设为E | boolean | `false` | 是否可将房源等级设为E（暂不关注） | True | False | True | 1 |
### 业主/联系人与号码
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.contact.view_phone` | 查看业主/联系人号码 | boolean | `false` | 是否可查看房源业主/联系人真实号码 | True | False | True | 1 |
| `property.contact.view_phone_limit` | 每日查看号码次数上限 | integer | `0` | 每天可查看房源真实号码次数，0=不允许，-1=不限制 | True | False | True | 1 |
| `property.contact.add_contact` | 新增业主/联系人 | boolean | `false` | 是否可新增业主/联系人 | True | False | True | 1 |
| `property.contact.edit_core` | 修改业主核心信息 | scope | `none` | 可修改哪个范围的业主核心信息（电话/微信）：无/本人/本部/全部 | True | False | True | 1 |
| `property.contact.edit_basic` | 修改业主非核心信息 | scope | `self` | 可修改哪个范围的业主基本信息（姓名/备注）：无/本人/本部/全部 | True | False | True | 1 |
| `property.contact.delete_contact` | 删除业主/联系人 | boolean | `false` | 是否可删除业主/联系人 | True | False | True | 1 |
| `property.contact.view_cert` | 查看产证信息 | boolean | `false` | 是否可查看房源详情页产证信息 | True | False | True | 1 |
| `property.contact.view_operation_log` | 查看业主联系人操作日志 | boolean | `false` | 是否可查看业主/联系人的新增、修改、删除等记录 | True | False | True | 1 |
### 房源地址
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.address.view_detail` | 查看楼栋/单元/楼层/房号 | boolean | `false` | 是否可查看房源真实地址详情 | True | False | True | 1 |
| `property.address.view_limit` | 每日查看地址次数上限 | integer | `0` | 每天可查看房源真实地址总次数，0=不允许，-1=不限制 | True | False | True | 1 |
| `property.address.edit` | 修改楼栋/单元/楼层/房号 | boolean | `false` | 是否可修改房源地址信息 | True | False | True | 1 |
### 房源钥匙
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.key.create` | 新增钥匙 | boolean | `false` | 是否可新增钥匙 | True | False | True | 1 |
| `property.key.edit` | 修改钥匙 | scope | `none` | 按钥匙方范围可修改钥匙：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.return` | 退还钥匙 | scope | `none` | 按钥匙方范围控制是否可退还钥匙：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.view_password` | 查看钥匙密码 | scope | `none` | 按钥匙方范围控制是否可查看密码：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.view_number` | 查看钥匙编号 | scope | `none` | 按钥匙方范围控制是否可查看钥匙编号：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.borrow` | 钥匙借出 | scope | `none` | 按钥匙保管部门范围借出钥匙：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.give_back` | 钥匙归还 | scope | `none` | 按钥匙保管部门范围归还钥匙：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.delete` | 删除钥匙 | scope | `none` | 按钥匙方范围控制是否可删除钥匙：无/本人/本部/全部 | True | False | True | 1 |
| `property.key.export` | 钥匙列表数据导出 | boolean | `false` | 是否可导出钥匙数据 | True | False | True | 1 |
### 房源实勘
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.survey.create_photo` | 新增实勘图片 | boolean | `false` | 是否可新增实勘图片 | True | False | True | 1 |
| `property.survey.download_photo` | 下载图片 | boolean | `false` | 是否可下载实勘图片 | True | False | True | 1 |
| `property.survey.delete_photo` | 删除图片 | scope | `none` | 按图片上传人范围删除：无/本人/本部/全部 | True | False | True | 1 |
| `property.survey.create` | 新增实勘 | boolean | `false` | 是否可新增实勘记录 | True | False | True | 1 |
| `property.survey.view` | 查看实勘 | boolean | `false` | 是否可查看实勘记录 | True | False | True | 1 |
| `property.survey.upload_video` | 上传视频 | boolean | `false` | 是否可上传房源视频 | True | False | True | 1 |
| `property.survey.download_video` | 下载视频 | boolean | `false` | 是否可下载房源视频 | True | False | True | 1 |
| `property.survey.play_video` | 播放视频 | boolean | `false` | 是否可播放房源视频 | True | False | True | 1 |
### 房源委托
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.mandate.create` | 新增委托 | boolean | `false` | 是否可新增房源委托 | True | False | True | 1 |
| `property.mandate.renew` | 续签/违约委托 | scope | `none` | 按委托方范围可续签或违约委托：无/本人/本部/全部 | True | False | True | 1 |
| `property.mandate.view` | 委托列表查看 | scope | `none` | 按委托方范围查看委托列表：无/本人/本部/全部 | True | False | True | 1 |
| `property.mandate.revoke` | 委托作废 | scope | `none` | 按委托方范围控制是否可作废委托：无/本人/本部/全部 | True | False | True | 1 |
| `property.mandate.export` | 委托列表数据导出 | boolean | `false` | 是否可导出委托列表数据 | True | False | True | 1 |
### 房源跟进
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.follow.view_scope` | 查看房源跟进范围 | scope | `self` | 控制房源详情页的跟进查看范围：无/本人/本部/全部 | True | False | True | 1 |
| `property.follow.hide` | 隐藏/开放跟进 | scope | `none` | 按跟进人范围隐藏/开放跟进：无/本人/本部/全部 | True | False | True | 1 |
| `property.follow.view_hidden` | 查看隐藏跟进 | scope | `none` | 按跟进人范围查看被隐藏的跟进：无/本人/本部/全部 | True | False | True | 1 |
| `property.follow.pin` | 置顶/取消置顶跟进 | scope | `none` | 按跟进人范围置顶或取消置顶跟进：无/本人/本部/全部 | True | False | True | 1 |
### 房源附件
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.attachment.create` | 新增附件 | boolean | `false` | 是否可新增房源附件 | True | False | True | 1 |
| `property.attachment.view` | 查看附件 | scope | `none` | 按附件上传人范围查看：无/本人/本部/全部 | True | False | True | 1 |
| `property.attachment.edit` | 修改附件 | scope | `none` | 按附件上传人范围修改：无/本人/本部/全部 | True | False | True | 1 |
| `property.attachment.download` | 下载附件 | boolean | `false` | 是否可下载房源附件 | True | False | True | 1 |
| `property.attachment.delete` | 删除附件 | scope | `none` | 按附件上传人范围删除：无/本人/本部/全部 | True | False | True | 1 |
### 房源带看
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `property.showing.view_scope` | 查看房源带看数据 | scope | `none` | 按数据权限范围查看房源带看记录：无/本人/本部/全部 | True | False | True | 1 |
---
## 客源模块（36 条）
### 私客
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.private.create` | 新增私客 | boolean | `false` | 是否可新增私客 | True | False | True | 1 |
| `client.private.view` | 查看私客（非保护客） | scope | `self` | 按归属人范围查看非保护私客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.view_protected` | 查看私客（保护客） | scope | `self` | 按归属人范围查看保护私客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.edit` | 编辑私客（非保护客） | scope | `self` | 按归属人范围编辑非保护私客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.edit_protected` | 编辑私客（保护客） | scope | `self` | 按归属人范围编辑保护私客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.set_protected` | 设置/取消保护客 | scope | `self` | 设置/取消哪个范围的保护客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.to_public` | 私客转公客 | scope | `self` | 按归属人范围将私客转为公客：无/本人/本部/全部 | True | False | True | 1 |
| `client.private.export` | 私客列表导出 | boolean | `false` | 是否支持导出私客列表 | True | False | True | 1 |
### 公客
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.public.view` | 公客查看范围 | scope | `none` | 控制公客查看范围：无/本部/全部 | True | False | True | 1 |
| `client.public.to_private` | 公客转私客 | boolean | `false` | 是否可将可见范围内的公客转为私客 | True | False | True | 1 |
| `client.public.edit` | 编辑公客 | boolean | `false` | 是否可编辑公客信息 | True | False | True | 1 |
| `client.public.change_status` | 改公客状态 | boolean | `false` | 是否可修改公客状态 | True | False | True | 1 |
### 成交客
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.deal.view` | 查看成交客（私客类型） | scope | `self` | 按归属人范围查看归属人为个人的成交客：无/本人/本部/全部 | True | False | True | 1 |
| `client.deal.view_public` | 查看成交客（公客类型） | scope | `none` | 按归属人范围查看归属人为共享账号的成交客：无/本人/本部/全部 | True | False | True | 1 |
| `client.deal.re_transaction` | 成交客再次租/购 | boolean | `false` | 是否可对可见范围内成交客操作再次租/购 | True | False | True | 1 |
| `client.deal.export` | 导出成交客列表 | boolean | `false` | 是否可导出成交客列表 | True | False | True | 1 |
### 联系人号码
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.contact.view_phone_private` | 查看私客/成交客号码 | scope | `none` | 控制查看非保护私客及成交客的号码范围：无/本人/本部/全部 | True | False | True | 1 |
| `client.contact.view_phone_protected` | 查看保护客号码 | scope | `none` | 控制查看保护私客的号码范围：无/本人/本部/全部 | True | False | True | 1 |
| `client.contact.view_phone_public` | 查看公客号码 | scope | `none` | 控制查看公客号码范围：无/本部/全部 | True | False | True | 1 |
| `client.contact.view_phone_limit` | 每日查看联系人号码次数上限 | integer | `0` | 每天可查看客源联系人真实号码次数，0=不允许，-1=不限制 | True | False | True | 1 |
| `client.contact.edit_contact` | 编辑私客/成交客联系人 | scope | `none` | 控制编辑非保护私客及成交客联系人信息范围：无/本人/本部/全部 | True | False | True | 1 |
| `client.contact.edit_phone` | 编辑私客/成交客联系人号码 | scope | `none` | 控制编辑非保护私客及成交客联系人号码范围：无/本人/本部/全部 | True | False | True | 1 |
### 客源管理
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.mgmt.delete` | 删除客源 | boolean | `false` | 是否可删除客源及查看已删除客源 | True | False | True | 1 |
| `client.mgmt.to_deal` | 手动客源转为成交客 | boolean | `false` | 是否可手动将客源标记为成交客 | True | False | True | 1 |
| `client.mgmt.change_staff` | 单个客源修改相关员工 | scope | `none` | 可修改哪个范围内客源的相关方：无/本人/本部/全部 | True | False | True | 1 |
| `client.mgmt.batch_change_staff` | 批量客源修改相关员工 | scope | `none` | 批量修改哪个范围内客源的相关方：无/本人/本部/全部 | True | False | True | 1 |
| `client.mgmt.view_operation_log` | 查看客户/联系人操作日志 | boolean | `false` | 是否可查看客户详情页手机号修改/删除、客户合并等记录 | True | False | True | 1 |
| `client.mgmt.merge_private` | 允许合并自己的私客 | boolean | `false` | 是否可合并归属人为本人的私客 | True | False | True | 1 |
### 带看/预约
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.showing.create` | 带看/预约新增 | boolean | `false` | 是否可新增带看/预约记录 | True | False | True | 1 |
| `client.showing.view` | 私客/成交客详情页带看单查看 | scope | `self` | 按带看人范围查看私客/成交客的带看单：无/本人/本部/全部 | True | False | True | 1 |
| `client.showing.edit` | 带看/预约编辑、作废 | scope | `self` | 按带看人范围编辑或作废带看：无/本人/本部/全部 | True | False | True | 1 |
### 资料客
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `client.archive.view` | 查看资料客 | scope | `self` | 按归属人范围查看资料客：无/本人/本部/全部 | True | False | True | 1 |
| `client.archive.import` | 导入资料客 | boolean | `false` | 是否可导入资料客 | True | False | True | 1 |
| `client.archive.view_phone` | 查看资料客号码 | boolean | `false` | 是否可查看资料客号码 | True | False | True | 1 |
| `client.archive.delete` | 删除资料客 | boolean | `false` | 是否可删除资料客 | True | False | True | 1 |
| `client.archive.view_log` | 查看资料客操作日志 | scope | `self` | 查看哪个范围员工的资料客操作日志：无/本人/本部/全部 | True | False | True | 1 |
---
## 首页模块（4 条）
### 首页看板
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `home.dashboard.view_version` | 查看首页版本 | boolean | `false` | 控制员工可查看的首页数据版本（置业顾问/店管/区管等） | True | False | True | 1 |
| `home.dashboard.personal_rank` | 个人排行榜权限 | scope | `self` | 控制个人排行榜可见数据范围：无/本人/本部/全部 | True | False | True | 1 |
| `home.dashboard.dept_rank` | 部门排行榜权限 | scope | `none` | 控制部门排行榜可见数据范围：无/本人/本部/全部 | True | False | True | 1 |
| `home.dashboard.manage_praise` | 管理点赞信息和屏蔽点赞 | boolean | `false` | 是否可删除首页点赞墙内容和禁止员工发布 | True | False | True | 1 |
---
## 楼盘/小区模块（27 条）
### 楼盘管理
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| -------------------------------------- | ------------ | ---------- | ------------- | ---------------------------- | --- | --- | --- | --- |
| `complex.view` | 楼盘管理查看 | boolean | `false` | 是否显示楼盘管理模块 | True | False | True | 1 |
| `complex.view_structure` | 楼盘结构查看 | boolean | `false` | 是否可查看楼栋-单元-房号层级结构 | True | False | True | 1 |
| `complex.create` | 新增楼盘 | boolean | `false` | 是否可新增或批量新增楼盘 | True | False | True | 1 |
| `complex.create_unit` | 新增楼栋/单元/房号 | boolean | `false` | 是否可新增楼栋、单元、房号数据 | True | False | True | 1 |
| `complex.edit` | 编辑楼盘 | boolean | `false` | 是否可编辑楼盘信息 | True | False | True | 1 |
| `complex.edit_unit` | 编辑楼栋/单元/房号 | boolean | `false` | 是否可编辑楼栋、单元、房号信息 | True | False | True | 1 |
| `complex.delete` | 删除楼盘 | boolean | `false` | 是否可删除楼盘 | True | False | True | 1 |
| `complex.delete_unit` | 删除楼栋/单元/房号 | boolean | `false` | 是否可删除楼栋、单元、房号 | True | False | True | 1 |
| `complex.delete_with_property` | 删除楼盘数据（含房源） | boolean | `false` | 是否可无视房源直接删除楼盘及以下所有数据 | True | False | True | 1 |
| `complex.merge` | 合并楼盘 | boolean | `false` | 是否可合并不同层级楼盘数据 | True | False | True | 1 |
| `complex.move_unit` | 移动楼栋/单元/房号数据 | boolean | `false` | 是否可将楼栋单元数据移动至其他楼盘 | True | False | True | 1 |
| `complex.lock` | 锁定/解锁楼盘 | boolean | `false` | 是否可操作锁定或解锁楼盘 | True | False | True | 1 |
| `complex.view_deal` | 楼盘挂牌成交数据 | boolean | `false` | 是否显示楼盘挂牌及成交数据 | True | False | True | 1 |
| `complex.view_deal_detail` | 司内成交明细及套数 | boolean | `false` | 是否显示公司成交房源明细信息及套数 | True | False | True | 1 |
| `complex.view_address_scope` | 楼街房源地址数据查看范围 | scope | `self` | 控制查看部门内其他员工楼街房源地址数据：本人/本部/全部 | True | False | True | 1 |
| `complex.region_manage` | 区域管理 | boolean | `false` | 是否可对区域商圈进行新增、合并、关联操作 | True | False | True | 1 |
### 楼盘资料
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `complex.material.view_photo` | 楼盘照片 | boolean | `false` | 是否显示楼盘照片列表 | True | False | True | 1 |
| `complex.material.manage_photo` | 管理照片 | boolean | `false` | 是否可上传照片、设为封面 | True | False | True | 1 |
| `complex.material.delete_photo` | 删除照片 | boolean | `false` | 是否可删除楼盘照片 | True | False | True | 1 |
| `complex.material.download_photo` | 下载照片 | boolean | `false` | 是否可下载楼盘照片 | True | False | True | 1 |
| `complex.material.view_attachment` | 楼盘附件 | boolean | `false` | 是否显示楼盘附件模块 | True | False | True | 1 |
| `complex.material.manage_attachment` | 管理附件 | boolean | `false` | 是否可上传楼盘附件 | True | False | True | 1 |
| `complex.material.download_attachment` | 下载附件 | boolean | `false` | 是否可下载楼盘附件 | True | False | True | 1 |
| `complex.material.delete_attachment` | 删除附件 | boolean | `false` | 是否可删除楼盘附件 | True | False | True | 1 |
| `complex.material.view_surrounding` | 周边配套 | boolean | `false` | 是否显示周边配套模块 | True | False | True | 1 |
### 楼盘反馈
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `complex.feedback.view` | 楼盘反馈列表 | scope | `self` | 可查看小区反馈列表的数据范围：本人/本部/全部 | True | False | True | 1 |
| `complex.feedback.handle` | 楼盘反馈处理 | boolean | `false` | 是否可处理或不予处理楼盘反馈 | True | False | True | 1 |
---
## 组织人事-组织模块（21 条）
### 组织管理
| permission_code | display_name | value_type | default_value | description | is_active | is_deprecated | is_system | version |
| --------------------------------- | ------------- | ---------- | ------------- | ----------------------------- | --- | --- | --- | --- |
| `org.view_structure` | 组织结构查看 | scope | `self` | 控制组织结构页面的部门/员工查看范围：无/本人/本部/全部 | True | False | True | 1 |
| `org.view_dept` | 部门查看 | boolean | `false` | 是否可查看部门信息 | True | False | True | 1 |
| `org.edit_dept` | 部门维护 | boolean | `false` | 是否可对部门进行编辑操作 | True | False | True | 1 |
| `org.view_staff` | 员工查看 | boolean | `false` | 是否可查看员工详情 | True | False | True | 1 |
| `org.edit_staff` | 员工维护 | boolean | `false` | 是否可进行员工异动、批量设置员工上级等操作 | True | False | True | 1 |
| `org.edit_staff_detail` | 员工详情编辑 | boolean | `false` | 是否可编辑员工信息、新增奖惩记录、编辑账号信息 | True | False | True | 1 |
| `org.freeze_account` | 员工账号冻结/解冻 | boolean | `false` | 是否可冻结/解冻员工账号 | True | False | True | 1 |
| `org.import_staff` | 批量导入员工 | boolean | `false` | 是否可批量导入员工 | True | False | True | 1 |
| `org.export_staff` | 导出员工 | boolean | `false` | 是否可导出员工数据 | True | False | True | 1 |
| `org.view_permission` | 员工权限查看 | boolean | `false` | 是否可查看员工权限配置 | True | False | True | 1 |
| `org.edit_permission` | 员工权限设置 | boolean | `false` | 是否可编辑员工权限 | True | False | True | 1 |
| `org.export_permission` | 权限管理页面导出 | boolean | `false` | 是否可在权限管理页面导出员工角色及管理范围数据 | True | False | True | 1 |
| `org.edit_position` | 职务维护 | boolean | `false` | 是否可新增/编辑/删除/合并员工职务 | True | False | True | 1 |
| `org.edit_role` | 角色维护 | boolean | `false` | 是否可展示角色管理页面并进行角色编辑 | True | False | True | 1 |
| `org.view_store_list` | 门店列表查看 | boolean | `false` | 是否可查看门店列表 | True | False | True | 1 |
| `org.export_store_list` | 门店列表导出 | boolean | `false` | 是否可导出门店列表 | True | False | True | 1 |
| `org.view_contact_book` | 员工通讯录查看 | scope | `self` | 控制查看员工通讯录的范围：无/本人/本部/全部 | True | False | True | 1 |
| `org.transfer_business` | 转移业务归属 | scope | `none` | 控制转出/转入人的可选范围：无/本人/本部/全部 | True | False | True | 1 |
| `org.resign_apply` | 离职申请范围 | scope | `self` | 控制员工离职申请范围：无/本人/本部/全部 | True | False | True | 1 |
| `org.invite_onboard` | 入职邀请 | boolean | `false` | 是否可生成入职邀请链接/二维码 | True | False | True | 1 |
| `org.view_contact_phone_limit` | 每日查看通讯录电话次数上限 | integer | `0` | 每天可查看员工通讯录电话次数，0=不允许，-1=不限制 | True | False | True | 1 |
---
## 汇总
| 模块 | 条数 |
| -------------- | ------- | --- | --- | --- | --- |
| property（房源） | 66 |
| client（客源） | 36 |
| home（首页） | 4 |
| complex（楼盘/小区） | 27 |
| org（组织人事-组织） | 21 |
| **合计** | **154** |
---
## 公共元数据（所有记录相同）
| 字段 | 值 |
| --------------- | ---------------------------------------------------- |
| `is_active` | `True` |
| `is_deprecated` | `False` |
| `is_system` | `True` |
| `version` | `1` |
| `schema` | `public`（SHARED_APPS，migration 在 public schema 运行一次） |
---
## Migration 分批策略
| 批次 | Migration 文件名 | 涵盖模块 | 条数 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | `0002_seed_permission_property.py` | property | 66 |
| 2 | `0003_seed_permission_client.py` | client | 36 |
| 3 | `0004_seed_permission_home_complex_hr.py` | home + complex + hr | 52 |
> 每个 migration 包含 `forwards` 和 `backwards` 函数，`backwards` 按 code 批量删除，保证可回滚。
---
## 内置角色 role_permissions 分配（最大权限角色）
**策略**：内置「最大权限角色」对以上全部 154 条 PermissionDef 设置最大开放值：
- `boolean` 类型 → `true`
- `scope` 类型 → `all`（全部）
- `integer` 类型 → `-1`（不限制）
其余 2 个内置角色（高级业务员 / 分行经理）不预置 role_permissions，由租户管理员自行配置。
---
## 系统管理模块说明（本批不纳入）
系统管理（Admin Console）面向 Platform Super Admin / Ops Operator，这两个角色在 `public` schema 使用独立认证体系，不走租户 RBAC。
访问控制在 view 层直接用 Django `is_staff` / `is_superuser` 或平台角色装饰器控制，无需 PermissionDef 记录。
如后续 Platform Admin 角色扩展到 3 个以上且需要功能细分，再单独追加一版 migration。

23
Project/fonrey/PRD/权限管理/权限管理模块PRD.md
View File

@@ -467,15 +467,19 @@ Fonrey 采用 **RBAC（基于角色的访问控制）+ 个人权限叠加** 的
| 创建时间 | 角色创建时间 |
| 修改时间 | 最后一次权限修改时间 |
#### 5.5.2 已知系统内置角色（来自截图）
#### 5.5.2 已知系统内置角色
| 角色名称 | 角色类别 | 适用场景 |
|----------|----------|----------|
| 刘文龙 | 置业顾问 | 高级业务员 |
| 最大权限角色 | 总经 | 系统管理员/超管角色 |
| 行政人员 | 置业顾问 | 行政人员 |
| 分行经理 | 店管 | 分行级别管理职务 |
| 高级业务员 | 置业顾问 | 标准销售顾问 |
以下角色为系统内置角色，**用户可新增角色，但这些角色不可删除**。
| 角色名称 |
| ---- |
| 置业顾问 |
| 店管 |
| 区管 |
| 区总 |
| 副总 |
| 总经 |
| 其他职能 |
#### 5.5.3 角色类别说明
@@ -585,7 +589,9 @@ Fonrey 采用 **RBAC（基于角色的访问控制）+ 个人权限叠加** 的
│ ├── 挂牌分析
│ └── 房源广场
├── 新房
│ ├── 新房
├── 客源
│ ├── 客源
├── 交易
│ ├── 交易管理
│ ├── 二手房售后管理
@@ -614,6 +620,7 @@ Fonrey 采用 **RBAC（基于角色的访问控制）+ 个人权限叠加** 的
│ ├── 业务工具
│ └── 安装与登录授权
├── 移动端
│ ├── 移动端
├── 智能门店
│ ├── 智慧大屏
│ └── VR 换装

32
Project/fonrey/PRD/权限管理/组织人事-组织.md Normal file
View File

@@ -0,0 +1,32 @@
| 管理权限 | 🔴（开启） | 说明 |
| ---------------- | ---------- | --------------------------------------------------------------------------------------------------- |
| 组织结构查看 | 无/本人/本部/全部 | 控制组织结构页面的部门/员工查看范围 |
| 部门查看 | true/false | 控制是否可以查看部门信息 |
| 部门维护 | true/false | 控制是否可以对部门进行编辑操作 |
| 员工查看 | true/false | 控制是否可以查看员工详情 |
| 员工维护 | true/false | 控制是否可以查看员工详情、进行员工异动、批量设置员工上级 |
| 员工详情编辑 | true/false | 控制是否能编辑员工信息、新增奖惩记录、编辑账号信息、上传员工相关资料、复职员工，该权限控制的功能点需要与「员工查看和维护」权限共同开启才能正常使用 |
| 员工账号冻结/解冻 | true/false | 控制是否可以冻结/解冻员工账号 |
| 批量导入员工 | true/false | 控制是否可以批量导入员工 |
| 导出员工 | true/false | 控制是否可以导出员工 |
| 员工权限查看 | true/false | |
| 员工权限设置 | true/false | 控制是否能够编辑员工权限 |
| 权限管理页面导出 | true/false | 开启后可在权限管理页面导出员工角色及管理范围数据 |
| 营销号绑定 | true/false | |
| 职务维护 | true/false | 控制是否能够新增/编辑/删除/合并员工职务 |
| 角色维护 | true/false | 控制是否展示角色管理页面 |
| 门店列表查看 | true/false | 若启用，则可查看门店列表 |
| 门店列表导出 | true/false | 若启用，则可导出门店列表 |
| 门店分布图查看 | true/false | 若启用，则可查看门店分布图列表 |
| 员工通讯录查看 | 无/本人/本部/全部 | 控制是否能够查看员工通讯录 |
| 员工通讯录电话查看 | 999 | 每天可查看员工通讯录电话查看次数，999=不限制，0=不允许 |
| 员工通讯录电话拨打 | 999 | 每天可通过巧房小号拨打员工号码次数，999=不限制，0=不允许 |
| 转移业务归属功能 | 无/本人/本部/全部 | 控制转出/转入人的可选范围 |
| 清空非有效门店的钥匙委托实勘资源 | true/false | 若开启，则可操作清空所有非有效门店下员工的钥匙委托实勘资源（无需在权限里配置扩充部门权限/加盟架构，所有状态符合的门店均可操作，请谨慎开启）。请注意，此权限需「转移业主归属功能」为本部或全部，才生效 |
| 绑定短信/绑定链接 | true/false | 控制员工是否能进行下发绑定短信/绑定链接操作 |
| 人工通过身份验证 | true/false | 协助员工完成PC/APP的登录实名校验。 |
| 离职申请范围 | 无/本人/本部/全部 | 控制员工离职申请范围 |
| 入职邀请 | true/false | 控制员工是否可以生成入职邀请链接/二维码 |
| 员工入职黑名单 | true/false | |

344
Project/fonrey/PRD/权限管理/角色权限矩阵.md Normal file
View File

@@ -0,0 +1,344 @@
# 角色权限矩阵 — Fonrey MVP
**版本**: v1.0
**更新**: 2026-04-30
**依据**: `PERMISSION_SEED_MVP_BATCH1.md`（154 条）× 7 个系统内置角色
**状态**: Draft — 待产品 / 业务确认
---
## 角色说明
| 角色 | 定位 | 典型层级 |
| -------- | ---------------------------- | ------------------ |
| 置业顾问 | 一线销售，操作个人名下数据 | 门店员工 |
| 店管 | 门店管理，可查看本店数据 | 门店负责人 |
| 区管 | 区域管理，可查看本区数据 | 区域负责人 |
| 区总 | 区域总负责，更广的操作权限 | 大区总监 |
| 副总 | 公司副总，全公司数据可见 | 副总经理 |
| 总经 | 最高管理层，全量权限 | 总经理 / 超管角色 |
| 其他职能 | 行政、HR 等非业务岗，受限访问 | 职能部门人员 |
---
## 取值说明
| 类型 | 可选值 | 含义 |
| ------- | ---------------- | ----------------------------------- |
| boolean | `✓` / `✗` | 开启 / 关闭 |
| scope | `—` / `本人` / `本部` / `全部` | 无权限 / 本人 / 本部门及以下 / 全公司 |
| integer | `0` / 数字 / `∞` | 不允许 / 上限次数 / 不限制 |
> **scope 继承原则**：「本部」= 本门店及所辖组；「全部」= 全公司。
> 区管/区总的「本部」含义对应其管辖的门店范围，不限于单一门店。
---
## 一、房源模块（property）
### 1.1 房源基础（property.listing）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增房源 | `property.listing.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 维护房源查看范围 | `property.listing.view_scope` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 公盘查看 | `property.listing.view_public` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 私盘查看 | `property.listing.view_private` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源改为公盘 | `property.listing.set_public` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源改为私盘 | `property.listing.set_private` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源改为封盘 | `property.listing.set_locked` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源改为特盘 | `property.listing.set_special` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除房源 | `property.listing.delete` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 恢复已删除房源 | `property.listing.restore` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 房源列表数据导出 | `property.listing.export` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 修改房屋介绍信息 | `property.listing.edit_description` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 成交房源列表及价格信息 | `property.listing.view_deal` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 价格解读 | `property.listing.price_read` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看房源挂牌历史 | `property.listing.view_history` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看同业主其他房源 | `property.listing.view_owner_others` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 修改房源保护设置 | `property.listing.set_protected` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看保护期内房源 | `property.listing.view_protected` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 修改相关方范围 | `property.listing.change_keeper` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 重复房源合并 | `property.listing.merge_duplicate` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 修改为我售/我租状态 | `property.listing.status_sold` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源等级设为A | `property.listing.grade_set_a` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 将房源等级设为E | `property.listing.grade_set_e` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 1.2 业主/联系人与号码（property.contact）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看业主/联系人号码 | `property.contact.view_phone` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 每日查看号码次数上限 | `property.contact.view_phone_limit` | 20 | ∞ | ∞ | ∞ | ∞ | ∞ | 0 |
| 新增业主/联系人 | `property.contact.add_contact` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 修改业主核心信息 | `property.contact.edit_core` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 修改业主非核心信息 | `property.contact.edit_basic` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 删除业主/联系人 | `property.contact.delete_contact` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看产证信息 | `property.contact.view_cert` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看业主联系人操作日志 | `property.contact.view_operation_log` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 1.3 房源地址（property.address）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看楼栋/单元/楼层/房号 | `property.address.view_detail` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 每日查看地址次数上限 | `property.address.view_limit` | 10 | ∞ | ∞ | ∞ | ∞ | ∞ | 0 |
| 修改楼栋/单元/楼层/房号 | `property.address.edit` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
### 1.4 房源钥匙（property.key）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增钥匙 | `property.key.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 修改钥匙 | `property.key.edit` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 退还钥匙 | `property.key.return` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看钥匙密码 | `property.key.view_password` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看钥匙编号 | `property.key.view_number` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 钥匙借出 | `property.key.borrow` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 钥匙归还 | `property.key.give_back` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 删除钥匙 | `property.key.delete` | — | 本人 | 本部 | 全部 | 全部 | 全部 | — |
| 钥匙列表数据导出 | `property.key.export` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 1.5 房源实勘（property.survey）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增实勘图片 | `property.survey.create_photo` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 下载图片 | `property.survey.download_photo` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除图片 | `property.survey.delete_photo` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 新增实勘 | `property.survey.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看实勘 | `property.survey.view` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 上传视频 | `property.survey.upload_video` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 下载视频 | `property.survey.download_video` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 播放视频 | `property.survey.play_video` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 1.6 房源委托（property.mandate）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增委托 | `property.mandate.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 续签/违约委托 | `property.mandate.renew` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 委托列表查看 | `property.mandate.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 委托作废 | `property.mandate.revoke` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 委托列表数据导出 | `property.mandate.export` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 1.7 房源跟进（property.follow）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看房源跟进范围 | `property.follow.view_scope` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 隐藏/开放跟进 | `property.follow.hide` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看隐藏跟进 | `property.follow.view_hidden` | — | 本人 | 本部 | 全部 | 全部 | 全部 | — |
| 置顶/取消置顶跟进 | `property.follow.pin` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
### 1.8 房源附件（property.attachment）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增附件 | `property.attachment.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看附件 | `property.attachment.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 修改附件 | `property.attachment.edit` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 下载附件 | `property.attachment.download` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除附件 | `property.attachment.delete` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
### 1.9 房源带看（property.showing）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看房源带看数据 | `property.showing.view_scope` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
---
## 二、客源模块（client）
### 2.1 私客（client.private）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 新增私客 | `client.private.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看私客（非保护客） | `client.private.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看私客（保护客） | `client.private.view_protected` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 编辑私客（非保护客） | `client.private.edit` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 编辑私客（保护客） | `client.private.edit_protected` | 本人 | 本人 | 本部 | 全部 | 全部 | 全部 | — |
| 设置/取消保护客 | `client.private.set_protected` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 私客转公客 | `client.private.to_public` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 私客列表导出 | `client.private.export` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 2.2 公客（client.public）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 公客查看范围 | `client.public.view` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 公客转私客 | `client.public.to_private` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 编辑公客 | `client.public.edit` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 改公客状态 | `client.public.change_status` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 2.3 成交客（client.deal）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看成交客（私客类型） | `client.deal.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看成交客（公客类型） | `client.deal.view_public` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 成交客再次租/购 | `client.deal.re_transaction` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 导出成交客列表 | `client.deal.export` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 2.4 联系人号码（client.contact）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看私客/成交客号码 | `client.contact.view_phone_private` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看保护客号码 | `client.contact.view_phone_protected` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看公客号码 | `client.contact.view_phone_public` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 每日查看联系人号码次数上限 | `client.contact.view_phone_limit` | 20 | ∞ | ∞ | ∞ | ∞ | ∞ | 0 |
| 编辑私客/成交客联系人 | `client.contact.edit_contact` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 编辑私客/成交客联系人号码 | `client.contact.edit_phone` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
### 2.5 客源管理（client.mgmt）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 删除客源 | `client.mgmt.delete` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 手动客源转为成交客 | `client.mgmt.to_deal` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 单个客源修改相关员工 | `client.mgmt.change_staff` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 批量客源修改相关员工 | `client.mgmt.batch_change_staff` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 查看客户/联系人操作日志 | `client.mgmt.view_operation_log` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 允许合并自己的私客 | `client.mgmt.merge_private` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 2.6 带看/预约（client.showing）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 带看/预约新增 | `client.showing.create` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 私客/成交客详情页带看单查看 | `client.showing.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 带看/预约编辑、作废 | `client.showing.edit` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
### 2.7 资料客（client.archive）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看资料客 | `client.archive.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 导入资料客 | `client.archive.import` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看资料客号码 | `client.archive.view_phone` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除资料客 | `client.archive.delete` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 查看资料客操作日志 | `client.archive.view_log` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
---
## 三、首页模块（home）
### 3.1 首页看板（home.dashboard）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 查看首页版本 | `home.dashboard.view_version` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 个人排行榜权限 | `home.dashboard.personal_rank` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 部门排行榜权限 | `home.dashboard.dept_rank` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 管理点赞信息和屏蔽点赞 | `home.dashboard.manage_praise` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
---
## 四、楼盘/小区模块（complex）
### 4.1 楼盘管理（complex.*)
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 楼盘管理查看 | `complex.view` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 楼盘结构查看 | `complex.view_structure` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 新增楼盘 | `complex.create` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 新增楼栋/单元/房号 | `complex.create_unit` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 编辑楼盘 | `complex.edit` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 编辑楼栋/单元/房号 | `complex.edit_unit` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除楼盘 | `complex.delete` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除楼栋/单元/房号 | `complex.delete_unit` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除楼盘数据（含房源） | `complex.delete_with_property` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 合并楼盘 | `complex.merge` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 移动楼栋/单元/房号数据 | `complex.move_unit` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 锁定/解锁楼盘 | `complex.lock` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 楼盘挂牌成交数据 | `complex.view_deal` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 司内成交明细及套数 | `complex.view_deal_detail` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 楼街房源地址数据查看范围 | `complex.view_address_scope` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 区域管理 | `complex.region_manage` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
### 4.2 楼盘资料（complex.material）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 楼盘照片 | `complex.material.view_photo` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 管理照片 | `complex.material.manage_photo` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 删除照片 | `complex.material.delete_photo` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 下载照片 | `complex.material.download_photo` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 楼盘附件 | `complex.material.view_attachment` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 管理附件 | `complex.material.manage_attachment` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 下载附件 | `complex.material.download_attachment` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 删除附件 | `complex.material.delete_attachment` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 周边配套 | `complex.material.view_surrounding` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
### 4.3 楼盘反馈（complex.feedback）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 楼盘反馈列表 | `complex.feedback.view` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 楼盘反馈处理 | `complex.feedback.handle` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
---
## 五、组织人事-组织模块（org）
### 5.1 组织管理（org.*）
| 权限项 | permission_code | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ------ | --------------- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| 组织结构查看 | `org.view_structure` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | 本人 |
| 部门查看 | `org.view_dept` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 部门维护 | `org.edit_dept` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工查看 | `org.view_staff` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工维护 | `org.edit_staff` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工详情编辑 | `org.edit_staff_detail` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工账号冻结/解冻 | `org.freeze_account` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 批量导入员工 | `org.import_staff` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 导出员工 | `org.export_staff` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工权限查看 | `org.view_permission` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 员工权限设置 | `org.edit_permission` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 权限管理页面导出 | `org.export_permission` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 职务维护 | `org.edit_position` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 角色维护 | `org.edit_role` | ✗ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ |
| 门店列表查看 | `org.view_store_list` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 门店列表导出 | `org.export_store_list` | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 员工通讯录查看 | `org.view_contact_book` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | 本人 |
| 转移业务归属 | `org.transfer_business` | — | 本部 | 本部 | 全部 | 全部 | 全部 | — |
| 离职申请范围 | `org.resign_apply` | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | 本人 |
| 入职邀请 | `org.invite_onboard` | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 每日查看通讯录电话次数上限 | `org.view_contact_phone_limit` | 5 | ∞ | ∞ | ∞ | ∞ | ∞ | 5 |
---
## 六、横向对比：各角色权限宽度一览
> 快速识别各角色的整体权限层级，便于向业务方解释。
| 维度 | 置业顾问 | 店管 | 区管 | 区总 | 副总 | 总经 | 其他职能 |
| ---- | :------: | :--: | :--: | :--: | :--: | :--: | :------: |
| **数据范围（scope）** | 本人 | 本部 | 本部 | 全部 | 全部 | 全部 | 无/本人 |
| **房源操作** | 基础增查改 | + 删/改状态/导出 | 同店管 | + 跨区操作 | 同区总 | 全量 | 无 |
| **客源查看** | 个人私客 | 本店全量 | 本区全量 | 全公司 | 全公司 | 全公司 | 无 |
| **号码查看上限/日** | 20 次 | 不限 | 不限 | 不限 | 不限 | 不限 | 0 |
| **组织人事操作** | 无 | 查看/导出 | + 维护/冻结 | + 权限管理/角色 | 同区总 | 全量 | 无 |
| **楼盘管理** | 只读 | + 增改删(单元) | + 删楼盘/合并/区域 | + 删楼盘含房源 | 同区总 | 全量 | 只读 |
---
## 七、Open Questions（待确认）
| # | 问题 | 涉及权限 | 影响角色 | 当前保守默认 | 截止确认日期 |
| - | ---- | -------- | -------- | ------------ | ------------ |
| Q1 | 置业顾问是否可查看**公盘**？部分公司公盘仅店管以上可见 | `property.listing.view_public` | 置业顾问 | ✓（开放） | — |
| Q2 | 置业顾问**每日查看号码次数**（房源/客源），业务方确认上限值 | `property.contact.view_phone_limit` / `client.contact.view_phone_limit` | 置业顾问 | 20 次 | — |
| Q3 | 店管是否可**编辑保护客**（`edit_protected`）？设为「本人」还是「本部」 | `client.private.edit_protected` | 店管 | 本人（保守） | — |
| Q4 | **权限管理（`org.edit_permission`）** 是否从区总才开放，还是区管也可配置本店员工权限 | `org.view_permission` / `org.edit_permission` | 区管 | ✗（不开放） | — |
| Q5 | 其他职能是否需要访问**楼盘模块**（查看楼盘/楼盘资料）？ | `complex.view` / `complex.material.*` | 其他职能 | ✓（只读） | — |
| Q6 | **副总与总经权限是否完全相同**？还是副总有哪些项目需要受限 | 全量 scope 类 | 副总 | 同总经 | — |
---
*本矩阵基于 `PERMISSION_SEED_MVP_BATCH1.md` 154 条权限定义生成。确认后将同步更新 `PERMISSION_SEED_MVP_BATCH1.md` 内置角色 role_permissions 分配策略。*