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（无需后端）

open "doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/03_技术架构/产品交互Demo.html"

Demo 能力（P2）：WebRTC 摄像头预览 · Ghost 跟练 · 真实 PDF 导出 · 28 天趋势 · 三报告对比

2. 架构文档

open "doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/03_技术架构/系统架构与建设规划.html"

3. 研发启动（P3 工程骨架）

# 启动数据库
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，CI 见 .gitea/workflows/ci.yaml。

文档索引

完整文档目录见 doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/README.md

---

本平台 AI 报告用于健康管理建议，不构成医疗诊断。