# 医院物业SaaS管理后台 — 模块划分

> 技术栈：Java + Spring Boot + MariaDB
> 端侧：管理员后台（Web）+ 微信小程序（物业人员）
> 日期：2026-04-16
> 版本：v4.0

---

## 一、角色与账号体系

### 1.1 角色定义

| 角色 | 创建者 | 说明 | 端侧 |
|------|--------|------|------|
| **超级管理员** | 系统预置 | 平台方运营，管理账号、权限与系统配置，不涉及业务数据 | Web |
| **医院账号** | 超级管理员 | 查看为其服务的物业公司全部日常数据，独占合同管理+分段招标 | Web |
| **物业公司管理员** | 超级管理员 | 每个管理员账号绑定一家医院，管理该院下业务，创建下属账号 | Web+小程序 |
| **物业下属人员** | 物业公司管理员 | 按分配的自定义角色操作（主管/员工等），主要通过小程序使用 | 小程序为主 |

### 1.2 多租户关系模型

```
超级管理员（平台方）
    │
    ├── 创建医院信息（支持多院区）
    │     └── XX医院
    │           ├── 主院区
    │           ├── 东院区
    │           └── 南院区
    │
    ├── 创建医院账号（绑定医院，设有效期）
    │     └── 医院A账号 → 可查看为其服务的物业公司全部日常数据
    │
    └── 创建物业公司信息 + 物业公司管理员账号（绑定物业公司+医院，设有效期）
          └── XX物业公司
                ├── 管理员账号1（服务A医院）→ 管理A医院业务
                └── 管理员账号2（服务B医院）→ 管理B医院业务
```

**关键规则：**
- 一个物业公司服务多家医院时，每个医院对应一个独立的管理员账号
- 物业公司管理员登录后只看到绑定医院的数据，无需切换视图
- 医院账号可查看为其服务的物业公司的全部日常数据
- 合同管理、分段招标功能仅医院账号可用
- 超级管理员只管理账号、权限与系统配置，不查看业务数据

### 1.3 数据权限（行级隔离）

| 角色 | 数据范围 | 说明 |
|------|----------|------|
| 超级管理员 | 仅系统配置与账号数据 | 不涉及业务数据 |
| 医院账号 | 本医院+关联物业公司数据 | 仅查看，不可操作日常业务 |
| 物业公司管理员 | 本公司绑定的医院数据 | 可操作管理 |
| 主管 | 本班组数据 | 仅可查看/操作本班组的工单、人员、记录 |
| 员工 | 仅本人数据 | 只能查看自己的工单、任务、考勤 |

### 1.4 账号有效期与到期提醒机制

**适用范围：** 仅医院账号和物业公司管理员账号需要设置有效期，物业下属人员不单独设有效期（随物业公司账号到期而自动失效）。

**有效期设置：**
- 超级管理员创建医院/物业公司账号时，必须设置账号有效期
- 支持在账号管理页面修改有效期、手动续期

**到期提醒规则：**
- 超级管理员可在系统配置中设置到期提醒天数（如提前7天、15天、30天）
- 到期前到达提醒天数时，用户登录后弹出到期提醒弹窗
- 弹窗关闭后可正常登录使用，不影响功能
- 超级管理员后台可查看即将到期的账号列表

**过期后行为：**
- 账号过期后禁止登录
- 超级管理员可手动续期恢复

---

## 二、超级管理员 — 功能模块

> 超级管理员负责平台运营，管理账号、权限与系统配置，不查看业务数据。

### 2.1 账号管理

| 功能点 | 说明 |
|--------|------|
| 医院账号管理 | 创建/编辑/启停医院账号，设置有效期 |
| 物业公司账号管理 | 创建/编辑/启停物业公司管理员账号，设置有效期 |
| 医院信息管理 | 创建/编辑医院信息（含多院区） |
| 物业公司信息管理 | 创建/编辑物业公司信息 |
| 到期账号管理 | 查看即将到期/已过期账号列表，手动续期 |
| 账号有效期配置 | 配置到期提醒规则（提前N天提醒） |

### 2.2 权限管理

