主题
店长端小程序 — 统计报表分析
上级文档：店长端小程序
背景与目标
店长需要在手机端快速掌握门店经营状态，并可按时间维度追踪收入、会员、到店、开门异常等核心经营指标。本模块用于提供“近实时看板 + 历史趋势报表”的一体化能力。
需求范围
- 首页经营概览看板
- 核心指标卡片
- 趋势图与排行榜
- 时间筛选与门店切换
- 报表口径说明
页面路由
| 路由 | 页面 | 说明 |
|---|---|---|
/pages/dashboard/index | 首页看板 | 默认展示今日核心经营概况和异常提醒 |
/pages/report/index | 报表分析页 | 展示历史趋势、排行、结构分析 |
核心指标范围
1. 营收指标
- 今日营收
- 昨日营收
- 本月累计营收
- 支付订单数
- 支付转化率
- 客单价
- 退款金额
- 退款订单数
2. 会员指标
- 今日新增会员数
- 今日续费会员数
- 当前有效会员总数
- 今日到期会员数
- 近 7 天到期会员数
- 流失会员数
- 体验卡转正式会员转化数
3. 到店与门禁指标
- 今日进店人次
- 今日独立到店人数
- 刷脸进门成功次数
- 远程开门次数
- 开门失败次数
- 异常开门次数
- 高峰时段分布
4. 商品与销售结构指标
- 套餐销量排行
- 套餐营收排行
- 新客首购套餐占比
- 次卡 / 月卡 / 季卡 / 年卡销售占比
- 外部券码兑换量
5. 用户行为与服务指标
- 登录 UV
- 下单人数
- 未支付订单数
- 人脸录入完成率
- 淋浴使用次数
- 客服咨询触发次数
页面设计
首页看板
- 顶部展示当前门店、日期快捷切换、异常提醒数量
- 第一屏展示“今日核心指标卡片”
- 第二屏展示营收趋势、到店趋势、会员变化趋势
- 第三屏展示套餐销售排行、异常事件摘要
- 保留“控制开门”快捷入口
报表分析页
- 支持按
今日 / 昨日 / 近7日 / 近30日 / 本月 / 自定义时间筛选 - 支持按门店切换
- 支持切换报表 Tab：
经营概览 / 会员分析 / 到店分析 / 销售分析 / 异常分析 - 每个 Tab 至少包含指标卡 + 趋势图 + 明细列表/排行
功能需求
1. 首页经营看板
目标：
让店长在进入小程序后 10 秒内看到门店当天经营核心状态。
前置条件：
- 已登录且已选定当前门店
触发方式：
- 进入首页
- 下拉刷新
- 切换门店
主流程：
- 调用
GET /api/v1/manager/dashboard/overview - 返回当前门店当日核心指标、异常摘要、趋势简表
- 前端按卡片和趋势图展示
- 用户点击指标卡可进入报表分析页对应 Tab
业务规则：
- 今日看板数据默认近实时刷新
- 经营指标以当前门店为统计口径
- 异常提醒至少包括：开门失败、设备离线、到期会员提醒、退款异常
异常/边界：
- 接口失败时保留页面骨架并提供重试
- 某项指标暂无数据时展示
0，不可留空
验收标准：
- 首页进入后可看到 8 个以上核心卡片指标
- 切换门店后看板数据同步变化
2. 历史趋势报表
目标：
支持店长对门店经营情况做周/月维度分析，而不只停留在当日快照。
前置条件：
- 已登录
触发方式：
- 点击首页指标卡
- 进入报表分析页
主流程：
- 用户选择时间范围和报表 Tab
- 调用
GET /api/v1/manager/reports - 服务端返回指标汇总、趋势数据、排行数据和口径说明
- 前端渲染折线图、柱状图、占比图和明细列表
业务规则：
- 自定义时间范围默认最大支持 90 天
- 趋势图默认按天展示，超过 31 天时可按周汇总
- 排行榜至少展示前 5 名套餐或来源项
- 财务类数据需标注“结算中/已结算”状态
异常/边界：
- 时间范围过大时需提示缩小查询范围
- 服务端未返回某图表数据时显示空态文案
验收标准：
- 每个报表 Tab 至少展示 1 组趋势图和 1 组明细/排行
- 用户可在 2 次点击内切换到任意核心指标分析视图
3. 数据口径与刷新策略
目标：
保证店长理解报表数字含义，减少“为什么对不上”的沟通成本。
业务规则：
- 近实时数据建议 5 分钟内刷新一次
- 涉及退款、结算、财务入账的数据允许 T+1 校正
- 每个报表 Tab 底部展示统计口径说明和最后更新时间
- 指标定义由服务端统一输出，前端仅做展示
异常/边界：
- 若数据仍在计算中，需展示“数据更新中”
- 若门店当天无营业数据，仍需展示零值看板
验收标准：
- 每个报表页均能看到“最后更新时间”
- 财务数据与日结报表口径差异有明确说明
待确认问题
- 是否需要支持报表截图分享或导出
- 区域督导是否需要同屏对比多个门店数据