# 中州养老

**Repository Path**: lyblog/zzyl

## Basic Information

- **Project Name**: 中州养老
- **Description**: 中州养老项目分为两端，一个是管理后台，另外一个是家属端

- 管理后台：养老院员工使用，入住、退住，给老人服务记录等等
- 家属端：养老院的老人家属使用，查看老人信息，缴费，下订单等等
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 59
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img src="docs/images/logo.png" alt="Logo" width="150"/>

# 🌟 中州养老院智慧管理系统 🌟

<h3 style="color: #722ed1; font-weight: normal; margin-top: 10px">✨ 科技赋能养老 · 专业成就品质 ✨</h3>

<p align="center" style="color: #595959; max-width: 700px; line-height: 1.8">
  基于 SpringBoot + Vue 3 的智慧养老综合解决方案<br/>
  整合入住管理、服务记录、财务管理、请假审批、家属交互等核心模块<br/>
  助力养老机构数字化转型
</p>

<!-- 技术栈滚动徽章 -->
<div style="white-space: nowrap; overflow-x: auto; padding: 10px 0;">
  <img alt="Java" src="https://img.shields.io/badge/Java-11-orange">
  <img alt="Spring Boot" src="https://img.shields.io/badge/Spring_Boot-2.7.4-brightgreen">
  <img alt="Spring Security" src="https://img.shields.io/badge/Spring_Security-5.7.3-red">
  <img alt="MySQL" src="https://img.shields.io/badge/MySQL-8.0.19-blue">
  <img alt="MyBatis Plus" src="https://img.shields.io/badge/MyBatis_Plus-2.2.0-green">
  <img alt="PageHelper" src="https://img.shields.io/badge/PageHelper-1.3.0-green">
  <img alt="Druid" src="https://img.shields.io/badge/Druid-1.2.1-blueviolet">
  <img alt="Redis" src="https://img.shields.io/badge/Redis-6.x-red">
  <img alt="Redisson" src="https://img.shields.io/badge/Redisson-3.11.2-red">
  <img alt="Activiti" src="https://img.shields.io/badge/Activiti-7.1.0-orange">
  <img alt="JWT" src="https://img.shields.io/badge/JWT-3.8.1-lightgrey">
  <img alt="JJWT" src="https://img.shields.io/badge/JJWT-0.9.1-lightgrey">
  <img alt="Lombok" src="https://img.shields.io/badge/Lombok-1.18.22-yellow">
  <img alt="Hutool" src="https://img.shields.io/badge/Hutool-5.8.0.M3-green">
  <img alt="FastJSON" src="https://img.shields.io/badge/FastJSON-1.2.75-red">
  <img alt="Orika" src="https://img.shields.io/badge/Orika-1.5.4-blue">
  <img alt="ZXing" src="https://img.shields.io/badge/ZXing-3.3.3-blue">
  <img alt="Kaptcha" src="https://img.shields.io/badge/Kaptcha-2.3.2-yellow">
  <img alt="OSHI" src="https://img.shields.io/badge/OSHI-5.6.0-darkgreen">
  <img alt="XXL Job" src="https://img.shields.io/badge/XXL_Job-2.3.0-green">
  <img alt="Knife4j" src="https://img.shields.io/badge/Knife4j-3.0.3-green">
  <img alt="Aliyun OSS" src="https://img.shields.io/badge/Aliyun_OSS-3.10.2-orange">
  <img alt="Aliyun IoT" src="https://img.shields.io/badge/Aliyun_IoT-AMQP-blue">
  <img alt="WeChat Pay" src="https://img.shields.io/badge/WeChat_Pay-0.4.7-green">
</div>

</div>

---

## 🚀 核心价值

| 维度 | 亮点 |
|------|------|
| 🏆 管理效率 | 业务流程数字化，智能排班节省约 30% 人力成本，实时数据看板辅助决策 |
| 💡 服务质量 | 健康数据动态监测，护理服务标准化，家属端实时互动 |
| 📈 运营效益 | 财务自动统计，资源利用率提升约 40%，风险预警保障安全 |

---

## 📌 快速导航

