# 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 报告用于健康管理建议，不构成医疗诊断。*