2026-08-09-empty-features-implementation.md 5.3 KB
小程序空功能实现计划
日期: 2026-08-09 目标: 系统性补齐小程序中空功能，覆盖完整页面、占位按钮、Mock数据、TODO
优先级分类
P0 - 完整空页面（影响核心流程）
| # | 页面 | 问题 | 建议实现 |
|---|---|---|---|
| 1 | member-detail/service-role-apply.vue |
服务角色申请 - 完整空页面 | 对接 applyToTeacher() 接口，实现申请流程 |
| 2 | member-detail/report-detail.vue |
报告详情 - 完整空页面 | 对接 /api/report/detail 接口，展示报告内容 |
| 3 | games/list.vue |
益智小游戏 - 完整空页面 | 对接游戏列表接口，实现游戏入口 |
P1 - 占位按钮（用户可感知但未实现）
| # | 页面 | 提示 | 建议实现 |
|---|---|---|---|
| 4 | body-detail/checkin.vue:228 |
"健康打卡功能即将上线" | 对接 /api/health/checkin 接口 |
| 5 | profile/components/ProfileBadges.vue:108 |
"即将上线" | 对接勋章系统接口，或移除按钮 |
| 6 | home-pages/child-index.vue:688 |
"成就页面开发中" | 对接成就列表接口 |
| 7 | home-pages/child-index.vue:702 |
"即将上线" | 同上 |
| 8 | article-center/index.vue:258 |
"书库即将上线" | 对接文章库接口，或改为引导购买 |
| 9 | promotion/material.vue:189 |
"分享功能开发中" | 接入 onShareAppMessage 分享接口 |
| 10 | diet/record-detail.vue:156 |
"编辑功能开发中" | 实现饮食记录编辑功能 |
P2 - Mock 数据（有数据展示但来自硬编码）
| # | 文件 | 问题 | 建议实现 |
|---|---|---|---|
| 11 | mind-detail/family-dashboard.vue:278-355 |
运势数据硬编码 mock（6个函数） | 对接 /api/mind/fortune/* 接口 |
| 12 | mind-detail/family-dashboard.vue:685-694 |
周报 PDF 生成硬编码 | 对接 PDF 生成接口 |
| 13 | assessment/purchase.vue |
mock 支付流程 | 使用真实支付接口 |
| 14 | parent/market/detail.vue:116 |
memberId: 1 硬编码 |
改用实际选中的成员 |
| 15 | guide/register/index.vue:218 |
TODO 上传图片 | 实现图片上传到服务器 |
P3 - TODO 清理（代码注释未实现）
| # | 文件 | TODO | 状态 |
|---|---|---|---|
| 16 | mind-detail/family-dashboard.vue:278 |
对接运势接口 | P2 |
| 17 | mind-detail/family-dashboard.vue:296 |
对接周报接口 | P2 |
| 18 | mind-detail/family-dashboard.vue:320 |
对接月报接口 | P2 |
| 19 | mind-detail/family-dashboard.vue:345 |
对接报告接口 | P2 |
| 20 | mind-detail/family-dashboard.vue:685 |
PDF 生成 | P2 |
| 21 | mind-detail/family-dashboard.vue:694 |
PDF 上传 | P2 |
| 22 | assessment/purchase.vue:128 |
获取任务模板列表 | 对接 /api/assessment/task-templates |
| 23 | guide/register/index.vue:218 |
图片上传 | P2 |
实施方案
Task 1: 完整空页面（P0）
文件: member-detail/service-role-apply.vue
对接接口: POST /api/guide/teacher/apply
实现:
- 获取当前用户信息
- 填写申请表单（姓名、电话、资质）
- 提交申请，展示审核状态
文件: member-detail/report-detail.vue
对接接口: POST /api/report/detail
实现:
- 从 URL 获取 reportId
- 调用接口获取报告详情
- 展示报告内容（健康报告/测评报告）
文件: games/list.vue
对接接口: POST /api/games/list
实现:
- 获取游戏列表
- 展示游戏卡片
- 点击跳转游戏详情/开始游戏
Task 2: 占位按钮（P1）
文件: body-detail/checkin.vue
对接接口: POST /api/health/checkin
实现: 移除 toast，正常调用打卡接口
文件: profile/components/ProfileBadges.vue
对接接口: POST /api/user/badges
实现: 获取勋章列表，展示已获得的勋章
文件: home-pages/child-index.vue
对接接口: POST /api/achievement/list
实现: 获取孩子成就列表
文件: article-center/index.vue
方案: 对接文章库接口，或改为引导购买课程
文件: promotion/material.vue
对接接口: 微信分享 API
实现: 接入 onShareAppMessage，分享当前页面
文件: diet/record-detail.vue
对接接口: POST /api/diet/record/update
实现: 实现编辑功能
Task 3: Mock 数据（P2）
文件: mind-detail/family-dashboard.vue
对接接口:
POST /api/mind/fortune- 今日运势POST /api/mind/fortune/week- 本周运势POST /api/mind/fortune/month- 本月运势POST /api/mind/fortune/reports- 报告列表
文件: assessment/purchase.vue
对接接口: POST /api/payment/checkout
实现: 使用真实支付流程
文件: parent/market/detail.vue
修复: 改用 this.activeChildId 替代硬编码 1
文件: guide/register/index.vue
对接接口: POST /api/file/upload
实现: 实现图片上传功能
验收标准
- P0: 3 个完整空页面可正常使用
- P1: 9 个占位按钮有实际功能或已隐藏
- P2: 4 处 Mock 数据已对接真实接口
- P3: 所有 TODO 已解决或转为正式任务
工作量估算
| 优先级 | 数量 | 估算 |
|---|---|---|
| P0 | 3 | 各 2-3 小时 |
| P1 | 9 | 各 1-2 小时 |
| P2 | 4 | 各 1-2 小时 |
| P3 | 23 | 部分已包含在 P0-P2 |
| 总计 | 约 30-40 小时 |