在前后端开发联调前 的提交20260223

docs/prd/specs/P8-miniapp-fe-boards.md

@@ -0,0 +1,85 @@
+# P8：小程序前端 — 看板模块 — miniapp-fe-boards
+
+> 优先级：P8（依赖 P2 + P3 + P5）
+> 预估工作量：大
+
+---
+
+## 需求（Requirements）
+
+### 用户故事
+
+1. 作为管理者，我在财务看板能看到多维度交叉筛选的财务数据、环比、AI 洞察。
+2. 作为管理者，我在客户看板能按 8 个维度排序查看前 100 名客户。
+3. 作为管理者，我在助教看板能按业绩/工资/客源储值/任务完成等维度排序查看助教。
+4. 作为系统，看板数据需要缓存层以提升查询性能。
+
+### 验收标准
+
+- AC1：财务看板支持 2 组筛选交叉（区域 × 时间），选择非"全部区域"时预收资产板块消失
+- AC2：财务看板环比数据正确计算
+- AC3：财务看板 AI 洞察从缓存读取（应用 2 每日更新）
+- AC4：客户看板 8 个维度筛选正确（最应召回/最大消费潜力/最高余额/最近充值/最高消费60天/最频繁60天/最近到店/最专一）
+- AC5：客户看板"最专一"维度下类型筛选锁定为"不限"
+- AC6：助教看板维度×项目×日期三重筛选交叉正确
+- AC7：看板数据有缓存层，非每次实时查询 FDW
+
+---
+
+## 页面清单
+
+### board-finance（财务看板）
+
+- 筛选器：区域筛选 + 时间筛选（本月/上月/本周/上周/前3月/本季/上季/近6月）
+- 数据板块：收入结构、预收资产（条件隐藏）、支出汇总、平台结算
+- 环比展示
+- AI 智能洞察（应用 2 缓存结果）
+- "问问助手"入口 → chat.html
+
+### board-customer（客户看板）
+
+- 维度筛选（8 个维度，默认"最应召回"）
+- 类型筛选（全部/台球/斯诺克/麻将/团建 + 台费包厢流水过滤）
+- 筛选互斥规则："最专一"锁定类型为"不限"
+- 客户列表（前 100 名）
+- 每个客户卡片：昵称、爱心 icon、喜好标签、关键指标值
+- 右下角 AI 按钮 → chat.html
+
+### board-coach（助教看板）
+
+- 维度筛选：定档业绩最高/最低、工资最高/最低、高客源储值额最高、任务完成最多
+- 项目筛选：全部/中🎱/斯诺克/麻将/团建
+- 日期维度筛选：本月/上月/本周/上周/前3月/本季/上季/近6月
+- 助教列表
+- 右下角 AI 按钮 → chat.html
+
+---
+
+## 后端 API 需求
+
+| API | 说明 | 缓存 |
+|-----|------|------|
+| `GET /api/board/finance` | 财务看板数据（交叉筛选） | 是 |
+| `GET /api/board/finance/ai-insight` | 财务 AI 洞察 | 是（应用2缓存） |
+| `GET /api/board/customers` | 客户看板（维度+类型筛选） | 是 |
+| `GET /api/board/coaches` | 助教看板（维度×项目×日期） | 是 |
+
+### 缓存策略
+
+- 看板数据缓存层：Redis 或内存缓存
+- 缓存粒度：`site_id` + 筛选条件组合
+- 缓存过期：ETL 数据更新后失效（约 1 小时）
+- AI 洞察缓存：从 `biz.ai_cache` 读取（应用 2 每日更新）
+
+---
+
+## 任务清单
+
+- [ ] T1：实现看板缓存层（Redis/内存，按 site_id + 筛选条件）
+- [ ] T2：实现财务看板 API（交叉筛选 + 环比 + 预收资产条件隐藏）
+- [ ] T3：实现客户看板 API（8 维度排序 + 类型筛选 + 互斥规则）
+- [ ] T4：实现助教看板 API（维度×项目×日期三重筛选）
+- [ ] T5：实现 board-finance 小程序页面
+- [ ] T6：实现 board-customer 小程序页面
+- [ ] T7：实现 board-coach 小程序页面
+- [ ] T8：实现通用筛选器组件（时间/维度/项目）