# elderly-care

**Repository Path**: cloud-gradually/elderly-care

## Basic Information

- **Project Name**: elderly-care
- **Description**: 智慧养老综合管理平台 - 基于 Vue3 + TypeScript + FastAPI 的养老院管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧养老综合管理平台

专为养老院/养老机构打造的一站式数字化管理后台

## 功能模块

### 1. 老人档案管理
- 基本信息：姓名、年龄、性别、身份证、家属联系方式、紧急联系人
- 健康档案：血压、血糖、用药记录、过敏史、病史、护理日志
- 合同管理：入住合同、缴费记录、到期提醒
- 评估等级：护理等级（自理/半自理/全护理/特护）

### 2. 床位图管理（可视化拖拽）
- 楼层 → 房间 → 床位 三级展示
- 拖拽式分配床位
- 颜色状态：空闲/已入住/请假/维修

### 3. 员工管理
- 护工档案：基本信息、岗位、工龄、联系方式
- 资质证书：健康证、护理证、上岗证
- 排班考勤：每日/每周排班、出勤记录、迟到早退统计
- 绩效考核：评分、服务次数、家属表扬关联加分

### 4. 报表与数据决策
- 入住率报表（日/月/年）
- 营收报表（收费、欠费、实收）
- 护工人效统计（服务人数、工作量）
- 异常事件统计（摔倒、生病、投诉、紧急处理）
- 所有报表支持一键导出Excel

## 技术栈

### 前端
- 框架：Vue3 + TypeScript
- 构建工具：Vite
- UI组件库：Element Plus
- 图表库：ECharts

### 后端
- 语言：Python
- 框架：FastAPI
- 数据库ORM：SQLAlchemy

### 数据库
- MySQL 8.0

### 部署
- Docker + Docker Compose
- Nginx反向代理

## 项目结构

```
elderly-care-system/
├── backend/                 # 后端代码
│   ├── app/
│   │   ├── api/            # API路由
│   │   ├── models/         # 数据模型
│   │   ├── schemas/        # Pydantic模型
│   │   ├── utils/          # 工具函数
│   │   ├── config.py       # 配置文件
│   │   ├── database.py     # 数据库连接
│   │   └── main.py         # 主应用
│   ├── requirements.txt    # Python依赖
│   └── Dockerfile
├── frontend/               # 前端代码
│   ├── src/
│   │   ├── api/           # API接口
│   │   ├── views/         # 页面组件
│   │   ├── stores/        # Pinia状态管理
│   │   ├── router/        # 路由配置
│   │   └── main.ts        # 入口文件
│   ├── package.json
│   └── Dockerfile
├── database/              # 数据库脚本
│   └── init.sql          # 初始化SQL
├── docker-compose.yml    # Docker编排
└── README.md
```

## 快速开始

### 方式一：Docker部署（推荐）

1. 克隆项目
```bash
git clone <repository-url>
cd elderly-care-system
```

2. 启动服务
```bash
docker-compose up -d
```

3. 访问系统
- 前端：http://localhost
- API文档：http://localhost:8000/api/v1/docs

4. 默认账号
- 用户名：admin
- 密码：admin123

### 方式二：本地开发

#### 后端启动

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate   # Windows

# 安装依赖
pip install -r requirements.txt

# 启动服务
python main.py
```

#### 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

#### 数据库初始化

1. 创建MySQL数据库
2. 执行 `database/init.sql` 初始化表结构

## 配置说明

### 后端配置

修改 `backend/app/config.py` 或创建 `.env` 文件：

```env
DB_HOST=localhost
DB_PORT=8808
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=elderly_care_system
```

### 前端配置

修改 `frontend/vite.config.ts` 中的代理配置：

```typescript
server: {
  proxy: {
    '/api': {
      target: 'http://localhost:8000',
      changeOrigin: true
    }
  }
}
```

## API文档

启动后端服务后访问：
- Swagger UI: http://localhost:8000/api/v1/docs
- ReDoc: http://localhost:8000/api/v1/redoc

## 开发说明

### 数据库迁移

如需修改数据库结构，请更新 `database/init.sql` 并重新执行。

### 添加新模块

1. 后端：在 `backend/app/models/` 添加模型，`backend/app/api/` 添加路由
2. 前端：在 `frontend/src/views/` 添加页面，`frontend/src/api/` 添加接口

## 许可证

MIT License