# 模块 PRD:拼团漏斗

> 模块级详规。平台定位/IA/路线见 [docs/01](../01-产品需求-MVP.md);取数契约见 [docs/02](../02-技术架构.md) §5,数据表见 [docs/03](../03-数据契约.md) §11,视觉/交互见 [docs/04](../04-设计规范.md),接口见 [docs/06](../06-接口文档.md)。

| 项 | 内容 |
|----|----|
| 落点 | `行为分析 > 漏斗分析 > 拼团漏斗`(L3) |
| 状态 | **可用(MVP,已内网上线)** |
| 视图 | `漏斗`(固定 5 步快照)+ `趋势`(按日折线)两 Tab |

## 1. 漏斗定义

固定的**拼团转化漏斗**,5 步固定顺序:

**启动 → 曝光 → 拼团详情 → 下单 → 成功**(`start / show / detail / order / paid`)。

- 每层 UV = 该步骤事件在所选周期内的独立用户数。
- 非递进、不要求按序完成;步骤顺序只影响展示与相邻转化率口径。
- 相邻层转化率 = 当前层 UV / 上一层 UV;相邻层流失率 = 1 − 转化率。
- 第 1 层转化率/流失率为空(展示"—",不为 100%/0)。

## 2. 时间能力

三种周期(数据 **T+1**,最大可查日**始终为昨日**;今天不可查):

- **单日**:看某一天的当日漏斗。配**常驻日历**,默认昨日,可回溯任意历史日;上限昨日(今天/未来禁选)。
- **近 7 天 / 近 30 天**:滚动窗口,取最新 as-of 快照(截至昨日);**无历史**(数据源只保留最新一行)。

取数路由与字段见 `docs/02` §5(v3)与 `docs/03` §11。

## 3. 漏斗视图(视觉/交互定稿见 `docs/04`)

- **时间控件**(标题行右):单日(默认昨日,按钮只显日期)+ 近 7 天 / 近 30 天 segmented。
- **结果图表区**:ECharts 漏斗图,每层 UV + 块比例。
- **结果表格区**:步骤名 / UV / 转化率 / 流失率。
- **范围文案**:单日不显;近 7/30 天显示 `起 ~ 止` 日期范围。
- **状态**:`ready` 出图表+表格;`missing` 出「暂无数据」空态(**不补零**);传输错误出错误态。

## 4. 趋势视图(按日折线)

同一批 5 个事件的**按日**时间序列,数据源即 `ads_trd_group_funnel_daily`(天然时序)。

- **两张折线**:事件 UV(5 步)+ 相邻转换率(4 段),图例可点开关。
- **范围**:近 30 天(默认,相对最新可用日)/ 自定义起止(上限昨日)。
- 前导全 0 天(上线前)裁掉;范围内缺口日断线、**不补零**。
- 接口见 `docs/02` §5.1 / `docs/06` §3。

## 5. 验收(本模块)

- 漏斗展示固定 5 步(启动→曝光→拼团详情→下单→成功)每层 UV、相邻层转化率/流失率;第 1 层转化率展示"—"。
- 时间可选 单日(含历史回溯)/ 近 7 天 / 近 30 天;**最大可选日为昨日**,今天及未来不可选/不可查(前端禁选、后端拒绝)。
- 单日可选历史日;近 7/30 天展示 as-of 截至日。
- `漏斗 / 趋势` 两视图可切换;趋势出 UV 与相邻转换率两张按日折线,范围 近 30 天 / 自定义起止;前导全 0 天裁掉,范围内缺口日断线(**不补零**)。
- 数据缺失时**不静默补零**,展示明确的「暂无数据」空态。