# 电商数仓图资产说明

本目录的图分为两类：

## 主视觉图

用于课程开篇、项目 README、商品详情页和学习路线快速理解。

| 图 | 适合回答的问题 |
|---|---|
| `ecommerce-warehouse-overview-polished` | 这个项目从业务问题走到什么结果？ |
| `ecommerce-learning-roadmap-polished` | 十章应该怎样学习？ |
| `ecommerce-business-journey-polished` | 访问、订单、支付和退款怎样形成经营结果？ |
| `ecommerce-metric-definition-polished` | 核心指标的计算口径是什么？ |
| `ecommerce-warehouse-lineage-polished` | 原始数据怎样逐层变成可消费指标？ |
| `ecommerce-quality-release-polished` | 数据为什么可以通过质量门禁并交付？ |

## 技术细节图

技术细节图按问题类型拆分：

| 类型 | 图 | 适合回答的问题 |
|---|---|---|
| 粒度与对账图 | `ecommerce-dwd-grain-and-reconciliation-detail` | 支付、退款和订单商品事实为什么要先聚合，净额怎样对账？ |
| ERD 关系图 | `ecommerce-core-model-erd-detail` | 维度、事实、代理键和一对多关系如何组织？ |
| 指标逻辑图 | `ecommerce-ads-metric-breakdown-detail` | 可加指标、去重指标和比率公式如何汇合到 ADS？ |
| 故障诊断图 | `ecommerce-quality-failure-routing-detail` | 质量门禁失败后先查哪一层、谁负责修复？ |
| 时间窗口图 | `ecommerce-ads-window-cohort-timeline-detail` | 七日滚动指标和复购 cohort 的观察边界是什么？ |
| 数据流图 | `ecommerce-dwd-fact-flow`、`ecommerce-warehouse-lineage-polished` | 数据怎样逐层流动，哪些字段在什么层产生？ |
| 分层架构图 | `ecommerce-warehouse-five-layer` | ODS、DIM、DWD、DWS、ADS 的职责如何分工？ |
| 主题模型图 | `ecommerce-dws-theme-marts`、`ecommerce-ads-applications` | 汇总主题和应用数据集市怎样服务分析？ |
| 质量与交付图 | `ecommerce-quality-release-polished`、`ecommerce-quality-release-gate`、`ecommerce-commercial-delivery` | 质量门禁、发布和交付怎样闭环？ |

原有的源表关系、公共维度、总线矩阵和商业交付图继续用于章节中的实现细节和验收说明。总览图负责帮助学习者定位，粒度图负责解释关键建模决策，质量图负责展示项目如何达到可交付状态。

## 文件格式

每张图都提供：

- `.drawio`：可编辑 Draw.io 源文件。
- `.png`：适合文档和页面展示的普通图片。
- `.drawio.png`：嵌入完整图模型的可编辑 PNG。
- `.mmd`：结构化 Mermaid 描述。

统一风格采用浅色分区、圆角卡片、语义配色和清晰留白。主视觉图负责建立直觉，技术细节图负责支持实现，不用一张图承载所有信息。