# 社区健康管理系统 

**Repository Path**: dm_team/Community-Health-Management-System

## Basic Information

- **Project Name**: 社区健康管理系统 
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区健康管理系统 / Community Health Management System

面向社区卫生服务中心的居民健康管理平台，覆盖居民档案、体征监测、风险预警、随访服务、健康计划执行、分类管理和用户管理

## 1. 技术栈

- 前端：React 18 + Vite + Ant Design + Recharts
- 后端：Python 3.10+ + FastAPI + Uvicorn
- 数据库：SQLite 文件数据库
- 推荐运行环境：Windows 10/11 + Node.js 20 LTS 或 22 LTS + npm 10+ + Python 3.10/3.11/3.12

SQLite 不需要单独安装，系统首次启动后端时会自动生成数据库文件。

## 2. 项目亮点

- 以居民档案、体征监测、随访闭环、健康计划四条主线构建完整业务流程。
- 支持根据血压、血糖、BMI、心率自动识别预警等级，并联动居民风险分层。
- 支持完成随访后自动生成下一次随访安排，体现基层公共卫生服务闭环。
- 提供健康看板、健康工作台、居民总览、计划执行率统计等可答辩展示页面。
- 新增分类管理模块，默认预置不少于 100 个社区健康相关分类项，管理员可继续扩展。

## 3. 目录结构

```text
backend/     后端 FastAPI 项目
frontend/    前端 React 项目
database/    数据库脚本
docs/        论文与系统文档
```

## 4. 新手运行步骤

### 4.1 启动后端

```bash
cd D:\Ten-Projects\03-community-health-management-system\backend
python -m pip install -r requirements.txt
python -m uvicorn main:app --reload --port 9013
```

后端地址：

```text
http://localhost:9013
```

健康检查：

```text
http://localhost:9013/api/health
```

### 4.2 启动前端

重新打开一个终端：

```bash
cd D:\Ten-Projects\03-community-health-management-system\frontend
npm install
npm run dev
```

前端地址：

```text
http://localhost:5175/
```

运行到这里后，浏览器会打开登录页。可直接使用下面账号登录：

- 管理员: `health_admin` / `Pass@123`
- 普通用户: `health_user` / `Pass@123`
- 演示医生: `doctor_demo` / `Pass@123`

建议第一次演示或检查时先使用管理员账号，因为管理员可以看到类别管理、用户管理和完整业务功能。
### 4.3 一键启动

Windows 可双击：

```text
start-project.bat
```

## 5. 默认账号

- 管理员：`health_admin` / `Pass@123`
- 普通用户：`health_user` / `Pass@123`
- 演示医生：`doctor_demo` / `Pass@123`

## 6. 数据库说明

数据库类型：SQLite。

数据库文件：

```text
backend/data/community-health-management-system.db
```

首次启动后端会自动执行：

```text
database/init.sql
database/sample_data.sql
```

如果要恢复初始数据，关闭后端后删除 `backend/data` 下的 `.db`、`.db-shm`、`.db-wal` 文件，再重新启动后端。

## 7. 分类管理

系统已新增“分类管理”模块，默认预置不少于 100 个业务分类项，管理员可以随时新增、编辑、停用、启用和删除分类项。居民档案、体征监测、随访管理和健康计划中的下拉框会读取启用状态的分类项。

## 8. 详细部署文档

新手请优先阅读：

[docs/06_部署说明.md](docs/06_部署说明.md)

该文档包含环境安装、目录说明、启动命令、数据库说明、Gitee 上传建议和常见问题。

## 9. 核心功能

### 9.1 数据看板

- 展示建档居民、高风险居民、异常体征待处理、待执行随访等关键指标。
- 展示居民风险等级分布和健康计划执行率。
- 展示近期业务时间线。

### 9.2 健康工作台

- 展示高风险居民风险清单。
- 展示异常体征待处理记录。
- 展示近期随访安排和医生负荷。
- 展示执行中健康计划与社区居民分布。

### 9.3 居民档案管理

- 居民档案新增、编辑、分页查询。
- 风险等级与档案状态筛选。
- 查看居民总览，包括近期体征记录、随访历史、适用健康计划和预警分布。

### 9.4 体征监测

- 维护血压、血糖、BMI、心率等体征数据。
- 自动识别正常、预警、高危等级。
- 支持记录跟进，并联动居民风险等级和管理状态。

### 9.5 随访管理

- 维护门诊复查、上门随访、电话回访、健康宣教等随访记录。
- 完成随访后记录结果并生成下一次随访安排。
- 支持人工调整居民风险等级和管理状态。

### 9.6 健康计划

- 制定高血压、糖尿病、体重管理等健康干预计划。
- 跟踪计划执行率和措施说明。
- 支持按状态查询和进度更新。

### 9.7 分类管理

- 管理员维护社区名称、慢病类型、风险等级、随访类型、健康指标、目标人群、干预周期和宣教主题等分类项。
- 新增分类项后可直接用于业务下拉框。

### 9.8 用户管理

- 管理员维护账号、角色与启停状态。
- 支持新增、编辑、删除演示账号。

## 10. 推荐演示路线

1. 使用管理员账号登录系统。
2. 展示数据看板中的风险等级分布与计划执行率。
3. 进入“分类管理”展示 100+ 个业务类别和新增分类能力。
4. 进入健康工作台查看高风险居民和待执行随访。
5. 打开某位居民总览展示体征记录、随访历史和关联健康计划。
6. 进入体征监测模块对异常记录执行“跟进处理”。
7. 进入随访管理模块完成随访并生成下次随访记录。
8. 进入健康计划模块更新执行进度。

## 11. 支持材料

- 项目简介：[docs/01_项目简介.md](docs/01_项目简介.md)
- 需求分析：[docs/02_需求分析.md](docs/02_需求分析.md)
- 系统设计：[docs/03_系统设计.md](docs/03_系统设计.md)
- 数据库设计：[docs/04_数据库设计.md](docs/04_数据库设计.md)
- 接口文档：[docs/05_接口文档.md](docs/05_接口文档.md)
- 部署说明：[docs/06_部署说明.md](docs/06_部署说明.md)
- 使用手册：[docs/07_使用手册.md](docs/07_使用手册.md)
- 测试说明：[docs/08_测试说明.md](docs/08_测试说明.md)