# 产品需求

> hs-data 内部数据服务平台的产品需求与信息架构(模块与层级)。

| 项 | 内容 |
|----|----|
| 文档版本 | v2.0 |
| 文档状态 | 评审中 |
| 更新日期 | 2026-06-24 |

## 修订记录

| 版本 | 日期 | 修订内容 |
|------|------|----------|
| v1.0 | 2026-06-21 | 初版:5 扁平能力域 + 泛用 UV 漏斗 MVP |
| v2.0 | 2026-06-24 | 重构为多形态一站式平台的**三级信息架构**;MVP 改为拼团漏斗(固定);漏斗详规对齐已上线实况 |

---

## 1. 平台定位

hs-data 是一个**面向内部的一站式数据平台门户**:把数仓产出的行为数据、画像、看板与触达能力,沉淀为统一入口下的可视化分析与运营工具。面向内部使用者(分析、运营、产品、业务)。

平台不是单一的埋点分析工具,而是一个**门户 + 多能力域**的综合体——行为分析(神策式)只是其中一块,平台还覆盖指标体系(统一口径)、画像体系(多实体画像)、数据看板(含实时大盘)、营销触达(见 §2)。**这是内部工具,不堆砌中台/治理门面**(精简取舍见 §2)。

平台分阶段建设,按能力域逐步上线(见 §5 路线)。**本期(MVP)** 先搭好门户框架(各能力域进导航),只把**一个**报表做到端到端可用——**拼团漏斗**(`行为分析 > 漏斗分析 > 拼团漏斗`,见 §3、§4);其余能力域出"待开发"占位。

### 1.1 数据现实约束(决定能做什么)

当前数据是数仓 **T+1 预聚合宽表**(非事件级明细)。因此:

- 能做的是**固定预制报表**(口径预先算好,如拼团漏斗)。
- 神策式**自助分析**(用户自己拖事件/维度建漏斗、留存等)需要事件级 / bitmap 数据,**列为远期**,本期不做。
- PRD 描述完整愿景,但每个模块的"可用 / 待开发"以本文标注为准。

## 2. 信息架构(模块与层级)

平台采用主流数据平台通用的**三级结构**(参考神策、网易有数/数帆、阿里 OneData/OneEntity、CDP 多实体画像):

- **L1 能力域**:左侧一级导航。
- **L2 子能力 / 分析模型**:能力域下的具体模块(如漏斗分析、用户画像)。
- **L3 报表 / 实例 / 视图**:某个具体报表或实例(如**拼团漏斗**),挂在 L2 下,**不是独立模块**。

设计取舍(**这是内部工具,不是 SaaS**):

- **精简到 5 个 L1**,只保留内部用数者真正会用的业务能力;不堆砌"中台/治理"门面。
- **指标体系是核心** —— 主流数据产品(网易有数、阿里 DataWorks、火山 DataWind、Aloudata)都有;它是"数据平台"区别于"画图工具"的关键(统一指标口径)。只取**消费面**(指标目录/大盘/监控),重治理的口径定义后台不进主导航。
- **不设独立"实时"域** —— 实时是看板的一种(实时大盘),并入"数据看板"。
- **画像是多实体体系** —— 用户/商家/产品画像并列;标签是画像的底层支撑,不单列为域。
- **不设"数据管理 / 工作台"门户域** —— 元数据治理是后台,内部看数者不需要在主导航里看到。
- **模块名统一四字**,视觉对齐。

状态标注:**可用(MVP)** = 本期端到端交付;**待开发** = 进导航、出统一占位页。

### 2.1 顶层能力域(L1)

| # | L1 能力域 | 一句话定位 | 本期状态 |
|---|---|---|---|
| 1 | **行为分析** | 漏斗/留存/路径/事件/分布/归因等分析模型 | **部分可用(漏斗)** |
| 2 | 指标体系 | 统一指标口径:指标目录、指标大盘、指标监控 | 待开发 |
| 3 | 画像体系 | 多实体画像:用户画像、商家画像、产品画像(标签为底层支撑) | 待开发 |
| 4 | 数据看板 | 业务大盘、实时大盘、关键报表(实时并入此域) | 待开发 |
| 5 | 营销触达 | 触达规则、触达记录、触达效果 | 待开发 |

### 2.2 L2 / L3 展开(模块名四字)

**L1-1 行为分析**(本期唯一有可用模块的域)
- L2 漏斗分析 **[可用]**
  - L3 **拼团漏斗(固定)[可用,MVP]** — 见 §4 详规
  - L3 其他固定漏斗(下单漏斗…)[待开发]
  - L3 自助漏斗(用户选事件)[远期,需事件级数据]
- L2 留存分析 / 路径分析 / 事件分析 / 分布分析 / 归因分析(均 [待开发])

**L1-2 指标体系**:指标目录 / 指标大盘 / 指标监控(均 [待开发];重治理的口径定义后台不进主导航)
**L1-3 画像体系**:用户画像 / 商家画像 / 产品画像(均 [待开发];标签管理作为底层支撑,后续按需补)
**L1-4 数据看板**:业务大盘 / 实时大盘 / 关键报表(均 [待开发])
**L1-5 营销触达**:触达规则 / 触达记录 / 触达效果(均 [待开发])

