# 学业邑规划 - 小程序页面清单

本文档列出所有小程序页面的详细信息，包括路由、功能、状态和开发优先级。

---

## 一、页面总览

| 序号 | 页面名称 | 路由 | 优先级 | 状态 |
|------|----------|------|--------|------|
| 1 | 首页 | /pages/index/index | P0 | 待开发 |
| 2 | 团队页 | /pages/team/index | P0 | 待开发 |
| 3 | 我的页 | /pages/mine/index | P0 | 待开发 |
| 4 | 登录页 | /pages/login/index | P0 | 待开发 |
| 5 | 个人资料页 | /pages/mine/profile/index | P1 | 待开发 |
| 6 | 业务详情页 | /pages/business/detail/index | P1 | 待开发 |
| 7 | 测评-信息填写 | /pages/assessment/info/index | P0 | 待开发 |
| 8 | 测评-答题页 | /pages/assessment/questions/index | P0 | 待开发 |
| 9 | 测评-生成中 | /pages/assessment/loading/index | P0 | 待开发 |
| 10 | 测评-结果页 | /pages/assessment/result/index | P0 | 待开发 |
| 11 | 我的订单 | /pages/order/list/index | P1 | 待开发 |
| 12 | 往期测评 | /pages/assessment/history/index | P1 | 待开发 |
| 13 | 学业规划-规划师 | /pages/planner/list/index | P2 | 待开发 |
| 14 | 学业规划-预约 | /pages/planner/book/index | P2 | 待开发 |
| 15 | 邀请新用户 | /pages/invite/index | P2 | 待开发 |
| 16 | 关于页 | /pages/about/index | P3 | 待开发 |
| 17 | 用户协议 | /pages/agreement/user/index | P3 | 待开发 |
| 18 | 隐私政策 | /pages/agreement/privacy/index | P3 | 待开发 |

**优先级说明**：
- P0：核心功能，必须首先完成
- P1：重要功能，核心功能完成后开发
- P2：扩展功能，可延后开发
- P3：辅助功能，最后开发

---

## 二、TabBar 页面

### 2.1 首页 (P0)

**路由**：`/pages/index/index`

**设计图**：`docs/设计图/首页.png`

**功能描述**：
- 展示公司介绍性内容
- Banner 轮播图（可跳转）
- 测评入口列表
- 底部宣传长图

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| Banner 列表 | GET /api/home/getBannerList | 轮播图数据 |
| 测评入口 | GET /api/home/getAssessmentList | 测评类型列表 |
| 宣传图 | GET /api/home/getPromotionList | 底部宣传图 |

**交互逻辑**：
- 点击 Banner → 根据跳转类型跳转
- 点击已上线测评 → 进入测评流程
- 点击即将上线测评 → 弹出提示"该测评暂未开放"

---

### 2.2 团队页 (P0)

**路由**：`/pages/team/index`

**设计图**：`docs/设计图/团队.png`

**功能描述**：
- 展示团队介绍图片

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 团队介绍 | GET /api/team/getInfo | 团队介绍图片 |

---

### 2.3 我的页 (P0)

**路由**：`/pages/mine/index`

**设计图**：
- `docs/设计图/我的-未登录.png`
- `docs/设计图/我的-登录页.png`
- `docs/设计图/我的-退出登录.png`

**功能描述**：
- 未登录：显示"点击登录"
- 已登录：显示头像、昵称、UID
- 常用功能：我的订单、往期测评、联系我们、邀请新用户（合伙人可见）
- 其他功能：关于、用户协议、隐私政策、退出登录

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 用户信息 | GET /api/user/getProfile | 用户基本信息 |

**交互逻辑**：
- 未登录点击头像区域 → 跳转登录页
- 点击各功能入口 → 跳转对应页面
- 点击退出登录 → 弹出二次确认弹窗

---

## 三、登录相关

### 3.1 登录页 (P0)

**路由**：`/pages/login/index`

**设计图**：`docs/设计图/登录页.png`

**功能描述**：
- 微信一键登录（获取手机号）
- 用户协议和隐私政策勾选

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 登录 | POST /api/user/login | 微信登录 |

**交互逻辑**：
1. 用户点击登录按钮
2. 调用 `wx.login()` 获取 code
3. 调用 `wx.getPhoneNumber()` 获取加密手机号
4. 调用后端登录接口
5. 保存 token，跳转回原页面

