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

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

### 启动步骤

```bash
# 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`