启蒙助手 MVP

基于 AI 的学龄前亲子启蒙助手 —— 帮家长"会教"，让孩子"爱学"。

技术栈

层级	技术
前端	Taro 3.6 + React 18 + TypeScript
后端	Python 3.12 + FastAPI + SQLAlchemy 2.0
数据库	PostgreSQL 16 + Redis 7
AI	OpenAI / 通义千问 / 文心一言（可切换）
部署	Docker Compose

项目结构

qimeng-mvp/
├── backend/                    # FastAPI 后端
│   ├── app/
│   │   ├── api/                # API 路由
│   │   │   ├── auth.py         # 微信登录认证
│   │   │   ├── children.py     # 儿童管理
│   │   │   ├── assessment.py   # 发展评估
│   │   │   ├── activities.py   # 活动推荐
│   │   │   ├── checkin.py      # 打卡记录
│   │   │   └── ai_chat.py     # AI 育儿助手
│   │   ├── core/               # 核心配置
│   │   │   ├── config.py       # 环境配置
│   │   │   ├── database.py     # 数据库连接
│   │   │   └── security.py     # JWT 认证
│   │   ├── models/             # 数据库模型
│   │   ├── schemas/            # Pydantic 校验
│   │   ├── services/           # 业务逻辑
│   │   │   ├── ai_provider.py  # AI 多模型抽象层
│   │   │   └── prompts.py      # Prompt 模板库
│   │   └── main.py             # 应用入口
│   ├── seeds/                  # 种子数据
│   ├── alembic/                # 数据库迁移
│   ├── requirements.txt
│   └── Dockerfile
├── frontend/                   # Taro 小程序前端
│   ├── src/
│   │   ├── pages/
│   │   │   ├── index/          # 首页（每日活动推荐）
│   │   │   ├── assessment/     # 发展评估
│   │   │   ├── activity/       # 活动详情
│   │   │   ├── checkin/        # 打卡记录
│   │   │   └── profile/        # 个人中心 + AI 助手
│   │   ├── services/
│   │   │   └── api.ts          # API 请求封装
│   │   └── app.config.ts       # 小程序配置
│   └── package.json
├── docker-compose.yml
└── README.md

快速启动

1. 启动基础设施（PostgreSQL + Redis）

docker compose up -d db redis

2. 启动后端

cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # macOS/Linux

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

# 配置环境变量
cp .env.example .env
# 编辑 .env，填入 AI API Key 等配置

# 初始化数据库（建表 + 种子数据）
python scripts/init_db.py

# 启动开发服务器
uvicorn app.main:app --reload --port 8000

API 文档访问：http://localhost:8000/docs

3. 启动前端

cd frontend

# 安装依赖
npm install

# 开发模式（微信小程序）
npm run dev:weapp

# 开发模式（H5，浏览器调试用）
npm run dev:h5

4. 一键 Docker 启动（全部）

docker compose up -d

核心功能

API 接口一览

接口	方法	说明
/api/v1/auth/wechat-login	POST	微信登录
/api/v1/auth/dev-login	POST	开发快速登录
/api/v1/children/	GET/POST	儿童列表/添加
/api/v1/assessments/questions	GET	获取评估题目
/api/v1/assessments/	POST	提交评估（AI 生成报告）
/api/v1/activities/daily/{child_id}	GET	获取今日推荐活动
/api/v1/activities/generate/{child_id}	POST	AI 即时生成活动
/api/v1/checkins/	POST	打卡
/api/v1/checkins/{child_id}/stats	GET	打卡统计
/api/v1/ai/chat	POST	AI 育儿助手对话
/api/v1/ai/chat/stream	POST	AI 流式对话（SSE）

AI 服务切换

在 .env 文件中修改 AI_PROVIDER 即可切换：

# 可选值：openai / qianwen / wenxin
AI_PROVIDER=openai

小程序页面

页面	路径	功能
首页	/pages/index/index	每日活动推荐、打卡统计
评估	/pages/assessment/index	15 题发展评估问卷、AI 报告
活动详情	/pages/activity/index	步骤引导、家长话术、打卡
打卡	/pages/checkin/index	打卡日历、连续天数、历史
我的	/pages/profile/index	登录、儿童管理、AI 助手

环境要求

• Python >= 3.10
• Node.js >= 16
• Docker & Docker Compose
• 微信开发者工具（小程序调试）

License

本项目采用 AGPL-3.0 许可协议开源。基于本项目的修改版本及通过网络提供服务的衍生服务，须以相同协议开源。