| 功能点 | 说明 |
|--------|------|
| 角色定义 | 四级权限树形勾选（功能菜单→页面→功能点→动作） |
| 权限自动同步 | 新增功能时自动注册到权限体系，权限管理页面自动渲染新可勾选项 |
| 权限预设模板 | 提供预设角色模板，创建角色时选择模板自动填充权限 |
| 账号角色绑定 | 为账号分配/移除角色 |
| 权限审计日志 | 记录所有权限变更操作（操作人、时间、类型、变更前后对比） |
| 权限实时生效 | 权限变更后通过Redis Pub/Sub毫秒级生效，无需重新登录 |

### 2.3 系统配置

| 功能点 | 说明 |
|--------|------|
| 系统版本管理 | 管理后台和小程序版本信息 |
| 缓存管理 | 手动清理缓存，查看缓存状态 |
| 到期提醒规则配置 | 配置账号到期提醒天数阈值 |

---

## 三、物业公司 — 功能模块

> 物业公司管理员负责绑定医院的日常业务管理，可创建下属人员账号并分配角色。

### 3.1 在线报修（repair）

**Web端：**
- 工单列表、工单详情、工单分配、工单流转
- 延期审批、协助维修管理
- 报修类型管理、数据补录、报修统计

**小程序端：**
- 扫码注册、一键报修、我的工单、催单
- 维修接单/完工、延期申请/审批
- 协助申请、工单分配（主管）、工单验收、评价

### 3.2 巡检管理（inspection）

**Web端：**
- 巡检计划管理、任务看板、记录查询
- 异常跟踪、区域管理、数据补录、补录审核

**小程序端：**
- 今日巡检、蓝牙强制打卡（必须连接才可打卡和拍照）
- 巡检执行、异常上报、异常数据补录

### 3.3 保洁管理（cleaning）

**Web端：**
- 区域管理（五级架构）、任务看板、人员排班
- 蓝牙点位管理、超时预警、保洁抽查
- 数据补录、补录审核

**小程序端：**
- 今日保洁、蓝牙强制打卡确认
- 保洁执行、异常反馈、抽查标记（主管）、异常数据补录

### 3.4 组织架构（org）

**Web端：**
- 班组管理、人员管理、人员分配
- 排班管理、技能管理、打卡点分配

**小程序端：**
- 我的班组、我的排班、通讯录

### 3.5 考勤打卡（attendance）

**Web端：**
- 打卡点管理（按班组分配不同打卡点+蓝牙绑定）
- 打卡规则、考勤记录、考勤统计
- 异常审核、数据补录

**小程序端：**
- 上下班蓝牙强制打卡（必须在指定打卡点连接蓝牙后打卡）
- 打卡记录、异常申诉、考勤日历

### 3.6 服务评价（evaluation）

**Web端：**
- 评价汇总看板、评价列表、评价回复
- 绩效报表、评价配置

**小程序端：**
- 待评价列表、评分留言、历史评价

### 3.7 统计报表（statistics）

按天/周/月/年/自定义时间段查询，支持Excel/PDF导出。

| 报表类型 | 可用角色 |
|----------|----------|
| 报修统计 | 物业 |
| 巡检统计 | 物业 |
| 保洁统计 | 物业 |
| 评价统计 | 物业 |
| 考勤统计 | 物业 |
| 综合看板 | 物业 |
| 自定义报表 | 物业（用户自选维度+指标） |

### 3.8 操作日志（audit-log）

| 功能点 | 说明 |
|--------|------|
| 日志时间轴 | 以时间轴形式展示操作记录，按时间倒序排列 |
| 日志列表 | 以表格形式展示，支持按模块/操作人/日期/操作类型筛选 |
| 日志详情 | 查看单条操作的完整信息（操作人、时间、IP、操作内容、变更前后对比） |
| 日志导出 | 导出操作日志Excel |
| 权限变更日志 | 专门查看权限变更记录（含变更前后对比） |
| 数据补录日志 | 专门查看数据补录记录 |

### 3.9 系统配置

