Bladeren bron

docs: PRD 对齐现状(趋势/上线状态/文案)+ 补业务目标/用户场景/访问权限

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tianyu.chu 1 maand geleden
bovenliggende
commit
e54c8b7c42
3 gewijzigde bestanden met toevoegingen van 42 en 7 verwijderingen
  1. 3 0
      .gitignore
  2. 7 0
      CHANGELOG.md
  3. 32 7
      docs/01-产品需求-MVP.md

+ 3 - 0
.gitignore

@@ -27,3 +27,6 @@ Thumbs.db
 
 # Logs
 *.log
+
+# autodev 工作区(本地模式,不入库;每人各自 autodev init)
+.autodev/

+ 7 - 0
CHANGELOG.md

@@ -2,6 +2,13 @@
 
 > 记录本项目每次改动。新条目追加到顶部。格式:`日期 — 改动概述`,正文按 `新增 / 变更 / 修复 / 移除` 分类。链接 PR / commit / 相关文档(如有)。
 
+## 2026-07-03
+
+### 文档
+- **PRD(`docs/01`)对齐现状 + 补完整性**:
+  - 对齐:阶段改「已内网上线」、补 06-26/06-29 修订记录;§3 范围与 §8 验收补入**趋势视图**;§7 去掉与趋势矛盾的"不做自定义日期范围"(趋势已支持自定义起止);空态文案「数据缺失」→「暂无数据」。
+  - 补充:§1.2 业务目标与成功指标、§1.3 目标用户与典型场景、§1.4 访问与权限(现状内网无鉴权、对外前须补)。
+
 ## 2026-06-29
 
 ### 新增

+ 32 - 7
docs/01-产品需求-MVP.md

@@ -6,8 +6,8 @@
 
 | 项 | 内容 |
 |----|----|
-| 阶段 | **MVP 开发中(未发布)** |
-| 更新日期 | 2026-06-25 |
+| 阶段 | **MVP 已内网上线**(未切 `release` 正式版) |
+| 更新日期 | 2026-07-03 |
 
 > MVP 快速迭代期不打语义版本号(v1/v2),**按日期记变更**(与 `CHANGELOG.md` 一致);真正上线到 `release` 后再切正式版本。
 
@@ -18,6 +18,9 @@
 | 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) |
 
 ---
 
@@ -37,6 +40,27 @@ hs-data 是一个**面向内部的一站式数据平台门户**:把数仓产出
 - 神策式**自助分析**(用户自己拖事件/维度建漏斗、留存等)需要事件级 / bitmap 数据,**列为远期**,本期不做。
 - PRD 描述完整愿景,但每个模块的"可用 / 待开发"以本文标注为准。
 
+### 1.2 业务目标与成功指标
+
+- **目标**:把数仓 T+1 产出沉淀为统一入口的自助可视化,让业务/运营/产品**不再走人工找数据团队取数**;先用拼团漏斗验证"从取数到自助看转化"的闭环,再按能力域扩展。
+- **MVP 成功判据**:平台内网可用;拼团漏斗接真实数据端到端;目标用户能自助查看拼团各环节转化与趋势,替代该场景的人工取数。
+- **中长期指标(观察项)**:已上线能力域/报表数、活跃使用人数与频次、人工取数请求下降幅度。
+
+### 1.3 目标用户与典型场景
+
+| 角色 | 典型场景 |
+|---|---|
+| 运营 | 拼团活动上线后,看昨日 / 近 7 天 启动→成功 各环节转化,定位流失最大的一步 |
+| 产品 | 看近 30 天趋势,判断改版后 详情→下单 转化是否提升 |
+| 分析师 | 快速取用口径统一的现成报表,免重复写 SQL |
+| 业务负责人 | 一眼看关键转化与走势 |
+
+### 1.4 访问与权限(现状)
+
+- **现状**:内网访问(需连公司 OpenWRT 网络),**暂无登录 / 鉴权**;平台内数据对内网可见。
+- **边界**:仅内部使用;数据为**聚合口径、无个人明细**,风险可控。
+- **后续**:切 `release` 正式版或对外供数前,**须补鉴权与访问控制**(见 `docs/06` 鉴权说明)。
+
 ## 2. 信息架构(模块与层级)
 
 平台采用主流数据平台通用的**三级结构**(参考神策、网易有数/数帆、阿里 OneData/OneEntity、CDP 多实体画像):
@@ -98,9 +122,9 @@ hs-data 是一个**面向内部的一站式数据平台门户**:把数仓产出
 - 顶栏 + 左侧 L1 导航(5 个能力域全部进入)+ 内容区。
 - 除"拼团漏斗"外,所有 L1/L2 进入后展示统一"待开发"占位页(见 §6)。
 
-**B. 拼团漏斗(端到端可用)** — 落点 `行为分析 > 漏斗分析 > 拼团漏斗`
-- 固定 5 步拼团转化漏斗,展示每层 UV、相邻层转化率/流失率。
-- 时间维度:单日(可回溯历史)、近 7 天、近 30 天
+**B. 拼团漏斗(端到端可用)** — 落点 `行为分析 > 漏斗分析 > 拼团漏斗`,页内含 **`漏斗 / 趋势` 两视图**
+- **漏斗视图**:固定 5 步拼团转化漏斗,展示每层 UV、相邻层转化率/流失率;时间 单日(可回溯历史)/ 近 7 天 / 近 30 天
+- **趋势视图**:同 5 个事件的**按日折线**(UV + 相邻转换率),范围 近 30 天 / 自定义起止(见 §4.4)
 - 数据来自数据服务层 PostgreSQL 的预聚合宽表(见 `docs/03` §11)。
 
 ## 4. 拼团漏斗模块详规
@@ -173,7 +197,7 @@ L3 页含 **`漏斗 / 趋势` 两视图 Tab**。
 
 - **自助分析**:任意步骤漏斗、自定义事件/维度组合(需事件级数据,远期)。
 - 严格顺序漏斗、转化窗口、用户/事件属性筛选、复杂人群圈选。
-- 自定义日期范围(本期周期固定为 单日/近7天/近30天)。
+- 漏斗视图的自定义日期范围(漏斗周期固定 单日/近7天/近30天;**趋势视图已支持自定义起止**,见 §4.4)。
 - 实时今天数据(T+1)。
 - 指标体系、画像体系、数据看板、营销触达的**任何实际功能**(仅占位)。
 - 指标口径定义后台 / 数据治理 / 工作台等中台门面(内部工具不做主导航域)。
@@ -186,5 +210,6 @@ L3 页含 **`漏斗 / 趋势` 两视图 Tab**。
 - 拼团漏斗展示固定 5 步(启动→曝光→拼团详情→下单→成功)的每层 UV、相邻层转化率/流失率;第 1 层转化率展示"—"。
 - 时间可选 单日(含历史回溯)/ 近 7 天 / 近 30 天;**最大可选日为昨日**,今天及未来不可选/不可查(前端禁选,后端拒绝)。
 - 单日可选历史日;近 7/30 天展示 as-of 截至日。
-- 数据缺失时**不静默补零**,展示明确的"数据缺失"状态。
+- **趋势视图**:漏斗/趋势 两视图可切换;趋势出 UV 与相邻转换率两张按日折线,范围 近 30 天 / 自定义起止;前导全 0 天裁掉,范围内缺口日断线(不补零)。
+- 数据缺失时**不静默补零**,展示明确的「**暂无数据**」空态。
 - 信息架构可承载未来扩展:新分析模型落 L2、新报表落 L3,不破坏顶层 L1。