# Fonrey 系统角色 Persona 定义

**版本**：v1.0  
**状态**：已定稿  
**作者**：产品团队  
**最后更新**：2026-04-30  

> 本文档是 Fonrey 所有 PRD、DATA_MODEL、PERMISSION_SEED 等文档的角色命名**唯一权威来源**。  
> 所有其他文档中的角色称谓**必须**以本文档为准，禁止自造名称或混用。

---

## 一、角色层级概览

```
┌─────────────────────────────────────────────────────────┐
│                    Fonrey SaaS 平台                      │
│                                                         │
│  ① Platform Admin（平台超级管理员）                      │
│     └── 管理所有租户：开通、暂停、配置、版本升级           │
│                                                         │
│  ─ ─ ─ ─ ─ ─ ─ 租 户 边 界 ─ ─ ─ ─ ─ ─ ─ ─ ─         │
│                                                         │
│  ② Tenant Admin（租户管理员）                            │
│     └── 管理本租户：组织架构、账号、权限、系统配置         │
│                                                         │
│  ③ Agent（经纪人）                                       │
│     └── 日常业务操作：录入房源、跟进客源、查看数据         │
│                                                         │
└─────────────────────────────────────────────────────────┘
```

---

## 二、Persona 详细定义

### P1 — Platform Admin（平台超级管理员）

| 属性               | 值                     |
| ---------------- | --------------------- |
| **Persona 名称**   | Platform Admin        |
| **中文称谓**         | 平台超级管理员               |
| **Persona Code** | `PLATFORM_ADMIN`      |
| **所属层**          | 平台层（Platform）         |
| **账号归属**         | 平台运营团队（Fonrey 公司内部人员） |
| **账号数量**         | 极少，手动创建，不通过租户系统管理     |
| **认证入口**         | 独立管理后台（非租户客户端）        |
| **Schema 归属**    | `public`（跨所有租户）       |

**职责范围：**
- 创建、暂停、注销租户（Tenant）
- 为租户初始化 Tenant Admin 账号
- 管理平台版本、发布客户端安装包
- 监控系统健康状态、查看平台级日志
- 配置平台级参数（短信网关、OSS、第三方集成等）

**不涉及：**
- 不进入任何租户的业务数据
- 不参与租户内部的权限分配、组织管理

**关键约束：**
- Platform Admin 走**独立认证体系**，不纳入租户 RBAC 权限模型
- 无需在 `permission_definitions` 中注册权限项

---

### P2 — Tenant Admin（租户管理员）

| 属性               | 值                                  |
| ---------------- | ---------------------------------- |
| **Persona 名称**   | Tenant Admin                       |
| **中文称谓**         | 租户管理员                              |
| **Persona Code** | `TENANT_ADMIN`                     |
| **所属层**          | 租户层（Tenant）                        |
| **账号归属**         | 各租户（房产经纪公司）的系统管理员                  |
| **账号数量**         | 每个租户 1～3 个，由 Platform Admin 创建初始账号 |
| **认证入口**         | 与经纪人相同的租户客户端（Electron App）         |
| **登录账号**         | 平台运营分配的自定义字符串（不限于手机号格式）            |
| **初始密码**         | 平台统一固定初始密码，首次登录强制修改                |
| **Schema 归属**    | 租户 Schema（`tenant_{id}`）           |
|                  |                                    |

**职责范围：**
- 维护组织架构（部门/门店树）
- 办理员工入职、离职、调动
- 创建和管理员工系统账号
- 配置角色与权限（角色创建、权限分配、个人权限调整）
- 配置系统枚举值（Lookup Items）、房源录入规则、客源规则
- 查看全租户范围的业务数据（受数据权限规则约束）

**不涉及：**
- 不能跨租户操作
- 不能修改平台级配置（版本、短信网关等）

**与「经纪人」的区别：**
- Tenant Admin 是**管理身份**，不从事日常房源/客源业务操作
- 在系统内显示为「管理员」身份，拥有全模块管理权限
- 可以同时持有某个业务角色（如总经），但账号性质以 Tenant Admin 为主

**在 PRD 中的出现场景：**
- 组织人事管理模块的主操作者
- 权限管理模块的主操作者
- 系统配置模块的主操作者
- 在楼盘管理、发布管理中执行管理操作的用户