| 功能点 | 说明 |
|--------|------|
| 蓝牙设备管理 | Beacon列表、位置绑定、状态监控、电量预警 |
| 字典管理 | 报修/巡检/保洁类型等字典，按租户自定义 |
| 微信配置 | 小程序/公众号参数配置 |
| 消息模板 | 微信模板消息配置 |
| 数据补录审核 | 审核各模块数据补录申请（主管） |

---

## 四、医院 — 功能模块（仅Web端）

> 医院账号仅使用Web端，以服务监督和数据查看为主，独占合同管理与分段招标。

### 4.1 合同管理（contract）

**仅医院账号可用，物业公司不可操作此模块。**

| 功能点 | 说明 |
|--------|------|
| 合同台账 | 合同列表与状态总览 |
| 合同录入 | 新建合同，关联物业公司与院区 |
| 合同详情 | 查看合同完整信息与履约记录 |
| 付款管理 | 付款节点管理与确认 |
| 变更管理 | 合同变更申请与审批 |
| 到期预警 | 合同到期自动提醒 |
| 续签管理 | 合同续签流程 |
| 合同统计 | 合同金额、履约率等统计报表 |

### 4.2 分段招标管理（bidding）

**仅医院账号可用，物业公司不可操作此模块。**

| 功能点 | 说明 |
|--------|------|
| 招标计划 | 创建招标计划，关联院区与预算 |
| 标段管理 | 标段划分与配置 |
| 供应商管理 | 供应商资质审核、黑名单管理 |
| 招标发布 | 发布招标公告 |
| 投标管理 | 供应商投标管理 |
| 评标管理 | 评标流程与打分 |
| 定标审批 | 定标审批与公示 |
| 中标公示 | 中标结果公示 |
| 招标统计 | 招标效率、成本对比等统计 |

### 4.3 服务监督

| 功能点 | 说明 |
|--------|------|
| 报修数据查看 | 查看关联物业公司的报修工单数据（只读） |
| 巡检数据查看 | 查看关联物业公司的巡检记录数据（只读） |
| 保洁数据查看 | 查看关联物业公司的保洁任务数据（只读） |

### 4.4 服务评价

| 功能点 | 说明 |
|--------|------|
| 发起评价 | 对物业服务发起评分与留言 |
| 评价汇总查看 | 查看评价汇总看板与统计 |

### 4.5 统计报表

| 报表类型 | 说明 |
|----------|------|
| 报修统计 | 查看关联物业报修数据统计（只读） |
| 巡检统计 | 查看关联物业巡检数据统计（只读） |
| 保洁统计 | 查看关联物业保洁数据统计（只读） |
| 评价统计 | 查看评价统计（只读） |
| 合同统计 | 合同相关统计 |
| 招标统计 | 招标相关统计 |
| 综合看板 | 全局数据综合看板 |
| 自定义报表 | 用户自选维度+指标 |

---

## 五、微信小程序 — 功能总览（仅物业人员使用）

> 微信小程序仅供物业人员使用，医院账号无小程序端。

### 5.1 物业人员工作台

不同角色登录后看到不同功能入口：

**维修人员：**
- 我的工单（接单/完工/延期申请）
- 协助申请
- 工单验收
- 消息通知

**巡检人员：**
- 今日巡检
- 蓝牙强制打卡
- 异常上报
- 异常数据补录

**保洁人员：**
- 今日保洁
- 蓝牙强制打卡确认
- 保洁执行
- 异常反馈

**主管/班组长：**
- 工单分配
- 巡检/保洁任务查看
- 延期审批
- 保洁抽查
- 考勤审核
- 数据补录审核

**物业公司管理员：**
- 报修管理（工单列表/分配/流转）
- 巡检管理（计划/看板/记录）
- 保洁管理（任务/排班/抽查）
- 考勤管理（记录/统计）
- 评价管理（查看/回复）
- 组织架构查看

### 5.2 通用功能

| 功能 | 说明 |
|------|------|
| 快捷登录 | 微信授权+手机号绑定，自动匹配物业公司与人员信息 |
| 个人信息 | 查看与编辑个人资料 |
| 消息通知 | 接收系统推送消息（新工单、催单、审批等） |
| 数据补录申请 | 提交数据补录申请（需审批） |
| 通讯录 | 查看本班组/物业公司联系人 |

