# 产品需求

> hs-data 内部数据平台的产品需求与信息架构(模块与层级)。
>
> 命名约定:**本平台 =「数据平台」(看数/分析)**;"数据服务"一词留给将来的**对外供数 / API 层**(避免与平台名混淆)。

| 项 | 内容 |
|----|----|
| 版本 | **—**(MVP 未打号;版本方案与发布流程见 `docs/08`) |
| 阶段 | **MVP 已内网上线**(未切 `release` 正式版) |
| 更新日期 | 2026-07-03 |

> MVP 快速迭代期不打语义版本号,**按日期记变更**(与 `CHANGELOG.md` 一致);切 `release` 起填 v1.0,每个新能力域模块 minor+1(详见 `docs/08` §4)。

## 修订记录(按日期)

> 版本列自切 `release`(v1.0)起启用;MVP 期留空(`—`)。版本方案见 `docs/08`。

| 日期 | 版本 | 变更 |
|------|------|------|
| 2026-06-21 | — | 初版:5 个扁平能力域 + 泛用 UV 漏斗设想(bitmap 方案) |
| 2026-06-24 | — | 重构为**三级信息架构**(初版 7 个 L1);MVP 改为**拼团固定漏斗**(预聚合两表),漏斗详规对齐实现;前端栈 Ant Design → shadcn/ui |
| 2026-06-25 | — | **IA 精简定稿为 5 个 L1**(行为分析 / 指标体系 / 画像体系 / 数据看板 / 营销触达):多实体画像、实时并入看板、去数据管理/工作台门面、导航展开折叠;**平台更名「数据服务平台」→「数据平台」**(数据服务一词留给将来 API 层)+ 命名约定;文档全量对齐现状 |
| 2026-06-26 | — | **MVP 内网上线**:后端接入真实拼团两表、服务器 uvicorn 单进程同源托管;**新增「趋势」视图**(按日 UV/相邻转换率折线,范围支持自定义起止) |
| 2026-06-29 | — | 默认单日改回昨日(缺数即"暂无数据",不在应用侧兜底);空态文案「数据缺失」→「暂无数据」;顶栏品牌中英视觉等重 |
| 2026-07-03 | — | PRD 对齐现状(趋势视图、趋势支持自定义范围、上线状态、文案)+ 补业务目标 / 用户场景 / 访问权限(§1.2–1.4);沉淀迭代与发布流程(`docs/08`) |

---

## 1. 平台定位

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

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

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

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

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

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

### 1.2 业务目标与成功指标

- **目标**:把数仓 T+1 产出沉淀为统一入口的自助可视化,让业务/运营/产品**不再走人工找数据团队取数**;先用拼团漏斗验证"从取数到自助看转化"的闭环,再按能力域扩展。
- **MVP 成功判据**:平台内网可用;拼团漏斗接真实数据端到端;目标用户能自助查看拼团各环节转化与趋势,替代该场景的人工取数。
- **中长期指标(观察项)**:已上线能力域/报表数、活跃使用人数与频次、人工取数请求下降幅度。

### 1.3 目标用户与典型场景

| 角色 | 典型场景 |
|---|---|
| 运营 | 拼团活动上线后,看昨日 / 近 7 天 启动→成功 各环节转化,定位流失最大的一步 |
| 产品 | 看近 30 天趋势,判断改版后 详情→下单 转化是否提升 |
| 分析师 | 快速取用口径统一的现成报表,免重复写 SQL |
| 业务负责人 | 一眼看关键转化与走势 |

### 1.4 访问与权限(现状)

- **现状**:内网访问(需连公司 OpenWRT 网络),**暂无登录 / 鉴权**;平台内数据对内网可见。
- **边界**:仅内部使用;数据为**聚合口径、无个人明细**,风险可控。
- **后续**:切 `release` 正式版或对外供数前,**须补鉴权与访问控制**(见 `docs/06` 鉴权说明)。

## 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]** — 详规见 [`docs/prd/拼团漏斗.md`](prd/拼团漏斗.md)
  - 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 天。
- **趋势视图**:同 5 个事件的**按日折线**(UV + 相邻转换率),范围 近 30 天 / 自定义起止(详见 `docs/prd/拼团漏斗.md`)。
- 数据来自数据服务层 PostgreSQL 的预聚合宽表(见 `docs/03` §11)。

## 4. 模块详规(模块级 PRD)

平台采用**两层 PRD**:本文(平台级)保留定位/IA/路线/状态;**每个端到端模块的详规独立成册**,放 `docs/prd/<模块>.md`(结构与拆分约定见 `docs/08` §3)。

| 模块 | 详规 | 状态 |
|---|---|---|
| 拼团漏斗(漏斗 + 趋势两视图) | [`docs/prd/拼团漏斗.md`](prd/拼团漏斗.md) | 可用(MVP) |

> 新模块动工前先在此表登记 + 建对应 `docs/prd/<模块>.md`(**PRD 先行**,见 `docs/08` §2)。

## 5. 演进路线图

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

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

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

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

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

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

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

## 8. 验收标准(平台级)

- 平台导航包含 5 个 L1 能力域(行为分析/指标体系/画像体系/数据看板/营销触达);拼团漏斗可用,其余进入后展示"待开发"占位。
- 导航分组可手动展开/折叠、多个同时展开;进入某页自动展开其所在分支。
- 数据缺失时**不静默补零**,展示明确的「**暂无数据**」空态(全平台一致)。
- 信息架构可承载未来扩展:新分析模型落 L2、新报表落 L3,不破坏顶层 L1。

> 各模块的功能级验收在其模块 PRD 内(如拼团漏斗见 [`docs/prd/拼团漏斗.md`](prd/拼团漏斗.md) §5)。