# ymw-healthy

**Repository Path**: profpund/ymw-heal

## Basic Information

- **Project Name**: ymw-healthy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-18
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区老人健康管理系统

一个完整的、现代化的社区老人健康管理系统，包含后端 API、前端应用、数据库设计和完整的文档。

## 🎯 项目概述

本项目是一个为社区老年人提供健康管理和医疗服务的综合平台，包括：

- **用户管理**：老年人、医生、管理员三种角色
- **医生预约**：在线预约医生，查看医生信息
- **健康监测**：记录和监测血压、血糖、心率等健康指标
- **就诊记录**：查看就诊历史和诊断结果
- **社区论坛**：老年人交流分享健康经验
- **系统公告**：发布重要通知和健康提示

## 🚀 快速开始

### 前置条件

- Docker 已安装
- Node.js 18+ 已安装
- npm 或 yarn 已安装

### 一键启动

```bash
# 方法1：使用初始化脚本（推荐）
bash /Users/xumingyue/Desktop/xhs2/project/初始化数据库.sh

# 方法2：手动启动
cd /Users/xumingyue/Desktop/xhs2/project/backend
npm run seed
npm run dev

# 在另一个终端启动前端
cd /Users/xumingyue/Desktop/xhs2/project/frontend
npm run dev
```

### 访问应用

- 前端应用：http://localhost:5173
- 后端 API：http://localhost:3000
- pgAdmin：http://localhost:5050

## 👤 演示账户

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 老年人 | elder_zhang | password123 |
| 医生 | doctor_chen | password123 |
| 管理员 | admin_user | admin123 |

## 📁 项目结构

```
project/
├── backend/                    # 后端应用
│   ├── src/
│   │   ├── app.js             # Express 应用入口
│   │   ├── config/            # 配置文件
│   │   ├── models/            # 数据库模型
│   │   ├── controllers/       # 控制器
│   │   ├── services/          # 业务逻辑
│   │   ├── routes/            # 路由
│   │   ├── middleware/        # 中间件
│   │   └── seeders/           # 数据库种子
│   ├── package.json
│   └── .env
│
├── frontend/                   # 前端应用
│   ├── src/
│   │   ├── App.jsx            # 主应用
│   │   ├── pages/             # 页面组件
│   │   ├── components/        # 通用组件
│   │   ├── store/             # Redux 存储
│   │   ├── services/          # API 服务
│   │   └── styles/            # 样式文件
│   ├── package.json
│   └── vite.config.js
│
├── docker-compose.yml         # Docker 配置
├── 初始化数据库.sh            # 数据库初始化脚本
└── 完整初始化.sh              # 完整初始化脚本
```

## 🛠️ 技术栈

### 后端
- **框架**：Express.js 4.18
- **数据库**：PostgreSQL 14+
- **ORM**：Sequelize 6.35
- **认证**：JWT + bcryptjs
- **验证**：Joi
- **日志**：Winston

### 前端
- **框架**：React 18.x
- **路由**：React Router v6
- **状态管理**：Redux Toolkit
- **HTTP 客户端**：Axios
- **构建工具**：Vite
- **样式**：CSS3 + CSS Variables

### 部署
- **容器化**：Docker + Docker Compose
- **数据库**：PostgreSQL 容器
- **管理工具**：pgAdmin 容器

## 📊 核心功能

### 用户管理
- ✅ 用户注册和登录
- ✅ 用户信息管理
- ✅ 角色管理（老年人、医生、管理员）
- ✅ 权限控制

### 医生管理
- ✅ 医生列表展示
- ✅ 医生信息查询
- ✅ 在线状态管理
- ✅ 评分系统

### 预约管理
- ✅ 在线预约医生
- ✅ 预约查询和管理
- ✅ 预约状态跟踪
- ✅ 预约历史记录

### 健康数据
- ✅ 血压监测
- ✅ 血糖监测
- ✅ 心率监测
- ✅ 数据历史查询

### 就诊记录
- ✅ 就诊信息记录
- ✅ 诊断结果查看
- ✅ 处方管理

### 社区功能
- ✅ 论坛帖子发布
- ✅ 论坛评论互动
- ✅ 系统公告发布
- ✅ 内容管理