### 5.3 小程序登录与权限机制

```
首次使用：扫码/打开小程序 → 微信授权获取openid → 绑定手机号
    → 系统匹配物业公司+人员信息 → 创建账号 → 进入工作台

再次使用：打开小程序 → 自动读取本地token → 验证有效性
    → 有效：直接进入工作台（无感登录）
    → 失效：自动使用openid静默登录 → 刷新token → 进入工作台
```

**权限判断机制：**
```
用户登录 → 获取角色及权限集（四级粒度） → 根据权限动态渲染：
    - 可见菜单项
    - 页面内可见功能点
    - 功能点可用动作（按钮显示/隐藏/禁用）
    - 数据范围（行级隔离）
```

---

## 六、跨角色数据流转矩阵

### 6.1 业务数据流转

| 数据 | 产生方 | 查看方 | 操作方 | 说明 |
|------|--------|--------|--------|------|
| 报修工单 | 物业（员工提交/系统派单） | 物业、医院 | 物业 | 医院只读查看工单数据 |
| 巡检记录 | 物业（巡检员打卡） | 物业、医院 | 物业 | 医院只读查看巡检数据 |
| 保洁记录 | 物业（保洁员打卡） | 物业、医院 | 物业 | 医院只读查看保洁数据 |
| 考勤记录 | 物业（员工打卡） | 物业 | 物业 | 仅物业公司内部数据 |
| 服务评价 | 医院（发起评价） | 物业、医院 | 医院 | 医院发起，物业查看与回复 |
| 合同数据 | 医院（录入管理） | 医院 | 医院 | 物业公司不可见 |
| 招标数据 | 医院（录入管理） | 医院 | 医院 | 物业公司不可见 |
| 操作日志 | 系统自动记录 | 超管、物业 | — | 仅查看，不可修改 |

### 6.2 账号与权限流转

| 操作 | 执行方 | 影响方 | 说明 |
|------|--------|--------|------|
| 创建医院/物业账号 | 超级管理员 | 医院/物业 | 超管创建账号并设有效期，对方收到开通通知 |
| 创建下属人员 | 物业公司管理员 | 物业下属 | 物业管理员创建下属账号并分配角色 |
| 修改角色权限 | 超管（角色定义）/物业管理员（下属角色） | 被修改角色的人员 | 权限实时生效，无需重新登录 |
| 账号到期提醒 | 系统 | 医院/物业管理员 | 登录时弹窗提醒，关闭后可正常使用 |
| 账号续期 | 超级管理员 | 医院/物业 | 超管手动续期，恢复或延长有效期 |

---

## 七、通知机制

### 7.1 通知场景与方式

| 触发场景 | 通知对象 | 通知方式 | 说明 |
|----------|----------|----------|------|
| 账号即将到期 | 医院/物业管理员 | Web弹窗提醒 | 到期前N天登录时弹窗，关闭后可正常使用 |
| 新工单分配 | 物业维修人员 | 小程序推送 | 实时推送新工单通知 |
| 催单 | 物业主管 | 小程序推送 | 医院或报修人催单时通知 |
| 合同到期预警 | 医院账号 | Web提醒 | 合同即将到期时在Web端提醒 |
| 低评分评价 | 物业管理员 | 小程序推送 | 收到低评分评价时即时通知 |
| 工单完工 | 报修人 | 小程序推送 | 维修完成后通知报修人评价 |
| 审批待办 | 审批人 | 小程序推送 | 有待审批事项时推送 |
| 巡检/保洁异常 | 物业主管 | 小程序推送 | 异常上报时即时通知 |

### 7.2 消息模板管理

- 物业公司管理员可配置微信模板消息内容
- 支持按场景自定义模板变量（工单号、人员姓名、时间等）
- 消息发送记录可查询

---

## 八、权限体系（技术参考）

### 8.1 四级权限粒度

权限按 **功能菜单 → 页面 → 功能点 → 动作** 四级树形结构划分：

