# Ether 智慧物业管理平台 - 产品需求说明书

**文档版本**: v3.1  
**创建日期**: 2026-02-13  
**文档状态**: 待评审  
**适用范围**: 商业物业、住宅物业
**更新日期**: 2026-02-27

---

## 目录

1. [文档概述](#一文档概述)
2. [市场调研总结](#二市场调研总结)
3. [功能模块清单](#三功能模块清单)
4. [角色权限矩阵](#四角色权限矩阵)
5. [核心业务流程](#五核心业务流程)
6. [非功能性需求](#六非功能性需求)
7. [与现有系统对比](#七与现有系统对比)
8. [开发优先级规划](#八开发优先级规划)
9. [附录](#九附录)

---

## 一、文档概述

### 1.1 项目背景

Ether 智慧物业管理平台是一个基于微服务架构的综合性物业管理解决方案，旨在为商业物业（写字楼、商业综合体、产业园区）和住宅物业（住宅小区、公寓）提供全方位的信息化管理服务。

### 1.2 项目目标

- **数字化转型**: 实现物业管理业务的全流程数字化
- **效率提升**: 通过自动化和智能化提升运营效率
- **服务优化**: 提升业主/租户服务体验
- **数据驱动**: 建立数据分析和决策支持能力
- **移动办公**: 支持多端访问，实现移动办公

### 1.3 适用范围

| 物业类型 | 典型场景 | 核心需求 |
|---------|---------|---------|
| 商业物业 | 写字楼、商业综合体、产业园区 | 租户管理、招商租赁、车位管理、能耗管理 |
| 住宅物业 | 住宅小区、公寓、别墅 | 业主服务、社区运营、便民服务、智能家居 |

---

## 二、市场调研总结

### 2.1 国内主流物业管理软件分析

#### 2.1.1 金蝶我家云

**产品定位**: 云端物业管理解决方案

**核心特点**:
- 财务管理深度整合，与金蝶财务软件无缝对接
- 全场景收费管理，支持多种缴费方式
- 完善的预算管理和成本控制
- 强大的报表分析功能

**适用场景**: 中大型物业公司，注重财务管理的场景

#### 2.1.2 明源云

**产品定位**: 地产生态链智能化解决方案

**核心特点**:
- 覆盖地产开发全链条
- 招商租赁管理深度优化
- 客户关系管理（CRM）完善
- 数据中台能力强大

**适用场景**: 大型地产集团，商业物业管理

#### 2.1.3 万科睿服务

**产品定位**: 智慧社区运营平台

**核心特点**:
- 深度整合社区服务
- 业主端APP体验优秀
- 智能设备集成能力强
- 社区运营工具丰富

**适用场景**: 住宅物业，社区运营

#### 2.1.4 龙湖U享家

**产品定位**: 智慧生活服务平台

**核心特点**:
- 业主服务体验优先
- 社区增值服务丰富
- 智能家居生态整合
- 线上线下服务融合

**适用场景**: 高端住宅物业，社区增值服务

### 2.2 商业物业 vs 住宅物业核心差异

| 维度 | 商业物业 | 住宅物业 |
|-----|---------|---------|
| **核心客户** | 企业租户、商户 | 业主、住户 |
| **收费模式** | 租金+物业费+能耗费+停车费 | 物业费+停车费+增值服务费 |
| **服务重点** | 商务服务、设施运维、招商租赁 | 社区服务、便民服务、安全防范 |
| **管理重点** | 租户管理、合同管理、能耗管理 | 业主服务、社区运营、公共设施 |
| **收入来源** | 租金收入为主，服务收入为辅 | 物业费为主，增值服务为辅 |
| **决策主体** | 企业租户（B端决策） | 业主个人/业委会（C端决策） |

### 2.3 行业发展趋势

#### 2.3.1 数字化转型

- **全流程在线**: 从报修到缴费，从访客到巡检，全流程数字化
- **无纸化办公**: 电子合同、电子发票、电子签章
- **数据资产化**: 建立数据中台，实现数据驱动决策

#### 2.3.2 移动化办公

- **移动端优先**: 物业人员移动办公，业主移动服务
- **扫码应用**: 设备扫码、巡检扫码、访客扫码
- **即时通讯**: 工单即时推送，消息实时触达

#### 2.3.3 智能化运营

- **AI应用**: 智能客服、智能派单、智能预警
- **IoT集成**: 门禁、停车、能耗、安防设备接入
- **数据分析**: 经营分析、服务分析、设备分析

#### 2.3.4 服务生态化

- **增值服务**: 社区团购、家政服务、房屋租售
- **生态合作**: 与第三方服务商合作，构建服务生态
- **平台化运营**: 从管理工具向服务平台转型

---

## 三、功能模块清单

### 3.1 模块总览

```
┌─────────────────────────────────────────────────────────────┐
│                    Ether 智慧物业管理平台                     │
├─────────────────────────────────────────────────────────────┤
│  M01 空间与资产管理    M02 设施设备管理    M03 运营调度       │
│  M04 巡检管理         M05 访客管理        M06 财务计费       │
│  M07 权限与账户       M08 业主端应用      M09 报表统计       │
│  M10 第三方集成                                                  │
└─────────────────────────────────────────────────────────────┘
```

### 3.2 详细功能清单

#### M01 空间与资产管理

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M01-01 | 项目管理 | 多项目管理，项目基本信息、配置参数 | P0 | 通用 | ✅ 已完成 |
| M01-02 | 空间节点管理 | 楼栋、楼层、房间层级管理 | P0 | 通用 | ✅ 已完成 |
| M01-03 | 房间详情管理 | 房间面积、户型、装修状态等 | P0 | 通用 | ✅ 已完成 |
| M01-04 | 产权信息管理 | 业主信息、产权比例、联系方式 | P0 | 住宅 | ✅ 已完成 |
| M01-05 | 租户管理 | 租户信息、租赁合同、到期提醒 | P1 | 商业 | ⏳ 待开发 |
| M01-06 | 招商租赁管理 | 招商线索、合同签约、租金管理 | P1 | 商业 | ⏳ 待开发 |
| M01-07 | 车位管理 | 车位信息、车位租赁、车位出售 | P1 | 通用 | ⏳ 待开发 |
| M01-08 | 资产台账 | 公共资产登记、折旧管理 | P2 | 通用 | ⏳ 待开发 |

#### M02 设施设备管理

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M02-01 | 设备台账 | 设备基本信息、技术参数、位置信息 | P0 | 通用 | ✅ 已完成 |
| M02-02 | 设备分类 | 设备分类管理，支持自定义分类 | P0 | 通用 | ✅ 已完成 |
| M02-03 | 设备二维码 | 设备二维码生成、扫码查看 | P1 | 通用 | ⏳ 待开发 |
| M02-04 | 维保计划 | 设备维保计划制定、周期设置 | P1 | 通用 | ⏳ 待开发 |
| M02-05 | 维保工单 | 维保任务生成、执行、记录 | P1 | 通用 | ⏳ 待开发 |
| M02-06 | 维修工单 | 设备故障报修、维修记录 | P0 | 通用 | ✅ 已完成 |
| M02-07 | 设备故障自动工单 | 设备故障自动创建维修工单 | P1 | 通用 | ✅ 已完成 |
| M02-08 | 备品备件管理 | 备件库存、领用、盘点 | P2 | 通用 | ✅ 已完成 |
| M02-09 | 能耗监测 | 能耗数据采集、分析、预警 | P2 | 商业 | ⏳ 待开发 |
| M02-10 | 设备批量导入 | Excel批量导入设备 | P1 | 通用 | ⏳ 待开发 |
| M02-11 | 设备手册电子化 | 设备说明书、维修手册电子化存储 | P2 | 通用 | ⏳ 延后开发 |
| M02-12 | 设备保险管理 | 设备保险信息、到期提醒 | P2 | 通用 | ⏳ 延后开发 |

#### M03 运营调度

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M03-01 | 工单创建 | 多渠道工单创建（业主报修、内部发起、巡检异常） | P0 | 通用 | ✅ 已完成 |
| M03-02 | 工单分配 | 手动分配、自动分配、抢单模式 | P0 | 通用 | ✅ 已完成 |
| M03-03 | 工单处理 | 接单、开始、完成、关闭全流程 | P0 | 通用 | ✅ 已完成 |
| M03-04 | 工单统计 | 多维度统计分析、趋势分析 | P1 | 通用 | ✅ 已完成 |
| M03-05 | 工单关联设备 | 工单关联设备信息、维修历史 | P1 | 通用 | ⏳ 待开发 |
| M03-06 | SLA监控 | 服务时效监控、超时预警 | P1 | 通用 | ⏳ 待开发 |
| M03-07 | 满意度评价 | 工单完成后业主评价 | P1 | 通用 | ⏳ 待开发 |
| M03-08 | 智能派单 | 基于位置、技能、工作量的智能派单 | P2 | 通用 | ⏳ 待开发 |

#### M04 巡检管理

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M04-01 | 巡检计划 | 巡检计划制定、周期设置、巡检路线 | P0 | 通用 | ✅ 已完成 |
| M04-02 | 巡检任务 | 巡检任务生成、分配、执行 | P0 | 通用 | ✅ 已完成 |
| M04-03 | 巡检记录 | 巡检结果记录、照片上传、异常标记 | P0 | 通用 | ✅ 已完成 |
| M04-04 | 异常自动工单 | 巡检异常自动创建工单 | P1 | 通用 | ✅ 已完成 |
| M04-05 | 巡检提醒 | 巡检任务提醒、逾期告警 | P1 | 通用 | ✅ 已完成 |
| M04-06 | 巡检统计 | 巡检完成率、异常率统计 | P1 | 通用 | ⏳ 待开发 |

#### M05 访客管理

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M05-01 | 访客预约 | 访客在线预约、被访人确认 | P0 | 通用 | ✅ 已完成 |
| M05-02 | 访客登记 | 访客现场登记、身份核验 | P0 | 通用 | ✅ 已完成 |
| M05-03 | 访客凭证 | 访客二维码生成、验证、通行 | P0 | 通用 | ✅ 已完成 |
| M05-04 | 访客黑名单 | 黑名单管理、黑名单拦截 | P1 | 通用 | ⏳ 待开发 |
| M05-05 | 通行记录 | 访客进出记录、轨迹查询 | P1 | 通用 | ⏳ 待开发 |
| M05-06 | 门禁集成 | 访客二维码下发到门禁系统 | P2 | 通用 | ⏳ 待开发 |

#### M06 财务计费

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M06-01 | 收费项目 | 收费项目管理、收费标准设置 | P0 | 通用 | ✅ 已完成 |
| M06-02 | 账单生成 | 自动生成账单、手动生成账单 | P0 | 通用 | ✅ 已完成 |
| M06-03 | 账单查询 | 账单列表、账单详情、历史账单 | P0 | 通用 | ✅ 已完成 |
| M06-04 | 缴费记录 | 缴费记录查询、缴费凭证 | P0 | 通用 | ✅ 已完成 |
| M06-05 | 费用催缴 | 逾期提醒、催缴通知 | P1 | 通用 | ✅ 已完成 |
| M06-06 | 在线支付 | 微信支付、支付宝支付 | P0 | 通用 | ⏳ 待开发 |
| M06-07 | 费用报表 | 收入统计、欠费统计、收费率分析 | P1 | 通用 | ⏳ 待开发 |
| M06-08 | 预存款管理 | 业主预存款、自动扣费 | P2 | 通用 | ⏳ 待开发 |
| M06-09 | 发票管理 | 电子发票开具、发票查询 | P2 | 通用 | ⏳ 待开发 |
| M06-10 | 押金管理 | 押金收取、退还、扣款 | P2 | 商业 | ⏳ 待开发 |

#### M07 权限与账户

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M07-01 | 用户管理 | 用户CRUD、用户状态管理 | P0 | 通用 | ✅ 已完成 |
| M07-02 | 角色管理 | 角色CRUD、角色权限分配 | P0 | 通用 | ✅ 已完成 |
| M07-03 | 权限管理 | 权限CRUD、菜单/按钮/API权限 | P0 | 通用 | ✅ 已完成 |
| M07-04 | 项目隔离 | 多项目数据隔离、项目切换 | P0 | 通用 | ✅ 已完成 |
| M07-05 | 操作日志 | 操作日志记录、查询、审计 | P0 | 通用 | ✅ 已完成 |
| M07-06 | 登录认证 | 登录、登出、Token刷新 | P0 | 通用 | ✅ 已完成 |
| M07-07 | 密码管理 | 密码修改、密码重置、密码策略 | P0 | 通用 | ✅ 已完成 |
| M07-08 | 数据权限 | 数据范围控制（全部/部门/本人） | P1 | 通用 | ✅ 已完成 |

#### M08 业主端应用

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M08-01 | 业主登录 | 手机号登录、微信登录 | P0 | 通用 | ⏳ 待开发 |
| M08-02 | 首页展示 | 待缴费、待处理工单、通知公告 | P0 | 通用 | ⏳ 待开发 |
| M08-03 | 在线报修 | 提交报修工单、查看进度 | P0 | 通用 | ⏳ 待开发 |
| M08-04 | 费用查询 | 账单查询、缴费记录 | P0 | 通用 | ⏳ 待开发 |
| M08-05 | 在线缴费 | 微信/支付宝缴费 | P0 | 通用 | ⏳ 待开发 |
| M08-06 | 访客邀请 | 邀请访客、生成访客二维码 | P1 | 通用 | ⏳ 待开发 |
| M08-07 | 通知公告 | 接收物业通知、公告 | P1 | 通用 | ⏳ 待开发 |
| M08-08 | 投诉建议 | 提交投诉建议、查看处理进度 | P1 | 通用 | ⏳ 待开发 |
| M08-09 | 社区服务 | 社区活动、便民服务 | P2 | 住宅 | ⏳ 待开发 |
| M08-10 | 个人中心 | 个人信息、房屋绑定、家庭成员 | P1 | 通用 | ⏳ 待开发 |

#### M09 报表统计

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M09-01 | 工单报表 | 工单数量、类型、时效、满意度统计 | P1 | 通用 | ⏳ 待开发 |
| M09-02 | 财务报表 | 收入统计、欠费统计、收费率分析 | P1 | 通用 | ⏳ 待开发 |
| M09-03 | 设备报表 | 设备故障率、维保完成率统计 | P2 | 通用 | ⏳ 待开发 |
| M09-04 | 巡检报表 | 巡检完成率、异常率统计 | P2 | 通用 | ⏳ 待开发 |
| M09-05 | 访客报表 | 访客数量、通行记录统计 | P2 | 通用 | ⏳ 待开发 |
| M09-06 | 经营报表 | 租金收入、空置率统计（商业） | P2 | 商业 | ⏳ 待开发 |
| M09-07 | 数据导出 | 报表数据导出Excel/PDF | P1 | 通用 | ⏳ 待开发 |
| M09-08 | 运营大屏 | 综合运营数据可视化大屏 | P2 | 通用 | ⏳ 待开发 |

#### M10 第三方集成

| 编号 | 功能名称 | 功能描述 | 优先级 | 适用场景 | 实现状态 |
|-----|---------|---------|-------|---------|---------|
| M10-01 | 消息推送 | 极光推送、个推等推送服务 | P1 | 通用 | ⏳ 待开发 |
| M10-02 | 短信通知 | 阿里云短信、腾讯云短信 | P1 | 通用 | ⏳ 待开发 |
| M10-03 | 邮件通知 | SMTP邮件发送 | P2 | 通用 | ⏳ 待开发 |
| M10-04 | 门禁系统 | 门禁设备对接、通行记录同步 | P2 | 通用 | ⏳ 待开发 |
| M10-05 | 停车系统 | 车牌识别、车位状态同步 | P2 | 通用 | ⏳ 待开发 |
| M10-06 | IoT传感器 | MQTT消息监听、设备数据采集 | P2 | 通用 | ⏳ 待开发 |
| M10-07 | 支付集成 | 微信支付、支付宝支付 | P0 | 通用 | ⏳ 待开发 |
| M10-08 | 政府监管接口 | 住建部门数据上报接口 | P3 | 通用 | ⏳ 待开发 |

---

### 3.3 详细功能需求

#### 3.3.1 系统管理模块 (M07)

##### M07-01 用户管理

**功能编号**: FUNC-SYS-001

**功能概述**: 用户管理是系统的基础功能，支持用户账号的全生命周期管理。

**核心功能**:
- 用户账号的增删改查
- 用户状态管理（启用/禁用）
- 密码重置
- 用户角色分配

**数据校验规则**:

| 字段 | 校验规则 | 错误提示 |
|------|----------|----------|
| username | 必填，唯一，4-20字符，仅支持字母数字下划线 | 用户名已存在或格式错误 |
| realName | 必填，最大50字符 | 请输入真实姓名 |
| phone | 手机号格式（11位数字） | 手机号格式错误 |
| email | 邮箱格式（可选） | 邮箱格式错误 |
| password | 必填，8-20字符，包含大小写字母和数字 | 密码格式错误 |

**密码安全策略**:
- 加密方式: MD5 + Salt 双重加密
- 默认重置密码: Admin@123
- 密码修改需验证原密码

**状态管理**:
- 启用(1): 正常使用
- 禁用(0): 禁止登录，保留数据

---

##### M07-02 角色管理

**功能编号**: FUNC-SYS-002

**功能概述**: 角色管理支持角色的创建、编辑、删除和权限分配。

**核心功能**:
- 角色CRUD操作
- 角色权限分配（菜单权限、按钮权限、API权限）
- 角色状态管理

**角色类型**:
- 系统级角色: `project_id = NULL`，管理所有项目
- 项目级角色: `project_id = 具体项目ID`，仅管理指定项目

---

##### M07-03 权限管理 (RBAC)

**功能编号**: FUNC-SYS-003

**功能概述**: 实现基于RBAC（Role-Based Access Control）的权限管理系统。

**权限分层设计**:
- **系统级权限**: 用户管理、角色管理、系统设置等，超级管理员专属
- **项目级权限**: 工单管理、业主管理、设备管理等，按项目隔离

**权限模型**:
```
用户 ──M:N──> 角色 ──M:N──> 权限
  │              │
  │              └── 项目隔离 (project_id)
  │
  └── 数据权限 (全部/本部门/本人)
```

**权限类型**:
| 权限类型 | 说明 | 示例 |
|----------|------|------|
| 菜单权限 | 控制菜单显示 | 工单管理菜单 |
| 按钮权限 | 控制按钮显示 | 新增、编辑、删除按钮 |
| API权限 | 控制接口访问 | POST /api/v1/ops/work-orders |

**数据权限**:
| 数据范围 | 说明 | 适用角色 |
|----------|------|----------|
| 全部数据 | 查看所有项目数据 | 超级管理员、物业经理 |
| 本部门数据 | 查看所属部门数据 | 部门主管 |
| 本人数据 | 仅查看自己的数据 | 普通员工 |

---

##### M07-04 系统初始化向导

**功能编号**: FUNC-SYS-005

**功能概述**: 系统初始化向导用于首次部署系统时，引导超级管理员完成基础配置。

**进入条件**: `isSuperAdmin = true && projectCount = 0`

**向导步骤**:

| 步骤 | 内容 | 必填 |
|------|------|------|
| 1 | 创建第一个物业项目（小区） | 是 |
| 2 | 配置物业公司信息 | 是 |
| 3 | 设置项目负责人 | 是 |
| 4 | 创建项目角色 | 否（可跳过） |

**跳过条件**: `projectCount > 0` 时自动跳过向导

**初始化数据**:
- 创建默认项目角色（项目经理、客服、维修员等）
- 创建默认权限组
- 关联当前用户为项目管理员

---

#### 3.3.2 主数据管理模块 (M01)

##### M01-01 项目管理

**功能编号**: FUNC-MDM-001

**功能概述**: 项目管理是物业系统的核心主数据，支持多项目管理。

**核心功能**:
- 项目基本信息管理（名称、地址、面积等）
- 项目状态管理（活跃/停用）
- 项目成员管理
- 项目统计数据（楼栋数、户数等）

**项目编码规则**: `PRJ + 年月 + 序号`（如 PRJ202602001）

**项目字段**:

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| projectCode | String | 是 | 项目编码，唯一 |
| projectName | String | 是 | 项目名称 |
| address | String | 是 | 项目地址 |
| totalArea | Decimal | 否 | 总面积（平方米） |
| status | Integer | 是 | 状态：1-活跃，0-停用 |
| buildDate | Date | 否 | 建成日期 |

**项目成员管理**:
- 添加/移除项目成员
- 分配项目角色
- 设置项目负责人

---

##### M01-02 空间节点管理

**功能编号**: FUNC-MDM-002

**功能概述**: 空间节点管理是物业项目的核心主数据，用于管理项目内的空间层级结构。

**空间层级结构**:
```
项目 (Project) ───────────────────────────────── Level 0
├── 楼栋 (BUILDING) ──────────────────────────── Level 1
│   ├── 单元 (UNIT) ──────────────────────────── Level 2
│   │   ├── 楼层 (FLOOR) ─────────────────────── Level 3 (可选)
│   │   │   └── 房间 (ROOM) ──────────────────── Level 4
│   │   └── 房间 (ROOM) ──────────────────────── Level 3
│   └── 公共区域 (AREA) ──────────────────────── Level 2
├── 车库 (GARAGE) ────────────────────────────── Level 1
│   └── 车位 (PARKING) ───────────────────────── Level 2
└── 公共区域 (AREA) ──────────────────────────── Level 1
```

**核心功能**:
- 空间节点的增删改查
- 树形结构可视化展示
- Excel批量导入
- 自动编码规则

**节点类型**:

| 节点类型 | 编码 | 说明 |
|----------|------|------|
| 楼栋 | BUILDING | 建筑物 |
| 单元 | UNIT | 单元/单元门 |
| 楼层 | FLOOR | 楼层（可选） |
| 房间 | ROOM | 住宅/商铺/办公 |
| 车库 | GARAGE | 停车场 |
| 车位 | PARKING | 停车位 |
| 公共区域 | AREA | 公共设施区域 |

**自动编码规则**:
- 楼栋: `B + 序号`（如 B1, B2）
- 单元: `楼栋编码 + U + 序号`（如 B1U1）
- 房间: `单元编码 + 房间号`（如 B1U1-101）

**批量导入支持**:
- Excel模板下载
- 数据校验
- 错误提示
- 导入结果反馈

---

##### M01-03 业主管理

**功能编号**: FUNC-MDM-003

**功能概述**: 业主管理支持业主信息管理和房产关联。

**核心功能**:
- 业主基本信息管理
- 房产关联管理
- 家庭成员管理
- 业主端房产绑定

**数据模型**:

| 实体 | 表名 | 说明 |
|------|------|------|
| Owner | mdm_owner | 业主基本信息 |
| Ownership | mdm_ownership | 房产关联关系 |
| FamilyMember | mdm_family_member | 家庭成员 |

**业主字段**:

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| name | String | 是 | 业主姓名 |
| phone | String | 是 | 联系电话 |
| idCard | String | 否 | 身份证号 |
| status | Integer | 是 | 状态：1-正常，0-禁用 |

**房产关联**:
- 支持多房产业主
- 支持多业主房产
- 产权比例管理

---

## 四、角色权限矩阵

### 4.1 角色定义（13个角色）

#### 4.1.1 系统管理层（2个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| SUPER_ADMIN | 超级管理员 | ALL | 全终端 | 系统最高权限，管理所有项目和用户 |
| SYS_ADMIN | 系统管理员 | ALL | 管理后台 | 系统配置管理，不参与业务操作 |

#### 4.1.2 项目管理层（2个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| PROPERTY_MANAGER | 物业经理 | PROJECT | 全终端 | 多项目运营管理，收费审核，绩效查看 |
| PROJECT_MANAGER | 项目经理 | PROJECT | 全终端 | 单项目管理，收费审核，合同审批 |

#### 4.1.3 部门主管层（4个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| ENGINEERING_LEAD | 工程主管 | DEPARTMENT | 全终端 | 工程部管理，工单指派，巡检计划制定 |
| SECURITY_LEAD | 安保主管 | DEPARTMENT | 全终端 | 安保部管理，安保巡检监督，访客管理 |
| CLEANING_LEAD | 保洁主管 | DEPARTMENT | 全终端 | 保洁部管理，保洁巡检监督，品质检查 |
| FINANCE_LEAD | 财务主管 | DEPARTMENT | 全终端 | 财务部管理，收费管理，账单审核 |

#### 4.1.4 一线执行层（3个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| MAINTENANCE_STAFF | 维修人员 | SELF | 移动端优先 | 工单接单、维修执行、设备巡检 |
| SECURITY_STAFF | 安保人员 | SELF | 移动端优先 | 安保巡检、访客核验、异常报送 |
| CLEANING_STAFF | 保洁人员 | SELF | 移动端优先 | 保洁执行、品质检查、异常报送 |

#### 4.1.5 服务支持层（1个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| CS_STAFF | 客服人员 | PROJECT | 全终端 | 业主服务、访客核验、收费查询 |

#### 4.1.6 外部用户层（1个角色）

| 角色编码 | 角色名称 | 数据范围 | 终端类型 | 职责说明 |
|---------|---------|---------|---------|---------|
| OWNER | 业主 | SELF | 业主端APP | 房屋产权人，查看账单、报修、评价 |

### 4.2 角色职责说明

#### 4.2.1 系统级角色

| 角色 | 职责范围 | 典型场景 |
|------|---------|---------|
| **超级管理员** | 系统最高权限，管理所有项目和用户 | 系统初始化、用户创建、项目创建 |
| **系统管理员** | 系统配置管理，不参与业务操作 | 系统参数配置、日志查看 |

#### 4.2.2 项目管理角色

| 角色 | 职责范围 | 典型场景 |
|------|---------|---------|
| **物业经理** | 项目经营第一负责人，拥有本项目全部权限 | 项目整体运营、费用审核、合同审批 |
| **项目经理** | 单项目管理，拥有本项目全部业务权限 | 工单管理、人员分配、报表查看 |

#### 4.2.3 部门主管角色

| 角色 | 管理模块 | 职责范围 | 典型场景 |
|------|---------|---------|---------|
| **工程主管** | 工单、设备、工程巡检 | 本部门工程事务管理 | 工单分配、设备管理、巡检计划制定 |
| **安保主管** | 安保巡检、访客管理 | 本部门安保事务管理 | 安保巡检计划、访客核验监督 |
| **保洁主管** | 保洁巡检、品质检查 | 本部门保洁事务管理 | 保洁巡检计划、品质检查 |
| **财务主管** | 账单、收费、费用审核 | 本部门财务事务管理 | 账单生成、费用审核、报表导出 |

#### 4.2.4 一线执行角色

| 角色 | 执行内容 | 典型场景 |
|------|---------|---------|
| **维修人员** | 工单接单、维修执行、设备巡检 | 接单、维修、扫码巡检、完工反馈 |
| **安保人员** | 安保巡检、访客核验、异常报送 | 扫码签到、访客登记、访客放行 |
| **保洁人员** | 保洁执行、品质检查、异常报送 | 保洁执行、品质检查、异常上报 |

#### 4.2.5 服务支持角色

| 角色 | 服务内容 | 典型场景 |
|------|---------|---------|
| **客服人员** | 业主服务、访客核验、收费查询 | 业主咨询、访客核验、账单查询 |

#### 4.2.6 外部用户角色

| 角色 | 使用场景 | 典型场景 |
|------|---------|---------|
| **业主** | 业主端APP | 在线报修、在线缴费、访客邀请、服务评价 |

### 4.3 功能权限矩阵

| 功能模块 | 超级管理员 | 物业经理 | 项目经理 | 工程主管 | 安保主管 | 保洁主管 | 财务主管 | 维修人员 | 安保人员 | 保洁人员 | 客服 | 业主 |
|---------|-----------|---------|---------|---------|---------|---------|---------|---------|---------|---------|-----|-----|
| **M01 空间与资产** |
| 项目管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 空间节点管理 | ✅ | ✅ | ✅ | 👁️ | 👁️ | 👁️ | 👁️ | ❌ | ❌ | ❌ | 👁️ | ❌ |
| 租户管理 | ✅ | ✅ | ✅ | 👁️ | ❌ | ❌ | 👁️ | ❌ | ❌ | ❌ | 👁️ | ❌ |
| 车位管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | 👁️ | 👁️ |
| **M02 设施设备** |
| 设备台账 | ✅ | ✅ | ✅ | ✅ | 👁️ | 👁️ | ❌ | ✅ | ❌ | ❌ | 👁️ | ❌ |
| 维保计划 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 维修工单 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | 👁️ |
| **M03 运营调度** |
| 工单创建 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ✅ |
| 工单分配 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
| 工单处理 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 工单统计 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | 👁️ | ❌ | ❌ | ✅ | ❌ |
| **M04 巡检管理** |
| 巡检计划 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 巡检执行 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
| 巡检记录 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | 👁️ | 👁️ | 👁️ | 👁️ | ❌ |
| **M05 访客管理** |
| 访客预约 | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
| 访客登记 | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ |
| 访客凭证 | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
| **M06 财务计费** |
| 账单管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | 👁️ | 👁️ |
| 缴费管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | 👁️ | ✅ |
| 费用报表 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **M07 权限与账户** |
| 用户管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 角色管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 权限管理 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **M08 业主端应用** |
| 在线报修 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| 在线缴费 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| 访客邀请 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| **M09 报表统计** |
| 工单报表 | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | 👁️ | ❌ |
| 财务报表 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 运营大屏 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |

**图例说明**:
- ✅ 完全权限（增删改查）
- 👁️ 只读权限（仅查看）
- ❌ 无权限

### 4.4 按钮级权限矩阵

#### 4.4.1 工单操作按钮权限

| 动作按钮 | 维修人员 | 工程主管 | 客服人员 | 项目经理 |
|:--- | :---: | :---: | :---: | :---: |
| **新增工单** | √ (自发现) | √ | √ (受理报修) | √ |
| **指派/转单** | - | √ | √ | √ |
| **接单** | √ | - | - | - |
| **开始处理** | √ | - | - | - |
| **完工反馈** | √ | - | - | - |
| **费用填报** | √ | √ | - | - |
| **费用审核** | - | √ | - | √ |
| **质量审核** | - | √ | - | √ |
| **评价** | - | - | - | √ |
| **关闭** | - | - | - | √ |
| **删除/作废** | - | - | - | √ |

#### 4.4.2 巡检操作按钮权限

| 动作按钮 | 安保人员 | 保洁人员 | 安保主管 | 保洁主管 | 项目经理 |
|:--- | :---: | :---: | :---: | :---: | :---: |
| **开始巡检** | √ | √ | - | - | - |
| **扫码签到** | √ | √ | - | - | - |
| **异常上报** | √ | √ | - | - | - |
| **完成巡检** | √ | √ | - | - | - |
| **制定计划** | - | - | √ | √ | √ |
| **指派任务** | - | - | √ | √ | √ |
| **查看统计** | - | - | √ | √ | √ |
| **强制闭环** | - | - | √ | √ | √ |

#### 4.4.3 设备管理按钮权限

| 动作按钮 | 维修人员 | 工程主管 | 项目经理 |
|:--- | :---: | :---: | :---: |
| **查看设备** | √ | √ | √ |
| **扫码巡检** | √ | - | - |
| **维护记录** | √ | √ | √ |
| **编辑设备** | - | √ | √ |
| **新增设备** | - | √ | √ |
| **删除设备** | - | - | √ |

#### 4.4.4 访客管理按钮权限

| 动作按钮 | 安保人员 | 客服人员 | 安保主管 | 项目经理 |
|:--- | :---: | :---: | :---: | :---: |
| **访客登记** | √ | √ | - | - |
| **访客核验** | √ | √ | - | - |
| **访客放行** | √ | - | - | - |
| **查看记录** | √ | √ | √ | √ |
| **导出记录** | - | - | √ | √ |

#### 4.4.5 财务收费按钮权限

| 动作按钮 | 财务主管 | 客服人员 | 项目经理 | 业主 |
|:--- | :---: | :---: | :---: | :---: |
| **查看账单** | √ | √ | √ | √ |
| **生成账单** | √ | - | - | - |
| **调整账单** | √ | - | √ | - |
| **收费登记** | √ | - | - | - |
| **在线缴费** | - | - | - | √ |
| **收费审核** | - | - | √ | - |
| **减免审批** | - | - | √ | - |
| **导出报表** | √ | - | √ | - |

### 4.5 数据权限范围

| 数据范围 | 说明 | 适用角色 |
|---------|-----|---------|
| ALL | 所有项目数据 | 超级管理员、系统管理员 |
| PROJECT | 本项目数据 | 物业经理、项目经理、客服人员 |
| DEPARTMENT | 本部门数据 | 工程主管、安保主管、保洁主管、财务主管 |
| SELF | 仅本人数据 | 维修人员、安保人员、保洁人员、业主 |

### 4.6 状态驱动权限

工单状态与可执行操作的映射关系：

| 工单状态 | 可执行操作 |
|---------|-----------|
| CREATED（已创建） | 分配、编辑、删除 |
| ASSIGNED（已分配） | 接单、转单、挂起、退回 |
| ACCEPTED（已接单） | 开始处理、转单、挂起 |
| IN_PROGRESS（处理中） | 完成、填报费用、挂起 |
| PENDING（待确认） | 完成、质量审核 |
| COMPLETED（已完成） | 评价、关闭、费用审核 |
| CLOSED（已关闭） | 无 |
| SUSPENDED（已挂起） | 恢复 |
| RETURNED（已退回） | 分配、删除 |

---

## 五、核心业务流程

### 5.1 客户服务流程（报修）

```
┌─────────────────────────────────────────────────────────────────────────┐
│                          客户服务流程（报修）                             │
└─────────────────────────────────────────────────────────────────────────┘

业主端                          管理端                         维修端
  │                              │                              │
  │  1. 提交报修申请              │                              │
  │─────────────────────────────>│                              │
  │  (故障描述、照片、位置)        │                              │
  │                              │                              │
  │                              │  2. 工单创建                  │
  │                              │  (自动创建工单)               │
  │                              │                              │
  │                              │  3. 工单分配                  │
  │                              │  (手动/自动分配)              │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │  4. 接单确认                  │
  │                              │<─────────────────────────────│
  │                              │                              │
  │                              │  5. 开始处理                  │
  │                              │<─────────────────────────────│
  │                              │                              │
  │                              │  6. 完成维修                  │
  │                              │<─────────────────────────────│
  │                              │  (维修记录、照片)             │
  │                              │                              │
  │  7. 完成通知                  │                              │
  │<─────────────────────────────│                              │
  │                              │                              │
  │  8. 满意度评价                │                              │
  │─────────────────────────────>│                              │
  │                              │                              │
  │                              │  9. 工单关闭                  │
  │                              │                              │
```

**流程说明**:

1. **工单创建**: 业主通过APP或小程序提交报修申请，系统自动创建工单
2. **工单分配**: 
   - 手动分配：客服人员手动分配给维修人员
   - 自动分配：根据工单类型、维修人员技能、当前位置自动分配
3. **接单确认**: 维修人员接单确认，系统发送通知给业主
4. **开始处理**: 维修人员到达现场开始处理
5. **完成维修**: 维修人员提交维修记录和照片
6. **完成通知**: 系统自动发送完成通知给业主
7. **满意度评价**: 业主对服务进行评价（1-5分）
8. **工单关闭**: 系统自动关闭工单或管理员手动关闭

**状态流转**:
```
CREATED → ASSIGNED → ACCEPTED → IN_PROGRESS → COMPLETED → CLOSED
```

### 5.2 财务收费流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                            财务收费流程                                  │
└─────────────────────────────────────────────────────────────────────────┘

系统                            财务端                         业主端
  │                              │                              │
  │  1. 定期生成账单              │                              │
  │  (每月1日自动生成)            │                              │
  │                              │                              │
  │  2. 账单推送                  │                              │
  │─────────────────────────────>│                              │
  │                              │  3. 发送账单通知              │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │                              │  4. 查看账单
  │                              │                              │
  │                              │                              │  5. 在线缴费
  │                              │                              │  (微信/支付宝)
  │                              │                              │
  │  6. 支付回调                  │                              │
  │<────────────────────────────────────────────────────────── │
  │                              │                              │
  │  7. 更新缴费状态              │                              │
  │─────────────────────────────>│                              │
  │                              │                              │
  │                              │  8. 发送缴费成功通知          │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │  9. 开具电子发票              │
  │                              │─────────────────────────────>│
  │                              │                              │
```

**流程说明**:

1. **账单生成**: 系统根据收费项目和计费规则自动生成账单
2. **账单推送**: 账单生成后自动推送到财务端
3. **账单通知**: 发送账单通知给业主（APP推送、短信）
4. **在线缴费**: 业主通过APP在线缴费
5. **支付回调**: 支付平台回调通知支付结果
6. **状态更新**: 更新账单状态为已缴费
7. **缴费通知**: 发送缴费成功通知给业主
8. **发票开具**: 自动或手动开具电子发票

**催缴流程**:
```
即将到期(3天内) → 到期提醒 → 逾期提醒(每天) → 停止服务
```

### 5.3 设备管理流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                            设备管理流程                                  │
└─────────────────────────────────────────────────────────────────────────┘

设备台账                        维保计划                       维保执行
  │                              │                              │
  │  1. 设备登记                  │                              │
  │  (基本信息、技术参数)          │                              │
  │                              │                              │
  │  2. 制定维保计划              │                              │
  │─────────────────────────────>│                              │
  │  (周期、内容、负责人)          │                              │
  │                              │                              │
  │                              │  3. 生成维保任务              │
  │                              │─────────────────────────────>│
  │                              │  (按计划自动生成)             │
  │                              │                              │
  │                              │  4. 维保提醒                  │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │                              │  5. 执行维保
  │                              │                              │  (记录、照片)
  │                              │                              │
  │                              │  6. 维保完成                  │
  │                              │<─────────────────────────────│
  │                              │                              │
  │  7. 更新设备状态              │                              │
  │<─────────────────────────────│                              │
  │                              │                              │
```

**设备故障处理流程**:
```
设备故障 → 自动创建维修工单 → 分配维修人员 → 维修处理 → 故障解除
```

### 5.4 巡检管理流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                            巡检管理流程                                  │
└─────────────────────────────────────────────────────────────────────────┘

巡检计划                        巡检任务                       巡检执行
  │                              │                              │
  │  1. 制定巡检计划              │                              │
  │  (巡检路线、周期、内容)        │                              │
  │                              │                              │
  │  2. 生成巡检任务              │                              │
  │─────────────────────────────>│                              │
  │                              │                              │
  │                              │  3. 任务分配                  │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │  4. 任务提醒                  │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │                              │  5. 执行巡检
  │                              │                              │  (扫码、记录)
  │                              │                              │
  │                              │                              │  6. 发现异常
  │                              │                              │  (拍照、描述)
  │                              │                              │
  │                              │  7. 提交巡检记录              │
  │                              │<─────────────────────────────│
  │                              │                              │
  │                              │  8. 异常自动创建工单          │
  │                              │──────────────────────────────>│ 维修工单
  │                              │                              │
```

**巡检异常处理**:
```
发现异常 → 自动创建工单 → 分配处理 → 异常解除 → 巡检完成
```

### 5.5 访客管理流程

```
┌─────────────────────────────────────────────────────────────────────────┐
│                            访客管理流程                                  │
└─────────────────────────────────────────────────────────────────────────┘

访客                            业主                          物业
  │                              │                              │
  │  1. 访客预约                  │                              │
  │─────────────────────────────>│                              │
  │  (填写访问信息)                │                              │
  │                              │                              │
  │                              │  2. 业主确认                  │
  │                              │  (同意/拒绝)                  │
  │                              │                              │
  │  3. 预约结果通知              │                              │
  │<─────────────────────────────│                              │
  │                              │                              │
  │                              │  4. 生成访客凭证              │
  │                              │─────────────────────────────>│
  │                              │  (二维码)                     │
  │                              │                              │
  │  5. 发送访客二维码            │                              │
  │<────────────────────────────────────────────────────────── │
  │                              │                              │
  │  6. 到访登记                  │                              │
  │─────────────────────────────────────────────────────────────>│
  │  (出示二维码、身份核验)        │                              │
  │                              │                              │
  │  7. 通行放行                  │                              │
  │<─────────────────────────────────────────────────────────────│
  │                              │                              │
  │  8. 离开登记                  │                              │
  │─────────────────────────────────────────────────────────────>│
  │                              │                              │
```

**访客凭证验证流程**:
```
出示二维码 → 扫码验证 → 身份核验 → 黑名单检查 → 通行放行
```

### 5.6 合同管理流程（商业物业）

```
┌─────────────────────────────────────────────────────────────────────────┐
│                          合同管理流程（商业物业）                         │
└─────────────────────────────────────────────────────────────────────────┘

招商线索                        合同签约                       合同执行
  │                              │                              │
  │  1. 招商线索录入              │                              │
  │  (客户信息、需求)              │                              │
  │                              │                              │
  │  2. 线索跟进                  │                              │
  │  (沟通记录、意向)              │                              │
  │                              │                              │
  │  3. 签约意向                  │                              │
  │─────────────────────────────>│                              │
  │                              │                              │
  │                              │  4. 合同起草                  │
  │                              │  (租金、押金、期限)           │
  │                              │                              │
  │                              │  5. 合同审批                  │
  │                              │  (多级审批)                   │
  │                              │                              │
  │                              │  6. 合同签署                  │
  │                              │  (电子签章)                   │
  │                              │                              │
  │                              │  7. 合同生效                  │
  │                              │─────────────────────────────>│
  │                              │                              │
  │                              │                              │  8. 租金收取
  │                              │                              │  (按月/季度)
  │                              │                              │
  │                              │  9. 合同到期提醒              │
  │                              │─────────────────────────────>│
  │                              │  (提前3个月)                  │
  │                              │                              │
  │                              │  10. 续约/退租                │
  │                              │<─────────────────────────────│
  │                              │                              │
```

---

## 六、非功能性需求

### 6.1 性能需求

| 指标 | 要求 | 说明 |
|-----|-----|-----|
| 响应时间 | < 2秒 | 页面加载、接口响应 |
| 并发用户 | 1000+ | 支持多项目同时在线 |
| 数据量 | 100万+ | 支持百万级数据存储 |
| 可用性 | 99.9% | 年度可用性目标 |

### 6.2 安全需求

| 安全项 | 要求 | 说明 |
|-------|-----|-----|
| 身份认证 | JWT Token | 支持多端登录 |
| 密码策略 | 复杂度要求 | 8位+大小写+数字+特殊字符 |
| 数据加密 | HTTPS + 敏感数据加密 | 传输加密、存储加密 |
| 操作审计 | 全量日志记录 | 操作日志、登录日志 |
| 数据隔离 | 项目级隔离 | 多租户数据隔离 |

### 6.3 可用性需求

| 可用性项 | 要求 | 说明 |
|---------|-----|-----|
| 浏览器兼容 | Chrome、Firefox、Safari、Edge | 主流浏览器支持 |
| 移动端适配 | 响应式设计 | 支持手机、平板访问 |
| 易用性 | 简洁直观 | 用户培训时间 < 2小时 |

### 6.4 可扩展性需求

| 扩展性项 | 要求 | 说明 |
|---------|-----|-----|
| 模块化 | 微服务架构 | 模块独立部署、扩展 |
| 接口开放 | RESTful API | 支持第三方系统集成 |
| 插件化 | 可插拔设计 | 支持功能扩展 |

---

## 七、与现有系统对比

### 7.1 已实现功能

| 模块 | 功能 | 完成度 | 说明 |
|-----|-----|-------|-----|
| **权限系统** | RBAC权限模型 | 100% | 角色、权限、用户管理完整 |
| **项目隔离** | 多项目数据隔离 | 100% | 支持多项目切换 |
| **工单系统** | 工单全流程 | 90% | 创建、分配、处理、统计 |
| **通知系统** | 消息通知 | 100% | 站内信、推送、模板 |
| **访客管理** | 访客预约、凭证 | 100% | 二维码生成、验证 |
| **巡检管理** | 巡检计划、任务 | 100% | 计划制定、任务执行 |
| **设备管理** | 设备台账 | 100% | 设备基本信息管理 |
| **财务收费** | 账单、催缴 | 90% | 账单生成、催缴通知 |

### 7.2 待开发功能

| 模块 | 功能 | 优先级 | 说明 |
|-----|-----|-------|-----|
| **业主端** | 小程序/APP | P0 | 业主服务入口 |
| **在线支付** | 微信/支付宝 | P0 | 在线缴费功能 |
| **商业物业** | 租户、招商、合同 | P1 | 商业物业核心功能 |
| **报表统计** | 各类报表 | P1 | 数据分析决策 |
| **第三方集成** | 门禁、停车、IoT | P2 | 系统集成能力 |

### 7.3 系统优势

1. **技术架构先进**: 微服务架构，易于扩展和维护
2. **权限体系完善**: RBAC模型，支持项目隔离和数据权限
3. **核心功能完备**: 工单、巡检、访客、财务等核心功能已实现
4. **代码质量高**: 测试覆盖率高，代码规范统一

### 7.4 系统不足

1. **业主端缺失**: 缺少业主服务入口，影响用户体验
2. **支付未集成**: 无法在线缴费，影响收费效率
3. **商业物业功能不足**: 缺少租户管理、招商租赁等功能
4. **报表功能薄弱**: 缺少数据分析和决策支持

---

## 八、开发优先级规划

### 8.1 第一阶段：核心功能完善（P0）

**目标**: 完善核心功能，实现业务闭环

| 序号 | 功能 | 工作量估算 | 说明 |
|-----|-----|-----------|-----|
| 1 | 业主端小程序/APP | 高 | 业主服务入口，核心功能 |
| 2 | 在线支付集成 | 中 | 微信支付、支付宝支付 |
| 3 | 工单关联设备完善 | 低 | 工单关联设备信息、维修历史 |
| 4 | 费用报表导出 | 低 | Excel导出功能 |

**预期成果**: 实现业主在线报修、在线缴费，完成核心业务闭环

### 8.2 第二阶段：运营效率提升（P1）

**目标**: 提升运营效率，优化用户体验

| 序号 | 功能 | 工作量估算 | 说明 |
|-----|-----|-----------|-----|
| 1 | 设备二维码 | 低 | 设备扫码查看、扫码报修 |
| 2 | 设备故障自动工单 | 低 | IoT设备故障自动创建工单 |
| 3 | SLA监控预警 | 中 | 服务时效监控、超时预警 |
| 4 | 工单满意度评价 | 低 | 业主评价功能 |
| 5 | 报表统计功能 | 高 | 工单、财务、设备报表 |

**预期成果**: 提升服务效率，建立数据分析能力

### 8.3 第三阶段：商业物业功能（P1-P2）

**目标**: 支持商业物业管理场景

| 序号 | 功能 | 工作量估算 | 说明 |
|-----|-----|-----------|-----|
| 1 | 租户管理 | 中 | 租户信息、租赁合同 |
| 2 | 招商租赁管理 | 高 | 招商线索、合同签约、租金管理 |
| 3 | 车位管理 | 中 | 车位信息、车位租赁 |

**预期成果**: 支持商业物业核心业务

### 8.4 第四阶段：系统集成（P2）

**目标**: 对接外部系统，实现智能化

| 序号 | 功能 | 工作量估算 | 说明 |
|-----|-----|-----------|-----|
| 1 | 通知渠道扩展 | 中 | 短信、邮件、推送 |
| 2 | 门禁系统集成 | 高 | 访客二维码下发、通行记录 |
| 3 | 停车系统集成 | 高 | 车牌识别、车位状态 |
| 4 | IoT传感器接入 | 高 | MQTT消息监听、设备数据 |
| 5 | 综合运营大屏 | 中 | 数据可视化大屏 |

**预期成果**: 实现智能化运营

### 8.5 第五阶段：智能化升级（P3）

**目标**: 引入AI能力，提升智能化水平

| 序号 | 功能 | 工作量估算 | 说明 |
|-----|-----|-----------|-----|
| 1 | 智能派单算法 | 高 | 基于位置、技能、工作量 |
| 2 | 审批流程引擎 | 高 | 自定义审批流程 |
| 3 | 能耗监测 | 中 | 能耗数据采集、分析 |
| 4 | 政府监管接口 | 中 | 住建部门数据上报 |

**预期成果**: 实现智能化决策支持

---

## 九、附录

### 9.1 术语表

| 术语 | 说明 |
|-----|-----|
| RBAC | Role-Based Access Control，基于角色的访问控制 |
| SLA | Service Level Agreement，服务等级协议 |
| IoT | Internet of Things，物联网 |
| JWT | JSON Web Token，JSON网络令牌 |
| API | Application Programming Interface，应用程序接口 |
| CRUD | Create, Read, Update, Delete，增删改查 |

### 9.2 参考文档

| 文档 | 说明 |
|-----|-----|
| [项目进度总览](../03-项目进度/PROJECT_PROGRESS.md) | 项目整体进度 |
| [需求澄清文档](../需求澄清文档.md) | 需求细节澄清 |
| [技术规范说明书](../02-设计文档/技术规范说明书.pdf) | 技术选型和规范 |
| [领域模型详细设计](../02-设计文档/领域模型详细设计.pdf) | 领域模型设计 |

### 9.3 文档修订记录

| 版本 | 日期 | 修订人 | 修订内容 |
|-----|-----|-------|---------|
| v1.0 | 2026-02-12 | - | 初始版本 |
| v1.1 | 2026-02-16 | - | 整合09目录需求内容：添加详细功能需求章节（3.3）|
| v2.0 | 2026-02-13 | - | 基于市场调研完善功能清单、角色权限、业务流程 |
| v3.0 | 2026-02-27 | - | 完善角色权限矩阵：13个角色体系、按钮级权限、状态驱动权限 |
| v3.1 | 2026-02-27 | - | 权限体系代码升级完成：后端API、前端三端、数据库迁移脚本、单元测试 |

---

**文档维护**: 本文档为产品需求的核心文档，需求变更时需同步更新。