README.md 6.1 KB
康悦林疗养院 — 智慧疗养系统（后端）
基于 Spring Boot 2.7 + MyBatis-Plus 的智慧疗养院管理系统，提供 PC 管理后台与 UniApp 移动端双端支持。
项目结构
kyl-sanatorium/
├── kyl-common/ # 公共模块（基类、工具类、常量、VO）
├── kyl-framework/ # 框架层（配置、拦截器、安全管理）
├── kyl-security/ # 权限模块（用户/角色/部门/菜单/岗位）
├── kyl-service/ # 业务模块（入住/退住/财务/护理/IoT）
├── kyl-pay/ # 支付模块（微信支付、交易、退款）
├── kyl-web/ # Web 入口（Controller、主启动类）
└── pom.xml # 父 POM（多模块聚合）
技术栈
| 技术 | 版本 | 说明 |
|---|---|---|
| Spring Boot | 2.7.4 | 基础框架 |
| Java | 11 | JDK 版本 |
| MyBatis-Plus | 3.5.15 | ORM 框架 |
| MyBatis | 3.5.19 | MyBatis 核心 |
| MySQL | 8.0.19 | 数据库 |
| Druid | 1.2.1 | 数据库连接池 |
| Redis | - | 缓存（@Cacheable + Redisson） |
| Activiti | 7.10.0 | 工作流引擎（入住/退住流程审批） |
| PageHelper | 1.3.0 | 分页插件 |
| Knife4j | 3.0.3 | API 文档（访问 /doc.html） |
| Spring Security | - | 认证授权（JWT Token） |
| Hutool | 5.8.0.M3 | 工具类库 |
| XXL-Job | 2.3.0 | 分布式定时任务 |
| 阿里云 OSS | - | 文件存储 |
| 阿里云 IoT | - | 设备数据接入 |
| 微信支付 | - | 微信支付 v3 API |
模块功能说明
1. 权限管理（kyl-security）
- 用户管理（CRUD、密码重置、角色分配）
- 角色管理（CRUD、菜单权限、数据权限）
- 部门管理（树形结构、领导指派）
- 岗位管理
- 菜单/资源管理（动态路由、按钮权限）
2. 业务管理（kyl-service）
| 模块 | 说明 |
|---|---|
| 入住管理 | 入住申请 → 评估 → 签约 → 审批（Activiti 工作流） |
| 退住管理 | 退住申请 → 清算 → 审批 → 退款（Activiti 工作流） |
| 预约来访 | PC/移动端预约、来访记录管理 |
| 老人管理 | 老人档案、身份证校验 |
| 居住管理 | 楼层/房间/床位管理、房型管理 |
| 护理服务 | 护理等级、护理项目、护理计划、护理任务 |
| 财务管理 | 账单、欠费、余额、预充值、退款 |
| 合同管理 | 合同签署、到期提醒 |
| 订单管理 | 服务订单、商品订单、退款 |
| IoT 设备 | 阿里云 IoT 设备管理、物模型、属性数据 |
| 报警规则 | 设备报警规则配置、报警处理 |
| WebSocket | 实时消息推送 |
3. 支付模块（kyl-pay）
- 微信支付（H5/JSAPI）
- 交易记录
- 退款处理
4. 移动端（UniApp）
- 家属端：老人绑定、健康数据查看、预约、账单
- 客户登录：微信授权、手机号
快速启动
环境要求
- JDK 11+
- MySQL 8.0+
- Redis
- Maven 3.6+
启动步骤
# 1. 创建数据库并导入 SQL
mysql -u root -p < kyl-sanatorium-sql/kyl_sanatorium_db.sql
# 2. 修改数据库配置
# 编辑 kyl-web/src/main/resources/application.yml
# 修改 datasource.druid.url / username / password
# 3. 编译运行
cd kyl-sanatorium
mvn clean package -DskipTests
java -jar kyl-web/target/kyl-web.jar
访问地址：
- 后台 API：
http://localhost:9995 - API 文档：
http://localhost:9995/doc.html - 移动端 API：
http://localhost:9995/customer
安全提示
生产部署前必须：替换
application.yml中的明文凭据（数据库密码、阿里云AK/SK、微信Secret 等），使用环境变量或配置中心管理敏感信息。
接口概览
| 分类 | 路径前缀 | 说明 |
|---|---|---|
| 认证 | /security |
登录、获取用户信息 |
| 权限管理 | /user, /role, /dept, /post, /resource |
用户/角色/部门/岗位/菜单 |
| 入住 | /checkIn |
入住申请、评估、签约、审批 |
| 退住 | /elder |
退住申请、审批、清算 |
| 预约来访 | /reservation, /visit |
预约、来访记录 |
| 居住 | /floor, /room, /bed, /roomTypes |
楼层/房间/床位/房型 |
| 老人 | /elder |
老人档案 |
| 财务 | /bill |
账单、欠费、余额、充值 |
| 订单 | /orders |
服务订单 |
| 护理 | /nursingLevel, /nursing_project, /nursing/plan, /nursingTask |
等级/项目/计划/任务 |
| IoT | /iot, /alert-rule, /device-data |
设备管理/报警/数据 |
| 合同 | /contract |
合同管理 |
| 移动端 | /customer/* |
家属端接口 |
| 支付 | /trade-common-feign |
交易/退款 |
详细 API 文档见：
kyl-sanatorium-api-docs.md