Neo-ZQYY/docs/prd/specs/P7-miniapp-fe-performance.md

P7：小程序前端 — 绩效模块 — miniapp-fe-performance

优先级：P7（依赖 P2 + P3） 预估工作量：中等

---

需求（Requirements）

用户故事

1. 作为助教，我在绩效页面能看到当月收入、业绩档位、工资预估。
2. 作为助教，我能看到本月/上月的服务记录明细，按天归总。
3. 作为助教，我能看到"我的新客"（首次服务且 2 月内服务 ≤2 次的客户）和"我的常客"（2 月内服务次数最多的客户）。
4. 作为助教，我在业绩明细页能看到每条服务的详情，包括定档折算惩罚展示。

验收标准

• AC1：收入与业绩档位数据从 dws_assistant_salary_calc 正确读取
• AC2：服务记录按天归总展示，支持本月/上月切换
• AC3："我的新客"筛选逻辑正确（该助教首次服务 + 2 月内 + 服务次数 ≤2）
• AC4："我的常客"按服务次数降序，展示次数、小时数、工资合计
• AC5：业绩明细每条展示：结账时间、课程类型、台桌/房间、会员昵称、开始/结束时间、业绩分钟
• AC6：有定档折算惩罚时展示"120分钟（定档折算30分钟）"格式
• AC7：当月数据显示"预估"标记

---

页面清单

performance（我的绩效）

• 收入与业绩档位卡片
• 服务记录明细（按天归总，本月/上月切换）
• 我的新客列表（按最后服务时间排列）
• 我的常客列表（按服务次数降序）
• 服务明细：按天/月归总整合数据

performance-records（业绩明细）

• 口径选择（本月/上月/本周/上周等）
• 业绩列表（每条含：结账时间、课程类型、台桌/房间、会员昵称、开始/结束时间、业绩分钟+折算展示）
• 按天/月归总整合

---

后端 API 需求

API	说明	数据源
GET /api/performance/summary	当月绩效汇总	fdw_etl.dws_assistant_salary_calc
GET /api/performance/service-records	服务记录明细（分页）	fdw_etl.dwd_assistant_service_log
GET /api/performance/my-new-customers	我的新客列表	fdw_etl.dws_assistant_customer_stats
GET /api/performance/my-regulars	我的常客列表	fdw_etl.dws_assistant_customer_stats
GET /api/performance/records	业绩明细（按口径）	fdw_etl.dwd_assistant_service_log + fdw_etl.dws_assistant_daily_detail

---

任务清单

• T1：实现绩效汇总 API（含定档、工资、档位）
• T2：实现服务记录明细 API（按天归总 + 分页）
• T3：实现我的新客/常客 API
• T4：实现业绩明细 API（含定档折算惩罚字段）
• T5：实现 performance 小程序页面
• T6：实现 performance-records 小程序页面
• T7：实现"预估"标记组件（当月/本周数据自动标记）