## 📚 文档

### 快速参考
- [前端样式快速参考](./前端样式快速参考.md)
- [数据库种子文件快速参考](./数据库种子文件快速参考.md)

### 详细指南
- [前端样式完整更新](./前端样式完整更新.md)
- [数据库种子文件使用指南](./数据库种子文件使用指南.md)
- [Docker 启动指南](./Docker启动指南.md)
- [完整启动指南](./完整启动指南.md)

### 项目文档
- [项目计划书](./项目简介计划书.md)
- [UI 设计说明](./UI设计稿说明.md)
- [项目完成进度总结](./项目完成进度总结.md)
- [项目完成检查清单](./项目完成检查清单.md)

## 🎨 设计系统

### 色彩方案
- **主色**：#FF3B30（红色）
- **深色背景**：#0A0A0A
- **浅色背景**：#FFFFFF
- **成功色**：#22C55E
- **边框色**：#E0E0E0

### 排版系统
- **标题字体**：Space Grotesk
- **正文字体**：Inter
- **字号层级**：48px, 32px, 18px, 14px, 12px, 10px

### 间距系统
- **基础单位**：8px
- **间距倍数**：4px, 8px, 12px, 16px, 20px, 28px, 32px, 56px

## 🔧 常用命令

### 后端命令
```bash
# 启动开发服务器
npm run dev

# 启动生产服务器
npm start

# 初始化数据库
npm run seed

# 运行测试
npm test
```

### 前端命令
```bash
# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产版本
npm run preview
```

### Docker 命令
```bash
# 启动容器
docker-compose up -d

# 停止容器
docker-compose down

# 查看容器日志
docker-compose logs -f

# 重启容器
docker-compose restart
```

## 📊 数据库

### 表结构
- `users` - 用户表
- `doctors` - 医生表
- `appointments` - 预约表
- `health_data` - 健康数据表
- `visit_records` - 就诊记录表
- `forum_posts` - 论坛帖子表
- `forum_comments` - 论坛评论表
- `announcements` - 公告表

### 数据库连接
```
主机: localhost
端口: 5432
数据库: elder_health
用户: postgres
密码: postgres
```

## 🔐 安全特性

- ✅ 密码加密（bcryptjs）
- ✅ JWT 认证
- ✅ 角色授权
- ✅ 数据验证（Joi）
- ✅ CORS 配置
- ✅ 错误处理

## 📈 性能优化

- ✅ 数据库查询优化
- ✅ API 响应缓存
- ✅ 前端代码分割
- ✅ 图片优化
- ✅ CSS 变量复用

## 🧪 测试

### 后端测试
- API 端点测试
- 认证测试
- 数据验证测试
- 错误处理测试

### 前端测试
- 页面加载测试
- 表单提交测试
- 路由导航测试
- 响应式设计测试

## 🚀 部署

### Docker 部署
```bash
# 构建镜像
docker-compose build

# 启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f
```

### 环境变量配置
```
# 后端 .env
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/elder_health
JWT_SECRET=your_secret_key
NODE_ENV=development
PORT=3000

# 前端 .env
VITE_API_URL=http://localhost:3000
```

## 📞 常见问题

### Q: 如何重新初始化数据库？
A: 运行 `npm run seed` 命令

### Q: 如何修改演示数据？
A: 编辑 `backend/src/seeders/seedData.js` 文件

### Q: 如何添加新功能？
A: 按照现有的模块结构添加新的模型、控制器、路由和页面

### Q: 如何部署到生产环境？
A: 参考 Docker 启动指南

## 📝 更新日志

### v1.0.0 (2026-01-31)
- ✅ 项目初始化完成
- ✅ 后端 API 开发完成
- ✅ 前端页面开发完成
- ✅ 前端样式系统完成
- ✅ 数据库种子文件完成
- ✅ 文档编写完成

## 👥 贡献者

- AI Assistant

## 📄 许可证

MIT License

## 🙏 致谢

感谢所有为这个项目做出贡献的人！

---

**项目状态**：✅ 完成
**最后更新**：2026-01-31
**版本**：1.0.0

**开始使用**：[快速开始](#快速开始)
**查看文档**：[文档](#文档)
**常见问题**：[常见问题](#常见问题)