john
a400130c67
Add coach review APIs, pose calibration thresholds, Gitea CI, Kubernetes skeleton, H5 practice page, and mini program tab bar. Co-authored-by: Cursor <cursoragent@cursor.com>
95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
# Happy Up · 儿童 AI 体态管理平台
|
||
|
||
文档驱动 → 产品 Demo → 工程化启动的 monorepo 仓库。
|
||
|
||
## 仓库结构
|
||
|
||
```
|
||
happy-up/
|
||
├── contracts/ # OpenAPI + database.sql（从 doc/ 同步）
|
||
├── apps/
|
||
│ ├── api/ # FastAPI 后端（Sprint 1–5）
|
||
│ ├── web/ # Vue 3 H5 前端（Sprint 4–5）
|
||
│ └── mini/ # 微信小程序壳（Sprint 5）
|
||
├── doc/ # 商业交付文档包 V1.0
|
||
├── scripts/ # 运维/初始化脚本
|
||
├── docker-compose.yml # MySQL 8 + Redis 7 + MinIO
|
||
└── Makefile
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 1. 合伙人 / 产品 Demo（无需后端）
|
||
|
||
```bash
|
||
open "doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/03_技术架构/产品交互Demo.html"
|
||
```
|
||
|
||
Demo 能力（P2）：WebRTC 摄像头预览 · Ghost 跟练 · 真实 PDF 导出 · 28 天趋势 · 三报告对比
|
||
|
||
### 2. 架构文档
|
||
|
||
```bash
|
||
open "doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/03_技术架构/系统架构与建设规划.html"
|
||
```
|
||
|
||
### 3. 研发启动（P3 工程骨架）
|
||
|
||
```bash
|
||
# 启动数据库
|
||
make up
|
||
|
||
# API 开发
|
||
cd apps/api
|
||
python -m venv .venv && source .venv/bin/activate
|
||
pip install -e ".[dev]"
|
||
cp .env.example .env
|
||
make api-dev # 或从根目录: make api-dev
|
||
|
||
# 测试
|
||
make api-test
|
||
|
||
# H5 前端（另开终端）
|
||
cd apps/web && npm install && npm run dev
|
||
|
||
# 微信小程序：微信开发者工具导入 apps/mini
|
||
```
|
||
|
||
- API 文档：http://127.0.0.1:8000/docs
|
||
- H5 开发：http://localhost:5173
|
||
- MinIO 控制台：http://127.0.0.1:9001（minioadmin / minioadmin）
|
||
- 契约单一来源：`doc/.../07_API接口/openapi.yaml`（工程副本在 `contracts/`）
|
||
|
||
## 当前进度
|
||
|
||
| 阶段 | 状态 | 交付物 |
|
||
|------|------|--------|
|
||
| P0 方案 | ✅ | PRD、架构 MD/HTML、OpenAPI、DB 设计 |
|
||
| P1 Demo | ✅ | 产品交互 Demo（跟练/趋势/儿童端/PDF） |
|
||
| P2 Demo 增强 | ✅ | 摄像头预览 + 真实 PDF 导出 |
|
||
| **P3 工程化** | **✅ Starter** | **Git + monorepo + FastAPI 骨架 + Docker** |
|
||
| **Sprint 1** | **✅** | **JWT Auth + 儿童 CRUD 落库 + Demo API 联调** |
|
||
| **Sprint 2** | **✅** | **视频/分析/报告落库 + Redis 队列 + 筛查 Demo 联调** |
|
||
| **Sprint 3** | **✅** | **训练计划/打卡 + Admin 看板 + 全链路 Demo** |
|
||
| **Sprint 4** | **✅** | **本地/MinIO 直传 + AI 骨架 + Vue H5 + 租户隔离** |
|
||
| **Sprint 5** | **✅** | **MediaPipe 评分 + PDF 导出 + 阿里云 OSS + 小程序壳** |
|
||
| **Sprint 6** | **✅** | **报告复核 + 标定 + CI/K8s + H5/小程序 Tab 跟练** |
|
||
| Sprint 7 | 🔜 | 生产镜像、Admin 复核 UI、消息通知 |
|
||
|
||
## 远程仓库
|
||
|
||
- **Gitea**：https://git.tkmind.cn/tkmind/happy-up
|
||
- **Clone**：`ssh://git@git.tkmind.cn:2222/tkmind/happy-up.git`
|
||
|
||
## 部署
|
||
|
||
Kubernetes 骨架见 [deploy/README.md](deploy/README.md)，CI 见 [.gitea/workflows/ci.yaml](.gitea/workflows/ci.yaml)。
|
||
|
||
## 文档索引
|
||
|
||
完整文档目录见 [doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/README.md](doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/README.md)
|
||
|
||
---
|
||
|
||
*本平台 AI 报告用于健康管理建议，不构成医疗诊断。*
|