J250419/kyl-sanatorium

康悦林疗养院 — 智慧疗养系统（后端）

基于 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