86 lines
5.2 KiB
Markdown
86 lines
5.2 KiB
Markdown
# P6：小程序前端 — 任务模块 — miniapp-fe-tasks
|
||
|
||
> 优先级：P6（依赖 P3 + P4 + P5-A）
|
||
> 预估工作量：大
|
||
> P5-B 承接：T4 同时细化 P5 应用 4/5 的 Prompt JSON 结构
|
||
|
||
---
|
||
|
||
## 需求（Requirements）
|
||
|
||
### 用户故事
|
||
|
||
1. 作为助教，我打开小程序首页看到按优先级排序的任务列表，高优先召回在最上面。
|
||
2. 作为助教，我长按任务可以置顶、放弃（需填原因）、或问 AI。
|
||
3. 作为助教，我点击任务进入详情页，看到客户信息、近期服务记录、AI 分析、备注入口。
|
||
4. 作为助教，我在绩效区域看到当月业绩、档位、工资预估、跳档激励。
|
||
5. 作为助教，我能管理自己的备注（查看、删除需二次确认）。
|
||
|
||
### 验收标准
|
||
|
||
- AC1：任务列表按优先级 0→1→2 分组展示，每组内按分数降序
|
||
- AC2：置顶任务固定在列表顶部，已放弃任务在独立列表
|
||
- AC3：爱心 icon 正确展示（💖>8.5 / 🧡>7 / 💛>5 / 💙<5）
|
||
- AC4：喜好标签正确展示（🎱/斯/🀅/🎤）
|
||
- AC5：跟/弃 icon 正确展示
|
||
- AC6：当月数据显示"预估"标记
|
||
- AC7：跳档激励"到达XXX即得YYY"计算正确
|
||
- AC8：任务卡片展示应用 4 的一句话总结（ai_cache 缓存读取）
|
||
- AC9：备注卡片以打星方式展示应用 6 评分（1-10 分，映射公式：`星数 = score ÷ 2`，5 颗星，支持半星；如 score=7 → 3.5 星）
|
||
- AC10：维客线索提供者按 source 字段显示"By:系统"或"By:备注"，不显示具体人名
|
||
|
||
---
|
||
|
||
## 页面清单
|
||
|
||
### task-list（任务列表 + 绩效）
|
||
- 任务列表：优先级分组、长按操作
|
||
- 任务卡片：展示应用 4 的 `summary`（一句话总结）作为 AI 摘要（从 `ai_cache` cache_type=app4_analysis 读取）
|
||
- 绩效区域：当月业绩/档位/工资/跳档激励
|
||
- 通用组件：爱心 icon、喜好标签、跟/弃 icon
|
||
|
||
### task-detail（任务详情）
|
||
- 客户信息卡片
|
||
- 近期服务记录（时间+时长）
|
||
- AI 区域：
|
||
- 维客线索（应用 8 整合线索 + 人工，读取 `member_retention_clue`；Emoji 作为二级标签、提供者逗号分隔展示）
|
||
- 客户分析（应用 7 缓存：运营策略数组 + 总结）
|
||
- 关系分析 + 任务建议 + 一句话总结（应用 4 缓存，读取应用 8 最新线索）
|
||
- 话术参考（应用 5 缓存）
|
||
- 备注分析评分（应用 6 缓存：1-10 分）
|
||
- 备注入口（提交后触发回访完成判定）；备注弹窗含星星评分（再次服务意愿+再来店可能性，各 1-5 星）：回访任务默认展开评分区域，其他任务类型默认隐藏通过"展开评价"按钮手动打开
|
||
- 备注卡片展示应用 6 的 `score`（1-10 分），以打星方式呈现（`星数 = score ÷ 2`，5 颗星，支持半星；从 `ai_cache` cache_type=app6_note_analysis 读取）
|
||
- 维客线索（应用 8）提供者显示规则：`source=ai_consumption` 显示"By:系统"，`source=ai_note` 显示"By:备注"，不显示具体人名
|
||
- "问问助手"按钮 → chat.html
|
||
|
||
### notes（备注管理）
|
||
- 备注列表
|
||
- 删除操作（二次确认弹窗）
|
||
|
||
---
|
||
|
||
## 小程序前端开发强制规范
|
||
|
||
> 以下规范适用于本 SPEC 中所有小程序页面实现，具有强制约束力。
|
||
|
||
1. **原型图是唯一视觉真相**：`docs/h5_ui/pages/*.html` 中的结构、层次、元素、配色、间距、交互行为是小程序页面实现的唯一参考标准。任何偏离原型图的实现都需要明确的产品确认。
|
||
2. **WXML ≠ HTML**：严禁在小程序中使用 HTML 标签（div/span/p/a/img 等），必须使用小程序原生标签（view/text/image/navigator 等）。
|
||
3. **WXSS ≠ CSS**：使用 rpx 单位、仅支持有限选择器、无 DOM/BOM API、样式隔离机制不同。Tailwind CSS 类名必须手动转换为 WXSS。
|
||
4. **TDesign 优先**：凡 TDesign 组件库能覆盖的 UI 元素，必须使用 TDesign 组件；自定义实现仅限 TDesign 无法覆盖的场景。
|
||
5. **Power 文档优先**：实现前必须加载 `wechat-miniprogram` Power 的相关 steering 文件（`view-layer.md`、`tdesign.md`、`builtin-components.md`），确保语法和组件用法正确。
|
||
6. **项目踩坑指南必读**：实现前必须阅读 `docs/prd/MIGRATION-PLAYBOOK.md` 第六章，该文档是基于本项目实际转换经验的避坑手册，涵盖 WXML/WXSS 差异、事件系统、TDesign 用法、rpx 换算规则及新页面开发 Checklist。
|
||
|
||
---
|
||
|
||
## 任务清单
|
||
|
||
- [ ] T1：实现 task-list 页面（任务列表 + 分组 + 排序）
|
||
- [ ] T2：实现长按操作（置顶/放弃/AI）
|
||
- [ ] T3：实现绩效展示区域（业绩/档位/工资/跳档激励）
|
||
- [ ] T4：实现 task-detail 页面（客户信息 + 服务记录 + AI 区域）
|
||
- T4-a：细化 P5 应用 4（关系分析）Prompt JSON 结构，实现 `service_history`、`assistant_info` 等字段的拼接函数（对应 P5-T7-完整）
|
||
- T4-b：细化 P5 应用 5（话术参考）Prompt JSON 结构，实现拼接函数（对应 P5-T8-完整）
|
||
- [ ] T5：实现备注提交功能（集成回访完成判定 + 星星评分：回访任务默认展开，其他任务类型通过"展开评价"按钮手动打开）
|
||
- [ ] T6：实现 notes 页面（列表 + 删除）
|
||
- [ ] T7：实现通用组件（爱心 icon、喜好标签、跟/弃 icon、预估标记）
|