```
功能菜单：在线报修
  ├── 页面：工单列表
  │     ├── 功能点：工单管理
  │     │     ├── ☑ 查看
  │     │     ├── ☑ 新增
  │     │     ├── ☑ 编辑
  │     │     ├── ☐ 删除
  │     │     ├── ☐ 审批
  │     │     ├── ☑ 导出
  │     │     └── ☑ 分配
  │     └── 功能点：批量操作
  │           ├── ☑ 查看
  │           ├── ☐ 新增
  │           ...
  ├── 页面：工单详情
  │     ├── 功能点：延期审批
  │     │     ├── ☑ 查看
  │     │     └── ☑ 审批
  │     └── 功能点：工单验收
  │           ├── ☑ 查看
  │           └── ☑ 审批
  └── 页面：报修类型管理
        ├── 功能点：类型管理
        │     ├── ☑ 查看
        │     ├── ☑ 新增
        │     ├── ☑ 编辑
        │     └── ☐ 删除
```

**7种动作类型：**

| 动作 | 编码 | 说明 |
|------|------|------|
| 查看 | view | 能否看到该页面/数据 |
| 新增 | create | 能否创建新记录 |
| 编辑 | update | 能否修改已有记录 |
| 删除 | delete | 能否删除记录 |
| 审批 | approve | 能否执行审批操作 |
| 导出 | export | 能否导出数据/报表 |
| 分配 | assign | 能否分配工单/任务/人员 |

### 8.2 权限自动同步机制

```
开发人员新增功能
      │
  在权限配置表中注册：
    - 菜单编码 + 菜单名称
    - 页面编码 + 页面名称
    - 功能点编码 + 功能点名称
    - 适用动作列表（查看/新增/编辑...）
      │
  系统启动时自动扫描权限配置表
      │
  权限管理页面自动渲染新的可勾选项
      │
  超级管理员可为角色分配新权限
```

### 8.3 权限实时生效机制

```
权限变更操作（超管/物业管理员修改角色权限）
      │
  更新数据库权限记录
      │
  发送权限变更事件（Redis Pub/Sub，毫秒级生效）
      │
  所有服务实例接收事件 → 刷新本地权限缓存
      │
  已登录用户下次操作时加载新权限（无需重新登录）
      │
  小程序端：下次接口请求时返回新权限集 → 动态更新界面
```

### 8.4 权限预设模板

| 模板名称 | 适用对象 | 典型权限 |
|----------|----------|----------|
| 物业管理员模板 | 物业公司管理员 | 全部日常业务管理权限 |
| 主管模板 | 主管 | 本班组管理+审批+查看+导出 |
| 班组长模板 | 班组长 | 本班组查看+分配+导出 |
| 维修员模板 | 维修人员 | 接单+完工+延期申请 |
| 巡检员模板 | 巡检人员 | 巡检执行+打卡+异常上报 |
| 保洁员模板 | 保洁人员 | 保洁执行+打卡确认 |
| 医院查看模板 | 医院账号 | 全部日常数据查看+合同+招标 |

**使用方式：** 创建角色时选择模板 → 系统自动填充权限 → 管理员微调后保存。

### 8.5 权限审计日志

| 记录项 | 说明 |
|--------|------|
| 操作人 | 谁执行了权限变更 |
| 操作时间 | 何时执行 |
| 操作类型 | 创建角色/修改权限/分配角色/移除角色 |
| 目标对象 | 被变更的角色或账号 |
| 变更详情 | 新增/移除了哪些权限项（对比前后差异） |

---

## 九、蓝牙场景汇总（技术参考）

| 模块 | 场景 | 蓝牙要求 | 失败处理 |
|------|------|----------|----------|
| 巡检 | 巡检打卡 | 必须连接对应点位Beacon | 进入补录模式 |
| 巡检 | 巡检拍照 | 必须在蓝牙连接状态下拍照 | 进入补录模式 |
| 保洁 | 保洁打卡确认 | 必须连接对应区域Beacon | 进入补录模式 |
| 保洁 | 保洁拍照 | 必须在蓝牙连接状态下拍照 | 进入补录模式 |
| 考勤 | 上班打卡 | 必须连接指定打卡点Beacon | 提交异常申诉 |
| 考勤 | 下班打卡 | 必须连接指定打卡点Beacon | 提交异常申诉 |