Initial commit: Happy Up monorepo through Sprint 5.

Document-driven MVP with FastAPI backend, Vue H5, WeChat mini shell, product demo, and Docker dev stack. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-23 11:42:40 +08:00
commit 1aaef71f52
116 changed files with 10550 additions and 0 deletions
@@ -0,0 +1,84 @@
+# 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 | 🔜 | 模型标定、完整小程序、复核工作流、生产部署 |
+
+## 文档索引
+
+完整文档目录见 [doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/README.md](doc/Kids_AI_Posture_Platform_BUSINESS_DELIVERY_V1.0/README.md)
+
+---
+
+*本平台 AI 报告用于健康管理建议，不构成医疗诊断。*