微信小程序页面迁移校验之前 P5任务处理之前

This commit is contained in:
Neo
2026-03-09 01:19:21 +08:00
parent 263bf96035
commit 6e20987d2f
1112 changed files with 153824 additions and 219694 deletions

View File

@@ -1,7 +1,8 @@
# P6小程序前端 — 任务模块 — miniapp-fe-tasks
> 优先级P6依赖 P3 + P4 + P5
> 优先级P6依赖 P3 + P4 + P5-A
> 预估工作量:大
> P5-B 承接T4 同时细化 P5 应用 4/5 的 Prompt JSON 结构
---
@@ -24,6 +25,9 @@
- 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:备注",不显示具体人名
---
@@ -31,14 +35,22 @@
### task-list任务列表 + 绩效)
- 任务列表:优先级分组、长按操作
- 任务卡片:展示应用 4 的 `summary`(一句话总结)作为 AI 摘要(从 `ai_cache` cache_type=app4_analysis 读取)
- 绩效区域:当月业绩/档位/工资/跳档激励
- 通用组件:爱心 icon、喜好标签、跟/弃 icon
### task-detail任务详情
- 客户信息卡片
- 近期服务记录(时间+时长)
- AI 区域:消费习惯应用3缓存、关系分析+任务建议+一句话总结应用4缓存、话术参考应用5缓存、备注星级应用6
- 备注入口(提交后触发回访完成判定
- 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备注管理
@@ -47,12 +59,27 @@
---
## 小程序前端开发强制规范
> 以下规范适用于本 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 区域)
- [ ] T5实现备注提交功能集成回访完成判定
- 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、预估标记