mi-assessment/uniapp/docs/页面清单.md
2026-02-09 08:02:54 +08:00

475 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 学业邑规划 - 小程序页面清单
本文档列出所有小程序页面的详细信息,包括路由、功能、状态和开发优先级。
---
## 一、页面总览
| 序号 | 页面名称 | 路由 | 优先级 | 状态 |
|------|----------|------|--------|------|
| 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. 隐私政策页