> 扩展规则:新增分析能力 → 在对应 L1 加 L2 模型;新增具体报表 → 在 L2 下加 L3 实例。顶层 5 个 L1 保持稳定。

### 2.3 导航交互(展开/折叠)

对齐主流后台(VS Code / Ant Design Pro / 神策):

- 点 L1/L2 分组**手动展开/折叠**(点该行,不跳转);只有叶子(报表)跳转。
- **多个分组可同时展开**,非手风琴。
- 进入某页**自动展开其所在分支**,但不折叠用户已手动展开的其它分支;当前分支可手动折叠。

## 3. 本期 MVP 范围

本期交付两部分:

**A. 平台门户框架(占位)**
- 顶栏 + 左侧 L1 导航(5 个能力域全部进入)+ 内容区。
- 除"拼团漏斗"外,所有 L1/L2 进入后展示统一"待开发"占位页(见 §6)。

**B. 拼团漏斗(端到端可用)** — 落点 `行为分析 > 漏斗分析 > 拼团漏斗`
- 固定 5 步拼团转化漏斗,展示每层 UV、相邻层转化率/流失率。
- 时间维度:单日(可回溯历史)、近 7 天、近 30 天。
- 数据来自数据服务层 PostgreSQL 的预聚合宽表(见 `docs/03` §11)。

## 4. 拼团漏斗模块详规

### 4.1 漏斗定义

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

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

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

### 4.2 时间能力

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

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

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

### 4.3 页面说明(视觉/交互定稿见 `docs/04`)

- **时间控件**(标题行右):单日日历常驻 + 近 7 天/近 30 天 Tabs。
- **结果图表区**:ECharts 漏斗图,每层 UV + 块比例。
- **结果表格区**:步骤名 / UV / 转化率 / 流失率。
- **快照说明**:单日"数据快照日:YYYY-MM-DD";近 7/30 天"数据截至 YYYY-MM-DD(近 N 天)"。
- **状态**:`ready` 出图表+表格;`missing` 出"数据缺失"空态(**不补零**);传输错误出错误态。

## 5. 演进路线图

路线描述长期愿景与大致先后,不是本期范围(本期以 §3 为准)。各 L1 能力域按依赖与价值排序逐步落地:

| 阶段 | 能力域 / 模块 | 依赖 |
|---|---|---|
| 已交付 | 行为分析 > 漏斗分析 > 拼团漏斗(固定) | 预聚合两表(`docs/03` §11) |
| 近期 | 行为分析:更多固定漏斗、留存/路径分析(固定报表) | 对应 ADS 预聚合表 |
| 近期 | 数据看板:业务大盘 / 关键报表 | 复用各域报表 |
| 中期 | 画像体系:用户/商家/产品画像 + 人群圈选 | 标签宽/长表、人群包表 |
| 中期 | 行为分析:自助分析(任意步骤漏斗等) | **事件级 / bitmap 数据**到位 |
| 远期 | 数据看板:实时大盘 | 实时入仓链路 |
| 远期 | 营销触达:规则/记录/效果 | 触达记录表 |

## 6. 占位模块说明(空架子)

除拼团漏斗外,所有 L1/L2 本期只进导航、只出占位页:

- 占位文案统一"待开发"。
- 不做页面骨架(无筛选区/图表占位),仅一个明确占位状态。
- 点击导航可正常进入,不报错、不空白。
- 复用同一占位组件。

## 7. 明确不做(本期)

- **自助分析**:任意步骤漏斗、自定义事件/维度组合(需事件级数据,远期)。
- 严格顺序漏斗、转化窗口、用户/事件属性筛选、复杂人群圈选。
- 自定义日期范围(本期周期固定为 单日/近7天/近30天)。
- 实时今天数据(T+1)。
- 指标体系、画像体系、数据看板、营销触达的**任何实际功能**(仅占位)。
- 指标口径定义后台 / 数据治理 / 工作台等中台门面(内部工具不做主导航域)。
- 报表保存/分享/订阅;多数据源接入;Redis 等额外加速层。

## 8. 验收标准

- 平台导航包含 5 个 L1 能力域(行为分析/指标体系/画像体系/数据看板/营销触达);拼团漏斗可用,其余进入后展示"待开发"占位。
- 导航分组可手动展开/折叠、多个同时展开;进入某页自动展开其所在分支。
- 拼团漏斗展示固定 5 步(启动→曝光→拼团详情→下单→成功)的每层 UV、相邻层转化率/流失率;第 1 层转化率展示"—"。
- 时间可选 单日(含历史回溯)/ 近 7 天 / 近 30 天;**最大可选日为昨日**,今天及未来不可选/不可查(前端禁选,后端拒绝)。
- 单日可选历史日;近 7/30 天展示 as-of 截至日。
- 数据缺失时**不静默补零**,展示明确的"数据缺失"状态。
- 信息架构可承载未来扩展:新分析模型落 L2、新报表落 L3,不破坏顶层 L1。