---

### 3.2 个人资料页 (P1)

**路由**：`/pages/mine/profile/index`

**设计图**：`docs/设计图/个人资料.png`

**功能描述**：
- 查看/修改头像
- 查看/修改昵称
- 查看 UID（不可修改）

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 用户信息 | GET /api/user/getProfile | 获取用户信息 |
| 更新信息 | POST /api/user/updateProfile | 更新昵称 |
| 更新头像 | POST /api/user/updateAvatar | 更新头像 |

---

## 四、测评相关

### 4.1 测评-信息填写页 (P0)

**路由**：`/pages/assessment/info/index`

**设计图**：
- `docs/设计图/测评-个人信息填写.png`
- `docs/设计图/测评-个人信息填写2.png`
- `docs/设计图/测评-个人信息填写3.png`
- `docs/设计图/测评-个人信息填写4.png`

**功能描述**：
- 顶部测评介绍（后台配置）
- 填写基本信息：姓名、手机号、性别、年龄、学业阶段、省市区
- 两个入口按钮：支付测评、邀请码免费测评

**表单字段**：
| 字段 | 类型 | 必填 | 验证规则 |
|------|------|------|----------|
| 姓名 | 文本 | 是 | 非空 |
| 手机号 | 文本 | 是 | 11位手机号格式 |
| 性别 | 单选 | 是 | 男/女 |
| 年龄 | 下拉 | 是 | 10-50岁 |
| 学业阶段 | 下拉 | 是 | 6个选项 |
| 省份 | 下拉 | 是 | 省份列表 |
| 城市 | 下拉 | 是 | 城市列表 |
| 区县 | 下拉 | 是 | 区县列表 |

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 测评介绍 | GET /api/assessment/getIntro | 顶部介绍内容 |
| 验证邀请码 | POST /api/assessment/verifyInviteCode | 验证邀请码 |
| 创建订单 | POST /api/order/create | 创建测评订单 |
| 发起支付 | POST /api/order/pay | 拉起微信支付 |

**交互逻辑**：
- 有未填写项 → 按钮灰色不可点击
- 点击支付按钮 → 验证信息 → 创建订单 → 拉起支付
- 点击邀请码按钮 → 验证信息 → 弹出邀请码输入框 → 验证邀请码

---

### 4.2 测评-答题页 (P0)

**路由**：`/pages/assessment/questions/index`

**设计图**：
- `docs/设计图/测评-题目.png`
- `docs/设计图/测评-提交题目检验空题.png`

**功能描述**：
- 展示所有题目（80道）
- 每题10个选项
- 底部提交按钮
- 提交时检测未答题目

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 题目列表 | GET /api/assessment/getQuestionList | 获取所有题目 |
| 提交答案 | POST /api/assessment/submitAnswers | 提交测评答案 |

**交互逻辑**：
- 点击提交 → 检测未答题目
- 有未答题 → 弹窗显示未答题号
- 全部已答 → 提交答案 → 跳转生成中页面

---

### 4.3 测评-生成中页 (P0)

**路由**：`/pages/assessment/loading/index`

**设计图**：`docs/设计图/测评-等待测评.png`

**功能描述**：
- 显示加载动画
- 提示文字
- 轮询查询报告状态
- 生成完成自动跳转

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 报告状态 | GET /api/assessment/getResultStatus | 查询报告生成状态 |

---

### 4.4 测评-结果页 (P0)

**路由**：`/pages/assessment/result/index`

**设计图**：（需补充）

**功能描述**：
- 展示测评报告
- 八大智能分析（雷达图）
- 个人特质分析
- 40项细分能力
- 其他分析报告
- 保存到本地（PDF）

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 测评结果 | GET /api/assessment/getResult | 获取完整测评报告 |

---

### 4.5 往期测评页 (P1)

**路由**：`/pages/assessment/history/index`

**设计图**：`docs/设计图/往期测评-空状态.png`

**功能描述**：
- 展示已完成的测评列表
- 显示测评日期、订单编号、测评项目、报告状态

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 测评记录 | GET /api/assessment/getHistoryList | 获取往期测评列表 |

---

## 五、订单相关

### 5.1 我的订单页 (P1)

**路由**：`/pages/order/list/index`

**设计图**：
- `docs/设计图/我的订单.png`
- `docs/设计图/我的订单-空状态.png`

