# zzyl

**Repository Path**: enough-words/zzyl

## Basic Information

- **Project Name**: zzyl
- **Description**: 中州养老项目仓库
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-17
- **Last Updated**: 2026-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 智慧养老管理系统 (Zzyl)

## 项目简介

智慧养老管理系统是一套面向养老机构的综合性信息化解决方案。系统采用前后端分离架构，后端基于 **Spring Boot** 构建，具备完整的员工管理体系、入住老人信息管理、房间/床位管理、护理计划制定、合同签署以及预约来访等功能。同时，系统集成了微信小程序接口，支持家属进行预约和入住信息查询。

## 技术栈

- **核心框架**: Spring Boot 2.x
- **持久层框架**: MyBatis (配合通用 Mapper 和拦截器实现自动填充)
- **数据库**: MySQL (关系型数据存储)
- **缓存**: Redis (会话管理、热点数据缓存)
- **对象存储**: 阿里云 OSS (合同文件、图片存储)
- **API 文档**: Swagger (Knife4j) (接口可视化与测试)
- **安全认证**: JWT (JSON Web Token)
- **定时任务**: Spring Task (预约状态过期处理等)

## 项目结构

项目采用 Maven 多模块构建，主要包含以下四个核心模块：

### 1. zzyl-common (公共模块)
提供整个系统的公共基础组件。
- **基础类**: `BaseEntity`, `BaseDto`, `BaseVo` (数据脱敏与基础字段统一管理)
- **工具类**: `SnowflakeIdWorker` (分布式ID生成), `JwtUtil` (Token工具), `StringUtils`, `UserThreadLocal` (用户上下文)
- **配置类**: 集成 Swagger, MyBatis, WebMvc, 阿里云 OSS 配置
- **常量定义**: 缓存 Key 常量，系统状态码常量等
- **异常处理**: 全局 `GlobalExceptionHandler`，统一响应格式 `ResponseResult`

### 2. zzyl-security (安全与权限模块)
负责系统的用户认证、权限控制与组织架构管理。
- **用户管理**: 用户增删改查、启用禁用、角色分配 (`UserController`, `UserService`)
- **角色管理**: 角色权限配置、数据权限范围控制 (`RoleController`)
- **资源菜单**: 动态菜单树生成 (`ResourceController`)
- **认证**: 后台管理员登录 (`LoginController`)
- **实体**: `User`, `Role`, `Dept`, `Post`, `UserRole`, `RoleResource`

### 3. zzyl-service (核心业务逻辑模块)
处理养老院的核心业务实体与流程。
- **老人管理**: 老人档案、信息修改、床位分配 (`ElderController`, `ElderService`)
- **房间管理**: 楼层、房间、床位、房型信息维护 (`RoomController`, `FloorController`, `BedController`)
- **合同管理**: 入住合同、解除合同、PDF文件管理 (`ContractController`)
- **护理管理**: 护理等级、护理计划、护理项目管理 (`NursingPlanController`, `NursingLevelController`, `NursingProjectController`)
- **预约与来访**: 参观预约、探访预约、来访签到 (`ReservationController`, `VisitController`)
- **会员与微信**: 微信小程序用户登录 (`MemberService`, `WechatService`)

### 4. zzyl-web (WEB 启动模块与控制器)
项目的启动入口，负责暴露 RESTful API 接口。
- **Controller 层**: 直接对接前端或小程序端请求。
- **定时任务**: 预约过期自动处理 (`ReservationJob`)。

## 核心功能概览

### 系统管理
- **用户与权限**: 基于 RBAC (Role-Based Access Control) 模型，支持细粒度的菜单和按钮权限控制。
- **组织架构**: 支持多级部门、岗位管理。

### 养老业务
- **老人档案**: 记录老人个人信息、健康状态、床位号。
- **房间管理**: 楼层-房间-床位三级结构，支持按状态（空床/入住）查询。
- **护理体系**: 定义护理等级，制定周期性护理计划，关联具体护理项目及费用。
- **合同签署**: 全流程合同管理，支持 PDF 存储与查看。

### 预约与来访
- **预约系统**: 支持参观预约和探访预约，包含时间分段控制。
- **来访登记**: 管理来访人员信息，记录来访状态（待报道、已完成、取消）。

### 微信小程序 (会员端)
- **用户登录**: 通过微信 `code` 换取 `openId` 实现静默登录或手机号快捷登录。
- **业务办理**: 家属可查看房型、提交预约申请、查看预约状态。

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.0+
- MySQL 5.7+ / 8.0+
- Redis 3.0+

### 配置修改
在 `zzyl-web/src/main/resources/application.yml` 中配置数据库连接、Redis 密码及阿里云 OSS 密钥等信息。

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/zzyl
    username: root
    password: password
  redis:
    host: localhost
    password: redis_password
zzyl:
  framework:
    jwt:
      base64EncodedSecretKey: your_jwt_secret
    oss:
      endpoint: oss-cn-hangzhou.aliyuncs.com
      accessKeyId: your_access_key
      accessKeySecret: your_secret
      bucketName: your_bucket_name
```

### 运行项目
```bash
mvn clean package -DskipTests
java -jar zzyl-web/target/zzyl-web.jar
```

### API 文档
启动项目后，可通过以下地址访问 Swagger UI 查看所有接口文档：
`http://localhost:8080/doc.html` (默认端口，具体视配置而定)

## License
[License Name]