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

docs/prd/specs/P9-miniapp-fe-details.md

@@ -1,7 +1,8 @@
 # P9：小程序前端 — 详情与对话模块 — miniapp-fe-details
 
-> 优先级：P9（依赖 P3 + P4 + P5）
+> 优先级：P9（依赖 P3 + P4 + P5-A）
 > 预估工作量：大
+> P5-B 承接：T1 同时细化 P5 应用 3/6/7 的 Prompt JSON 结构
 
 ---
 
@@ -37,7 +38,8 @@
   - 商城订单：助教列表（花名+级别+课程类型+服务时长+定档绩效）、支付金额、食品酒水总金额
   - 充值：充值金额、支付方式
 - 备注列表
-- AI 消费习惯分析（应用 3 缓存）
+- AI 维客线索（应用 8 整合线索 + 人工，读取 `member_retention_clue`；Emoji 作为二级标签、提供者逗号分隔展示）
+- AI 客户分析（应用 7 缓存：运营策略数组 + 总结，结账单出现后自动生成；从 `ai_cache` cache_type=app7_customer_analysis 读取）
 - "问问助手"入口 → chat.html
 
 ### coach-detail（助教详情）
@@ -81,22 +83,68 @@
 
 ### 消费记录 settle_type 区分
 
-需要查库确认的字段（待 P1 完成后验证）：
-- 台桌结账：`settle_type` 对应值（需查 `dwd_settlement_head`）
-- 商城订单：`settle_type` 对应值
-- 充值：从 `dwd_recharge_order` 单独查询
+### settle_type 与消费记录类型映射（已校准，数据源：DWD-DOC 01-业务全景）
 
-### 正价金额字段（待用户复核）
+| settle_type | 含义 | 数量占比 | 消费记录样式 |
+|:-----------:|------|---------|-------------|
+| 1 | 台桌结账 | 78.6% | 下沉到 `dwd_table_fee_log` 台费明细 |
+| 3 | 商城订单 | 21.4% | 助教列表 + 支付金额 + 食品酒水 |
+| 5 | 正常充值 | — | 从 `dwd_recharge_order` 单独查询 |
+| 7 | 充值退款 | 极少（10 笔） | 不在消费记录中展示 |
+| 6 | 结算退款 | 极少（1 笔） | 不在消费记录中展示 |
 
-需要在 `dwd_settlement_head` 或相关 DWS 表中确认：
-- `original_amount` vs `total_amount` vs 其他字段
-- 此项标记为"需用户复核"
+### 金额字段说明（已校准，数据源：DWD-DOC 02-账务全景 + consume 口径文档）
+
+⚠️ 不得直接使用 `consume_money`（三种历史口径混合，不稳定）。
+
+正价金额（消费项目合计，全时期一致）：
+```sql
+items_sum = table_charge_money + goods_money + assistant_pd_money
+          + assistant_cx_money + electricity_money
+```
+
+实付金额需按支付渠道拆分展示：
+| 支付渠道 | 字段 | 说明 |
+|----------|------|------|
+| 线上支付 | `pay_amount` | 不含 balance，= `point_amount` + `cash_amount` |
+| 储值卡 | `balance_amount` | 独立渠道，= `recharge_card_amount` + `gift_card_amount` |
+| 团购券抵扣 | `coupon_amount` | 门店实际抵扣额 |
+| 会员折扣 | `member_discount_amount` | 仅 settle_type=1 |
+| 台费调整 | `adjust_amount` | 手动调价 |
+| 抹零 | `rounding_amount` | 收支平衡减项 |
+
+团购券三层价格体系（展示时注意区分）：
+- 顾客支付价 → `PCR.sale_price`
+- 平台结算价 → `SH.pl_coupon_sale_amount`（= SUM(GR.ledger_unit_price)）
+- 门店抵扣价 → `SH.coupon_amount`（= SUM(GR.ledger_amount)）
+
+已知限制：
+- `online_pay_channel` 全为 0，无法区分微信/支付宝（聚合支付接入）
+- `settlement_head_ex` 中 `payment_method`、`is_use_coupon`、`is_activity` 等字段全为 0，不可用
+- 团购券与会员折扣不叠加
+- 2025-11-09 前台费明细 `is_delete=1`，历史数据不完整
+
+---
+
+## 小程序前端开发强制规范
+
+> 以下规范适用于本 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：实现客户详情 API
+  - T1-a：细化 P5 应用 3（维客线索）Prompt JSON 结构，实现 `consumption_records`、`member_cards` 等字段的拼接函数（对应 P5-T6-完整）
+  - T1-b：细化 P5 应用 6（备注分析）Prompt JSON 结构，实现 `consumption_data` 字段的拼接函数（对应 P5-T9-完整）
+  - T1-c：细化 P5 应用 7（客户分析）Prompt JSON 结构，实现 `objective_data` 字段的拼接函数（对应 P5-T10-完整）
 - [ ] T2：实现消费记录分页 API（三种样式区分 + 懒加载）
 - [ ] T3：实现客户指数总览 API
 - [ ] T4：实现助教详情 API