houqin-java/docs/01-模块划分.md

医院物业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	提交异常申诉