---

### P3 — Agent（经纪人）

| 属性               | 值                             |
| ---------------- | ----------------------------- |
| **Persona 名称**   | Agent                         |
| **中文称谓**         | 经纪人                           |
| **Persona Code** | `AGENT`                       |
| **所属层**          | 租户层（Tenant）                   |
| **账号归属**         | 各租户的在职员工                      |
| **账号数量**         | 每个租户 N 个，由 Tenant Admin 创建    |
| **认证入口**         | 租户客户端（Electron App）           |
| **登录账号**         | 手机号（由 Tenant Admin 录入员工时自动创建） |
| **初始密码**         | 系统统一固定初始密码，首次登录强制修改           |
| **Schema 归属**    | 租户 Schema（`tenant_{id}`）      |

**内部岗位子类型（Agent Sub-roles）：**

Agent 是统称，内部通过「角色」区分岗位权限层级。系统内置以下角色（不可删除）：

| 角色名称 | Role Code        | 典型岗位     | 数据权限范围    |
| ---- | ---------------- | -------- | --------- |
| 置业顾问 | `ROLE_AGENT`     | 一线经纪人    | 仅自己的数据    |
| 店管   | `ROLE_STORE_MGR` | 门店店长     | 本门店数据     |
| 区管   | `ROLE_AREA_MGR`  | 区域经理     | 本区域数据     |
| 区总   | `ROLE_AREA_DIR`  | 区域总监     | 本区域+下属区数据 |
| 副总   | `ROLE_VP`        | 副总经理     | 全公司数据（部分） |
| 总经   | `ROLE_GM`        | 总经理      | 全公司数据     |
| 其他职能 | `ROLE_OTHER`     | 行政/财务/HR | 按需配置      |

**在 PRD 中的出现场景：**
- 房源管理模块的主操作者
- 客源管理模块的主操作者
- 楼盘管理模块的查看用户
- 登录模块的主要使用者

---

## 三、命名规范与替换对照表

以下为历史文档中出现的混乱称谓，与标准称谓的对照关系：

| 历史称谓（禁止继续使用） | 应替换为                    | 说明               |
| ------------ | ----------------------- | ---------------- |
| 超级管理员        | Platform Admin（平台超级管理员） | 仅指平台层            |
| 平台管理员        | Platform Admin（平台超级管理员） | 同上               |
| 系统管理员        | Tenant Admin（租户管理员）     | 租户层管理员           |
| 管理员（泛称）      | Tenant Admin（租户管理员）     | 明确指向租户层          |
| HR 管理员       | Tenant Admin（租户管理员）     | 同一人，不区分子角色       |
| HR 行政        | Tenant Admin（租户管理员）     | 同上               |
| 一线经纪人        | Agent（经纪人）              | 统称，角色层面才区分岗位     |
| 置业顾问（作为用户称谓） | Agent（经纪人）              | 置业顾问仅作为「内置角色名」使用 |

**规则说明：**
1. PRD User Story 的 **As a** 部分：使用中文称谓（`Tenant Admin（租户管理员）`、`Agent（经纪人）`）
2. 权限矩阵、DATA_MODEL 注释：使用 Persona Code（`TENANT_ADMIN`、`AGENT`）
3. 角色名称（置业顾问、店管、总经等）**仅在角色管理相关语境中**出现，不作为用户身份称谓
4. `Platform Admin` 在各 PRD 中尽量少出现，其功能属于「系统管理模块」，不在各子模块 PRD 内展开

---

## 四、快速索引

| 场景 | 使用 |
|------|------|
| PRD User Story 主语 | `Tenant Admin（租户管理员）` / `Agent（经纪人）` |
| 错误提示文案（面向用户） | 「请联系您的租户管理员」 |
| DATA_MODEL 注释 | `created_by: 创建该记录的 Agent（经纪人）用户 ID` |
| 权限矩阵行标题 | 使用角色名（置业顾问 / 店管 / 总经 ...） |
| 代码注释 / 枚举值 | `PLATFORM_ADMIN` / `TENANT_ADMIN` / `AGENT` |
| 日志、审计记录 | `operator_type: PLATFORM_ADMIN / TENANT_ADMIN / AGENT` |