康养机器人智能服务平台

项目概述

康养机器人项目是一个集健康监测、情感陪伴、康复训练于一体的智能化养老服务平台。通过多模态数据融合、AI预测分析和主动式关怀，为老年人提供全方位的健康管理服务。

核心功能

1. 多模态健康监测 (已实现)

• ✅ 实时生命体征监测（心率、血压、血氧、体温）
• ✅ 多源数据融合（穿戴设备、视觉、环境传感器）
• ✅ AI异常检测与预警
• ✅ 健康风险预测（提前3-7天）

2. 主动式情感陪伴 (开发中)

• 情绪识别与分析
• 个性化对话系统
• 主动关怀触发机制
• 记忆网络与偏好学习

3. 智能康复训练 (规划中)

• 3D动作捕捉与评估
• 游戏化训练设计
• 自适应难度调节
• 康复进度跟踪

技术架构

├── 微服务架构
│   ├── 健康监测服务 (FastAPI + Python)
│   ├── 陪伴服务 (FastAPI + Python)
│   └── 康复训练服务 (FastAPI + Python)
├── 数据存储
│   ├── MySQL (业务数据)
│   ├── InfluxDB (时序数据)
│   ├── MongoDB (文档数据)
│   └── Redis (缓存)
├── 消息队列
│   └── Kafka
├── 监控系统
│   ├── Prometheus (指标收集)
│   └── Grafana (可视化)
└── API网关
    └── Kong Gateway

快速开始

环境要求

• Docker 20.10+
• Docker Compose 2.0+
• Python 3.9+
• Node.js 16+
• Make

1. 克隆项目

git clone https://github.com/your-org/kangyang-robot.git
cd kangyang-robot

2. 初始化环境

# 给脚本添加执行权限
chmod +x scripts/setup.sh

# 初始化开发环境
./scripts/setup.sh dev

# 或使用Make
make setup

3. 启动服务

# 使用Docker Compose启动所有服务
docker-compose up -d

# 或使用Make
make run-dev

4. 验证服务

服务启动后，可以访问以下地址：

• 健康监测服务: http://localhost:8001
• API文档: http://localhost:8001/docs
• Prometheus监控: http://localhost:9090
• Grafana面板: http://localhost:3001 (admin/admin123)
• Kibana日志: http://localhost:5601

5. 运行测试

# 运行所有测试
make run-tests

# 单元测试
make test-unit

# 集成测试
make test-integration

# 性能测试
make test-performance

API使用示例

上传健康数据

curl -X POST "http://localhost:8001/api/v1/health/data/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_001",
    "timestamp": "2024-01-01T12:00:00",
    "source": "wearable",
    "metrics": {
      "heart_rate": 75,
      "blood_pressure": 120,
      "blood_oxygen": 98
    },
    "confidence": 0.95
  }'

获取健康报告

curl "http://localhost:8001/api/v1/analysis/report/user_001?report_type=daily&format=json"

获取风险预测

curl "http://localhost:8001/api/v1/monitoring/risk-prediction/user_001"

开发指南

项目结构

kangyang-robot/
├── services/                    # 微服务
│   ├── health-monitoring/      # 健康监测服务
│   ├── companion-service/      # 陪伴服务
│   └── rehabilitation-service/ # 康复训练服务
├── frontend/                    # 前端应用
│   ├── web-admin/              # Web管理端
│   └── mobile-app/             # 移动端APP
├── infrastructure/             # 基础设施
│   ├── docker/                 # Docker配置
│   ├── k8s/                    # Kubernetes配置
│   └── terraform/              # 基础设施即代码
├── tests/                      # 测试
│   ├── unit/                   # 单元测试
│   ├── integration/            # 集成测试
│   └── performance/            # 性能测试
├── monitoring/                 # 监控配置
│   ├── prometheus/             # Prometheus配置
│   └── grafana/                # Grafana面板
├── docs/                       # 文档
└── scripts/                    # 脚本工具

添加新功能

1. 在相应的服务目录创建新模块
2. 编写单元测试
3. 更新API文档
4. 提交代码并通过CI/CD检查

代码规范

• Python代码使用Black格式化
• 使用mypy进行类型检查
• 测试覆盖率要求 >85%
• 所有API需要编写文档

部署

开发环境

make run-dev

测试环境

make deploy-staging

生产环境

make deploy-production

监控与运维

查看日志

# 查看特定服务日志
docker logs -f kangyang-health-monitoring

# 使用Make查看日志
make logs

性能监控

1. 访问Grafana: http://localhost:3001
2. 导入预设的Dashboard
3. 查看服务指标

告警配置

告警规则配置在 monitoring/prometheus/rules/ 目录

常见问题

Q: 服务启动失败怎么办？

检查端口占用：

lsof -i :8001
lsof -i :3306

Q: 数据库连接失败？

检查数据库服务：

docker ps | grep mysql
docker logs kangyang-mysql

Q: 如何重置环境？

make clean
make setup

贡献指南

1. Fork项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启Pull Request

技术支持

• 项目文档: docs/
• Issue追踪: GitHub Issues
• 技术架构: docs/完整技术架构与实施方案.md

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

致谢

感谢所有为本项目做出贡献的开发者和合作伙伴。

---

康养机器人 - 让科技温暖生活，用AI守护健康