# 3d-human-motion

**Repository Path**: aicode-design/3d-human-motion

## Basic Information

- **Project Name**: 3d-human-motion
- **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-05-02
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3D Human Motion Recognition & Comparison System

体育训练辅助系统 - 3D人体动作识别与对比

**版本:** v1.4 | **状态:** 已发布

---

## 快速开始

### 环境要求

- Docker & Docker Compose
- Python 3.11+ (本地开发)
- PostgreSQL 15+ (Docker方式不需要)
- Redis 7+ (Docker方式不需要)

### 使用Docker部署

```bash
# 克隆项目
git clone <repository-url>
cd 3d-human-motion

# 启动服务（Linux/Mac）
./start.sh

# 启动服务（Windows）
start.bat

# 或者手动启动
docker-compose up -d
```

### 本地开发

```bash
cd backend

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

# 复制环境变量
cp .env.example .env
# 编辑 .env 设置 SECRET_KEY

# 启动服务
uvicorn app.main:app --reload
```

---

## 环境变量

在 `.env` 文件中配置以下变量：

| 变量 | 说明 | 示例 |
|------|------|------|
| DATABASE_URL | PostgreSQL连接字符串 | postgresql://user:pass@localhost:5432/db |
| REDIS_HOST | Redis主机 | localhost |
| REDIS_PORT | Redis端口 | 6379 |
| SECRET_KEY | JWT签名密钥（必填） | your-secure-random-string |
| CORS_ORIGINS | CORS白名单（逗号分隔） | http://localhost:3000 |
| API_BASE_URL | API基础URL | http://localhost:8000 |
| DEBUG | 调试模式 | false |

---

## API文档

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

---

## 主要API端点

### 认证
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/login` - 用户登录

### 用户与国际化
- `GET /api/users/{id}` - 获取用户信息
- `PUT /api/users/{id}/locale` - 更新语言偏好
- `GET /api/translations/{locale}` - 获取翻译文本

### 动作库
- `GET /api/library/actions` - 获取动作列表
- `POST /api/library/actions` - 创建动作
- `GET /api/library/actions/search` - 搜索动作

### 云端同步
- `POST /api/cloud/actions/upload` - 上传动作到云端
- `GET /api/cloud/actions/download` - 下载云端动作
- `GET /api/cloud/actions/search` - 搜索动作

### 分类管理
- `GET /api/categories` - 获取分类列表
- `POST /api/categories` - 创建分类（教练）

### 官方动作
- `GET /api/official/actions` - 获取官方动作
- `POST /api/official/actions/batch` - 批量导入（管理员）

### 团队
- `POST /api/team/create` - 创建团队
- `POST /api/team/join` - 加入团队
- `GET /api/team/members` - 获取团队成员

### 反馈管理
- `POST /api/feedbacks` - 提交反馈
- `GET /api/feedbacks/user/{id}` - 获取用户反馈历史
- `GET /api/admin/feedbacks` - 管理员获取所有反馈

### 训练数据
- `POST /api/trainings` - 记录训练
- `GET /api/analytics/training-history` - 训练历史
- `GET /api/analytics/progress` - 进步曲线

### 报告
- `GET /api/reports/weekly` - 周报
- `GET /api/reports/monthly` - 月报

### 数据导出
- `POST /api/exports/pdf` - 生成PDF报告
- `POST /api/exports/excel` - 生成Excel报告
- `GET /api/exports` - 获取导出历史
- `GET /api/exports/{id}/download` - 下载导出文件

---

## Docker命令

```bash
# 启动
docker-compose up -d

# 停止
docker-compose down

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

# 重新构建
docker-compose up -d --build

# 清理 volumes
docker-compose down -v
```

---

## 项目结构

```
.
├── backend/                 # FastAPI后端服务
│   ├── app/
│   │   ├── api/            # API路由
│   │   ├── core/           # 核心配置
│   │   ├── models/         # 数据库模型
│   │   ├── schemas/        # Pydantic模型
│   │   └── middleware/     # 中间件
│   ├── tests/              # 测试
│   ├── Dockerfile
│   └── requirements.txt
├── motion_engine/          # 动作检测引擎 (Python)
├── desktop/               # PyQt桌面客户端
├── android_app/           # Android客户端 (Kotlin)
├── ios_app/              # iOS客户端 (Swift)
├── harmony_app/           # 鸿蒙客户端 (ArkTS)
├── docs/                  # 项目文档
│   ├── design/            # 设计文档
│   └── pmp/              # 项目管理文档
├── .planning/             # 规划文档
├── docker-compose.yml
├── start.sh
└── start.bat
```

---

## License

MIT