|
|
# 医院物业 SaaS 管理后台
|
|
|
|
|
|
> 多租户医院物业管理平台，涵盖报修、巡检、保洁、考勤、合同、招标等核心业务模块，支持蓝牙打卡、微信小程序端操作。
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
| 类别 | 技术 |
|
|
|
|------|------|
|
|
|
| 语言 | Java 17 |
|
|
|
| 框架 | Spring Boot 3.2.5 |
|
|
|
| ORM | MyBatis-Plus 3.5.5 |
|
|
|
| 安全 | Spring Security + JWT |
|
|
|
| 数据库 | MariaDB 10.6+ |
|
|
|
| 缓存 | Redis 7 |
|
|
|
| API 文档 | SpringDoc / Swagger |
|
|
|
| 构建工具 | Maven 3.9+ |
|
|
|
| 容器化 | Docker + Docker Compose |
|
|
|
|
|
|
## 项目结构
|
|
|
|
|
|
```
|
|
|
backend/
|
|
|
├── src/main/java/com/hospital/mgmt/
|
|
|
│ ├── common/ # 通用组件
|
|
|
│ │ ├── annotation/ # 自定义注解（@AuditLog, @ReadOnly）
|
|
|
│ │ ├── base/ # 基础实体类
|
|
|
│ │ ├── context/ # 租户上下文（ThreadLocal）
|
|
|
│ │ ├── exception/ # 全局异常处理
|
|
|
│ │ └── result/ # 统一响应封装
|
|
|
│ ├── config/ # 配置类
|
|
|
│ ├── security/ # 安全模块（JWT、认证、租户拦截）
|
|
|
│ └── modules/ # 业务模块
|
|
|
│ ├── auth/ # 认证（登录/刷新Token）
|
|
|
│ ├── org/ # 组织架构（医院/物业/班组/员工）
|
|
|
│ ├── permission/ # 权限管理（用户/角色/权限配置）
|
|
|
│ ├── repair/ # 在线报修
|
|
|
│ ├── inspection/ # 巡检管理
|
|
|
│ ├── cleaning/ # 保洁管理
|
|
|
│ ├── evaluation/ # 服务评价
|
|
|
│ ├── attendance/ # 考勤打卡
|
|
|
│ ├── contract/ # 合同管理
|
|
|
│ ├── bidding/ # 分段招标
|
|
|
│ ├── device/ # 蓝牙设备管理
|
|
|
│ ├── audit/ # 操作日志
|
|
|
│ ├── system/ # 系统管理（字典/版本/模板）
|
|
|
│ └── plugin/ # IModulePlugin 扩展接口
|
|
|
├── src/main/resources/
|
|
|
│ ├── application.yml # 默认配置
|
|
|
│ ├── application-prod.yml # 生产配置
|
|
|
│ └── db/init.sql # 数据库初始化脚本
|
|
|
├── Dockerfile
|
|
|
└── pom.xml
|
|
|
```
|
|
|
|
|
|
## 快速开始
|
|
|
|
|
|
### 前置条件
|
|
|
|
|
|
- JDK 17+
|
|
|
- Maven 3.9+
|
|
|
- MariaDB 10.6+
|
|
|
- Redis 7+
|
|
|
|
|
|
### 1. 本地开发
|
|
|
|
|
|
```bash
|
|
|
# 克隆项目
|
|
|
git clone <repository-url>
|
|
|
cd 医院后勤管理
|
|
|
|
|
|
# 初始化数据库
|
|
|
mysql -uroot -proot < backend/src/main/resources/db/init.sql
|
|
|
|
|
|
# 修改配置（如需要）
|
|
|
# 编辑 backend/src/main/resources/application.yml 中的数据库和Redis连接信息
|
|
|
|
|
|
# 编译运行
|
|
|
cd backend
|
|
|
mvn clean package -DskipTests
|
|
|
java -jar target/hospital-mgmt-1.0.0.jar
|
|
|
```
|
|
|
|
|
|
应用启动后访问：
|
|
|
- API 基地址：`http://localhost:8080/api/v1`
|
|
|
- Swagger UI：`http://localhost:8080/api/v1/swagger-ui.html`
|
|
|
|
|
|
### 2. Docker Compose 部署（推荐）
|
|
|
|
|
|
```bash
|
|
|
# 复制环境变量模板并修改
|
|
|
cp .env.example .env
|
|
|
|
|
|
# 一键启动（MariaDB + Redis + 后端）
|
|
|
docker compose up -d
|
|
|
|
|
|
# 查看日志
|
|
|
docker compose logs -f backend
|
|
|
|
|
|
# 停止
|
|
|
docker compose down
|
|
|
```
|
|
|
|
|
|
### 3. 仅构建后端镜像
|
|
|
|
|
|
```bash
|
|
|
cd backend
|
|
|
docker build -t hospital-mgmt:1.0.0 .
|
|
|
```
|
|
|
|
|
|
## 环境变量
|
|
|
|
|
|
| 变量 | 说明 | 默认值 |
|
|
|
|------|------|--------|
|
|
|
| `DB_HOST` | MariaDB 主机 | localhost |
|
|
|
| `DB_PORT` | MariaDB 端口 | 3306 |
|
|
|
| `DB_NAME` | 数据库名 | hospital_mgmt |
|
|
|
| `DB_USER` | 数据库用户 | root |
|
|
|
| `DB_PASSWORD` | 数据库密码 | root |
|
|
|
| `REDIS_HOST` | Redis 主机 | localhost |
|
|
|
| `REDIS_PORT` | Redis 端口 | 6379 |
|
|
|
| `REDIS_PASSWORD` | Redis 密码 | (空) |
|
|
|
| `JWT_SECRET` | JWT 签名密钥 | (内置默认值) |
|
|
|
| `JAVA_OPTS` | JVM 参数 | -Xms256m -Xmx512m |
|
|
|
| `SPRING_PROFILES_ACTIVE` | Spring Profile | prod |
|
|
|
|
|
|
## 默认账号
|
|
|
|
|
|
| 角色 | 用户名 | 密码 |
|
|
|
|------|--------|------|
|
|
|
| 超级管理员 | superadmin | admin123 |
|
|
|
|
|
|
## 核心功能模块
|
|
|
|
|
|
### 在线报修
|
|
|
- 工单全生命周期：提交 → 智能派单 → 接单 → 处理 → 验收 → 评价
|
|
|
- 支持紧急催单、延期申请、协助工单
|
|
|
- 补录机制（需审批）
|
|
|
|
|
|
### 巡检管理
|
|
|
- 自定义巡检区域与计划
|
|
|
- 支持日/周/月/自定义频率
|
|
|
- 蓝牙打卡验证巡检人员位置
|
|
|
- 异常自动转报修工单
|
|
|
|
|
|
### 保洁管理
|
|
|
- 五级区域树结构管理
|
|
|
- 日保/深度/临时任务类型
|
|
|
- 排班与任务自动生成
|
|
|
- 抽检功能
|
|
|
|
|
|
### 考勤打卡
|
|
|
- 基于蓝牙 Beacon 的近距离验证
|
|
|
- 灵活配置上下班规则
|
|
|
- 异常申诉与补录审批
|
|
|
|
|
|
### 合同管理
|
|
|
- 合同全生命周期
|
|
|
- 付款节点管理与到期预警
|
|
|
- 合同变更审批流
|
|
|
|
|
|
### 分段招标
|
|
|
- 招标计划与标段管理
|
|
|
- 供应商资质审核
|
|
|
- 黑名单机制
|
|
|
|
|
|
### 服务评价
|
|
|
- 多模块统一评价体系
|
|
|
- 低评分自动通知
|
|
|
- 评价回复机制
|
|
|
|
|
|
### 权限管理
|
|
|
- RBAC + 四级数据权限（全院/医院/班组/个人）
|
|
|
- 用户级权限覆盖
|
|
|
- Redis 实时权限变更广播
|
|
|
|
|
|
### 蓝牙策略
|
|
|
- 各院区独立配置打卡策略
|
|
|
- 必选/可选/禁用三级配置
|
|
|
- 策略审批生效机制
|
|
|
|
|
|
### 扩展接口 (IModulePlugin)
|
|
|
- SPI 机制支持模块热插拔
|
|
|
- 自定义菜单、路由、权限、数据表
|
|
|
- 运行时模块启用/禁用
|
|
|
|
|
|
## API 规范
|
|
|
|
|
|
- RESTful 风格
|
|
|
- 统一响应格式：`{ code, message, data, timestamp }`
|
|
|
- 分页响应：`{ list, pagination: { page, pageSize, total, totalPages } }`
|
|
|
- 错误码：5 位数字（4xxxx 客户端错误，5xxxx 服务端错误）
|
|
|
|
|
|
## License
|
|
|
|
|
|
Private — Internal Use Only
|