**功能描述**：
- 展示所有订单
- 显示订单日期、编号、项目、金额、状态
- 根据状态显示不同操作按钮

**订单状态**：
| 状态 | 说明 | 操作 |
|------|------|------|
| 待测评 | 已支付，未答题 | 开始测评 |
| 测评生成中 | 已答题，生成中 | - |
| 已测评 | 报告已生成 | 查看结果 |
| 退款中 | 申请退款中 | - |
| 已退款 | 退款完成 | - |
| 已支付 | 学业规划订单 | - |

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 订单列表 | GET /api/order/getList | 获取订单列表 |

---

## 六、学业规划

### 6.1 规划师选择页 (P2)

**路由**：`/pages/planner/list/index`

**设计图**：`docs/设计图/学业规划.png`

**功能描述**：
- 展示规划师列表
- 显示照片、姓名、介绍、价格

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 规划师列表 | GET /api/planner/getList | 获取规划师列表 |

---

### 6.2 规划预约页 (P2)

**路由**：`/pages/planner/book/index`

**设计图**：
- `docs/设计图/学业规划2.png`
- `docs/设计图/学业规划3.png`
- `docs/设计图/学业规划4.png`

**功能描述**：
- 选择预约日期和时间
- 填写个人信息
- 根据年级动态显示成绩字段
- 支付预约费

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 预约 | POST /api/planner/book | 提交预约信息 |

---

## 七、分销相关

### 7.1 邀请新用户页 (P2)

**路由**：`/pages/invite/index`

**设计图**：
- `docs/设计图/邀请新用户.png`
- `docs/设计图/邀请新用户-二维码.png`
- `docs/设计图/邀请新用户-提现金额.png`
- `docs/设计图/邀请新用户-提现记录.png`

**功能描述**：
- 邀请规则说明
- 生成邀请二维码
- 分享邀请链接
- 已提现/待提现金额
- 申请提现
- 提现记录
- 邀请记录列表

**访问权限**：仅合伙人及以上可见

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 邀请信息 | GET /api/invite/getInfo | 获取邀请信息 |
| 生成二维码 | GET /api/invite/getQrcode | 生成邀请二维码 |
| 邀请记录 | GET /api/invite/getRecordList | 获取邀请记录 |
| 佣金信息 | GET /api/invite/getCommission | 获取佣金信息 |
| 申请提现 | POST /api/invite/applyWithdraw | 申请提现 |
| 提现记录 | GET /api/invite/getWithdrawList | 获取提现记录 |

---

## 八、其他页面

### 8.1 业务详情页 (P1)

**路由**：`/pages/business/detail/index`

**设计图**：`docs/设计图/业务详情页.png`

**功能描述**：
- 展示业务介绍长图
- 底部"点击参与"按钮（可选）

---

### 8.2 关于页 (P3)

**路由**：`/pages/about/index`

**设计图**：`docs/设计图/关于.png`

**功能描述**：
- 显示 LOGO
- 显示版本号

---

### 8.3 用户协议页 (P3)

**路由**：`/pages/agreement/user/index`

**设计图**：`docs/设计图/用户／隐私协议.png`

**功能描述**：
- 显示用户协议内容

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 用户协议 | GET /api/system/getAgreement | 获取用户协议 |

---

### 8.4 隐私政策页 (P3)

**路由**：`/pages/agreement/privacy/index`

**设计图**：`docs/设计图/用户／隐私协议.png`

**功能描述**：
- 显示隐私政策内容

**数据来源**：
| 数据 | 接口 | 说明 |
|------|------|------|
| 隐私政策 | GET /api/system/getPrivacy | 获取隐私政策 |

---

## 九、开发顺序建议

### 第一阶段（P0 核心功能）
1. 项目初始化 + 基础框架
2. TabBar 框架（首页、团队、我的骨架）
3. 登录页 + 登录流程
4. 首页完整功能
5. 测评流程（信息填写 → 答题 → 生成中 → 结果）

### 第二阶段（P1 重要功能）
6. 我的页完整功能
7. 个人资料页
8. 我的订单页
9. 往期测评页
10. 业务详情页
11. 团队页

### 第三阶段（P2 扩展功能）
12. 学业规划-规划师选择
13. 学业规划-预约
14. 邀请新用户（分销功能）

### 第四阶段（P3 辅助功能）
15. 关于页
16. 用户协议页
17. 隐私政策页