| 模块 | 地址 |
|------|------|
| 前端源码 | [zzyl-web](https://gitee.com/itxinfei/zzyl-web) |
| 管理后台 | [演示系统](https://zhyl-admin.itheima.net) |
| API 文档 | [Swagger UI](http://api.zzyl.com/swagger) |

---

## 🛠️ 快速开始

```bash
# 克隆后端项目
git clone https://gitee.com/itxinfei/zzyl.git

# 克隆前端项目
git clone https://gitee.com/itxinfei/zzyl-web.git

# 安装依赖并启动
npm install && npm run dev
```

---

## 🏠 一、项目介绍

中州养老院是一家专业养老服务机构，秉持"以人为本、关爱生命"的理念，为长者提供高品质养老服务。院区占地面积超 30,000 平方米，总建筑面积 40,000 平方米，现有床位 800 余张，员工 200 余人，先后荣获"全国优秀养老院"等多项荣誉。

### 1.1 行业背景

中国老龄化程度持续加深，智慧养老成为行业必然趋势。2022 年中国养老产业市场规模达 **10.3 万亿元**，预计 2027 年将突破 **21.1 万亿元**。

<p align="center">
  <img src="docs/images/image-20230808134224075.png" alt="市场规模" width="600"/>
</p>

### 1.2 整体业务流程

覆盖从来访参观到退住办理的全生命周期，包括来访管理、入退管理、在住管理、服务管理、财务管理等核心模块。

<p align="center">
  <img src="docs/images/image-20230722161536290.png" alt="业务流程" width="600"/>
</p>

### 1.3 系统架构

> 原型地址：https://rp-java.itheima.net/zhyl/

项目分为两大终端：

- **管理后台**：面向员工，提供入住/退住、服务记录、财务管理等功能
- **家属端**：面向家属，支持查看老人信息、在线缴费、服务下单

<p align="center">
  <img src="docs/images/中州-架构图@2x.png" alt="系统架构" width="600"/>
</p>

### 1.4 技术架构

<p align="center">
  <img src="docs/images/中州-技术架构图.png" alt="技术架构" width="600"/>
</p>

---

## 📋 二、项目管理

### 2.1 项目生命周期

需求分析 → 设计 → 编码 → 测试 → 部署 → 运维

<p align="center">
  <img src="docs/images/image-20230724164928484.png" alt="生命周期" width="600"/>
</p>

### 2.2 项目开发模式

| 模式 | 特点 | 适用场景 |
|------|------|----------|
| 瀑布模型 | 顺序式开发，阶段严格递进 | 需求明确、变更少 |
| 敏捷开发 | 迭代式开发，快速响应变化 | 需求多变、周期短 |
| DevOps | 开发运维融合，强调自动化持续交付 | 高频部署、快速迭代 |

<p align="center">
  <img src="docs/images/image-20230724164736889.png" alt="瀑布模型" width="500"/>
  <img src="docs/images/image-20230724164900781.png" alt="敏捷开发" width="500"/>
</p>

<p align="center">
  <img src="docs/images/image-20230725093037210.png" alt="DevOps" width="500"/>
  <img src="docs/images/image-20230729094020085.png" alt="三者对比" width="500"/>
</p>

### 2.3 项目管理方法

**进度管理**：制定计划 → 监控进度 → 风险管控 → 流程优化 → 变更管理

**缺陷管理**：发现记录 → 筛选分析 → 分配追踪 → 验证关闭 → 统计分析

**代码规范要点**：
- 命名清晰，遵循驼峰法
- 缩进统一（4 空格）
- 注释描述意图，减少行内注释
- 方法职责单一，参数不超过 3 个
- 异常处理提供清晰的错误信息

---

## 📝 三、文档介绍

### 3.1 原型与 PRD

- **PRD**（Product Requirements Document）：产品需求文档，描述功能、场景和业务规则，是开发核心依据
- **原型**：交互原型图，直观展示页面布局和操作流程

### 3.2 UI/UE 设计

- **UI**（用户界面）：负责视觉界面设计，是用户与系统的桥梁
- **UE**（用户体验）：关注产品易用性和使用感受

设计师核心职责：界面设计、交互设计、原型制作、视觉规范、可用性测试

### 3.3 个人开发计划

需求分析 → 编码自测 → 接口联调

---

## 📦 四、代码结构

### 4.1 工程结构

```
zzyl/
├── zzyl-common     # 通用模块：统一异常、工具类、常量、基类
├── zzyl-framework  # 框架核心：配置类、拦截器、第三方集成
├── zzyl-pay        # 支付组件：微信扫码支付
├── zzyl-security   # 安全组件：权限认证、JWT
├── zzyl-service    # 业务层：核心业务逻辑
└── zzyl-web        # 控制层：RESTful 接口
```

> `common`、`framework`、`service`、`web` 是日常开发最常接触的模块。

### 4.2 🗂️ 模块详解

#### 4.2.1 zzyl-common（通用模块）

```
com.zzyl/base/
├── AjaxResult              # 统一接口响应
├── BaseDto / BaseEntity / BaseVo  # 各层基类
├── PageResponse            # 分页封装
├── exception/              # 异常体系
├── utils/                  # 工具类
└── vo/                     # 公共视图对象
```

> **DTO**：层间数据传输；**VO**：向前端返回展示数据

#### 4.2.2 zzyl-framework（框架模块）

```
com.zzyl/
├── config/    # OSS、Swagger、MyBatis、WebMvc 配置
├── intercept/ # 自动填充字段拦截器
└── properties/# 配置文件属性读取
```

#### 4.2.3 zzyl-service（业务模块）

```
com.zzyl/
├── dto/ entity/ enums/ mapper/ service/ vo/
└── resources/mapper/    # MyBatis XML 映射
```

#### 4.2.4 zzyl-web（控制层）

```
com.zzyl/controller/     # RESTful 接口
└── zzylApplication       # 启动入口
```

### 4.3 🖥️ 前端环境

#### 4.3.1 环境要求

| 技术项 | 要求 |
|--------|------|
| Node.js | v16.20.0 |
| 框架 | Vue 3 + TypeScript |
| 开发工具 | VS Code |
| UI 组件库 | TDesign |

#### 4.3.2 启动项目

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产环境包
npm run build
```

### 4.4 🚀 启动前后端项目

#### 4.4.1 前端启动

```bash
npm install && npm run dev
```

前端服务启动后，在终端输出的地址访问系统。

#### 4.4.2 后端启动

后端服务启动后，访问前端控制台输出的地址即可使用系统。

---

## 🔨 五、护理项目功能开发

后端开发标准化流程：需求分析 → 评估工期 → 表结构设计 → 接口设计 → 编码实现 → 接口联调

> 设计阶段最耗时，包含需求分析、工期评估、表结构设计、接口设计。这几步扎实完成后，编码水到渠成。