# 健康AI问询助手 - 开发总览

## 项目信息

- **项目名称**: 健康AI问询助手
- **技术栈**: Vue 3 + React Native + Go (Gin) + SQLite
- **开发模式**: 前端原型优先（使用模拟数据）
- **预计模块**: 5大阶段，25个开发任务
- **关联项目**: 保健品商城（外部系统）

---

## 开发阶段总览

> **开发策略**：先完成前端原型（APP + Web），使用模拟数据实现完整交互演示，后续再开发后端并对接。

### 第一阶段：环境搭建
| 序号 | 任务 | 文档 | 状态 |
|------|------|------|------|
| 1.1 | APP React Native 环境搭建 | `01-环境搭建/01-APP-ReactNative环境搭建.md` | ⬜ 待审议 |
| 1.2 | Web 前端 Vue 环境搭建 | `01-环境搭建/02-Web前端Vue环境搭建.md` | ⬜ 待审议 |

### 第二阶段：APP 原型开发（模拟数据）
| 序号 | 任务 | 文档 | 状态 |
|------|------|------|------|
| 2.1 | 项目初始化 + 模拟数据服务 | `02-APP原型开发/01-项目初始化和模拟数据.md` | ⬜ 待审议 |
| 2.2 | 导航和底部Tab设计 | `02-APP原型开发/02-导航和布局设计.md` | ⬜ 待审议 |
| 2.3 | 登录页面原型 | `02-APP原型开发/03-登录页面.md` | ⬜ 待审议 |
| 2.4 | 首页原型 | `02-APP原型开发/04-首页.md` | ⬜ 待审议 |
| 2.5 | 体质辨识页面原型 | `02-APP原型开发/05-体质辨识页面.md` | ⬜ 待审议 |
| 2.6 | AI对话页面原型 | `02-APP原型开发/06-AI对话页面.md` | ⬜ 待审议 |
| 2.7 | 个人中心页面原型 | `02-APP原型开发/07-个人中心页面.md` | ⬜ 待审议 |

### 第三阶段：Web 原型开发（模拟数据）
| 序号 | 任务 | 文档 | 状态 |
|------|------|------|------|
| 3.1 | 项目初始化 + 模拟数据服务 | `03-Web原型开发/01-项目初始化和模拟数据.md` | ⬜ 待审议 |
| 3.2 | 路由和布局设计 | `03-Web原型开发/02-路由和布局设计.md` | ⬜ 待审议 |
| 3.3 | 登录页面原型 | `03-Web原型开发/03-登录页面.md` | ⬜ 待审议 |
| 3.4 | 首页原型 | `03-Web原型开发/04-首页.md` | ⬜ 待审议 |
| 3.5 | 体质辨识页面原型 | `03-Web原型开发/05-体质辨识页面.md` | ⬜ 待审议 |
| 3.6 | AI对话页面原型 | `03-Web原型开发/06-AI对话页面.md` | ⬜ 待审议 |
| 3.7 | 个人中心页面原型 | `03-Web原型开发/07-个人中心页面.md` | ⬜ 待审议 |

### 第四阶段：后端开发
| 序号 | 任务 | 文档 | 状态 |
|------|------|------|------|
| 4.1 | Go环境搭建 + 项目初始化 | `04-后端开发/01-环境搭建和项目初始化.md` | ⬜ 待审议 |
| 4.2 | 数据库和模型设计 | `04-后端开发/02-数据库和模型设计.md` | ⬜ 待审议 |
| 4.3 | 用户认证模块 | `04-后端开发/03-用户认证模块.md` | ⬜ 待审议 |
| 4.4 | 健康调查模块 | `04-后端开发/04-健康调查模块.md` | ⬜ 待审议 |
| 4.5 | 体质辨识模块 | `04-后端开发/05-体质辨识模块.md` | ⬜ 待审议 |
| 4.6 | AI对话模块 | `04-后端开发/06-AI对话模块.md` | ⬜ 待审议 |
| 4.7 | 健康档案模块 | `04-后端开发/07-健康档案模块.md` | ⬜ 待审议 |
| 4.8 | 保健品商城关联模块 | `04-后端开发/08-保健品商城关联模块.md` | ⬜ 待审议 |

### 第五阶段：前后端对接
| 序号 | 任务 | 文档 | 状态 |
|------|------|------|------|
| 5.1 | APP 对接后端 API | `05-前后端对接/01-APP对接后端.md` | ⬜ 待审议 |
| 5.2 | Web 对接后端 API | `05-前后端对接/02-Web对接后端.md` | ⬜ 待审议 |

---

## 状态说明

| 标记 | 含义 |
|------|------|
| ⬜ | 待审议 |
| ✅ | 已通过 |
| 🔄 | 开发中 |
| ✔️ | 已完成 |

---

## 审议流程

1. 按顺序查看每个文档
2. 确认无误后标记"已通过"
3. 如需修改，在对话中说明
4. 通过后开始执行对应开发任务

---

## 依赖关系

```
第一阶段：环境搭建 (并行)
    ├── APP环境 (React Native)
    └── Web环境 (Vue 3)
            ↓
第二阶段：APP 原型开发 ──┐
                        ├── 使用模拟数据，可完整交互演示
第三阶段：Web 原型开发 ──┘
            ↓
第四阶段：后端开发 (顺序)
    环境初始化 → 数据库模型 → 用户认证 → 健康调查 → 体质辨识 → AI对话 → 健康档案 → 保健品关联
            ↓
第五阶段：前后端对接
    APP对接 + Web对接 → 联调测试
```

---

## 模拟数据说明

原型阶段使用本地模拟数据，确保界面可完整交互：

| 模块 | 模拟数据内容 | 数据文件 |
|------|------------|----------|
| 用户认证 | 预设测试账号，模拟登录 | `mock/user.ts` |
| 体质测试 | 60道问卷题目，本地计算结果 | `mock/constitution.ts` |
| 体质结果 | 9种体质详细描述和建议 | `mock/constitution.ts` |
| AI对话 | 预设问答对，模拟多轮对话 | `mock/chat.ts` |
| 产品推荐 | 36条保健品数据 | `mock/products.ts` |

---

## 外部系统关联

| 系统 | 说明 | 对接方式 |
|------|------|----------|
| 保健品商城 | 关联保健品销售系统 | 产品链接跳转（mall_url） |
| 阿里云 AI | 通义千问大模型 | API 调用（后端对接）|

---

## 后续扩展（暂不开发）

| 功能 | 类型 | 备注 |
|------|------|------|
| 会员系统 | 积分制 | 消费/签到积分兑换权益 |