Skip to content

Commit c2749dd

Browse files
brownjuly2003-codeJuliaEdomclaude
authored
docs(dv2): sweep the retired clothing/footwear storyline out of DV2 docs (C1) (#142)
architecture.md and schema_dv2.md still described the DV2 demo as a clothing/footwear retailer and attributed the demo branch distribution to X5 Retail Hero. Both predate the kitchen-appliance own-brand legend fixed in domain.md (A1) and the B1 generator rebuild, which retired the 40/25/15/10/10 split (order count is now msk-heavy since all FBS/D2C fulfils from the central warehouse). Branch role descriptions in architecture.md are aligned with domain.md's footprint table. Real X5 Retail Hero Kaggle-dataset attribution (the loader that actually ingests 45.8M real rows) is left in place where it documents genuine technical provenance, not business legend, per domain.md §5.4. Co-authored-by: JuliaEdom <uedomskikh@gmail.com> Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
1 parent 6c2b75a commit c2749dd

3 files changed

Lines changed: 16 additions & 12 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ CDC source capture is standardized on Debezium/Kafka Connect; downstream consume
108108
| Design decisions | `docs/decisions/` (ADRs) |
109109
| Public site | `site/` |
110110
| IaC | `infrastructure/terraform/`, `infrastructure/dv2/`, `helm/`, `k8s/` |
111-
| DV2.0 warehouse | `warehouse/agentflow/dv2/` (hubs / links / satellites + X5 loader) |
111+
| DV2.0 warehouse | `warehouse/agentflow/dv2/` (hubs / links / satellites + real-dataset loader) |
112112

113113
## Documentation
114114

‎docs/dv2-multi-branch/architecture.md‎

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,16 @@ they go after.
66

77
## Storyline
88

9-
Mid-market e-com (clothing / footwear) with 5 locations and 3 jurisdictions:
9+
A mid-size Russian own-brand importer of small kitchen appliances, with 5
10+
locations and 3 jurisdictions — full legend in [`domain.md`](../domain.md):
1011

11-
| Branch | Region | Jurisdiction | Role |
12-
| --------- | ------ | ------------ | ------------------------------------- |
13-
| `msk` | RU | RU | HQ + flagship store + central WMS |
14-
| `spb` | RU | RU | Regional hub |
15-
| `ekb` | RU | RU | Regional hub |
16-
| `dxb` | UAE | UAE | Edge office + local fulfillment |
17-
| `ala` | KZ | KZ | Edge office + local fulfillment |
12+
| Branch | Region | Jurisdiction | Role |
13+
| --------- | ------ | ------------ | ----------------------------------------------------------------- |
14+
| `msk` | RU | RU | HQ, central warehouse (fulfils all three RU channels), main WMS |
15+
| `spb` | RU | RU | Regional warehouse + B2B showroom |
16+
| `ekb` | RU | RU | Regional warehouse (Urals/Siberia dealer logistics) |
17+
| `dxb` | UAE | UAE | Re-export trading hub, JAFZA free zone: China → Gulf market |
18+
| `ala` | KZ | KZ | EAEU hub: Kazakhstan local market + EAEU customs contour |
1819

1920
`record_source = {source_system}__{branch_code}` is load-bearing: it routes
2021
PII to a jurisdiction-local satellite and keeps cold-tier exports per-branch
@@ -134,8 +135,11 @@ flowchart LR
134135
- 1 HQ cluster (`hq-demo`) with 3 kind nodes, labelled `branch=msk`.
135136
- Postgres + ClickHouse pinned via `nodeSelector` — proving the placement
136137
primitive that production would use at the edge.
137-
- Synthetic seed populates `raw_vault` with the same `40/25/15/10/10` branch
138-
distribution that X5 Retail Hero reproduces against real transactions.
138+
- Synthetic seed populates `raw_vault` with the branch split from
139+
[`generator-spec.md`](../generator-spec.md) §1/§7: order *count* is
140+
msk-heavy (≈95%, since all FBS/D2C fulfils from the central warehouse)
141+
while B2B *revenue* splits more evenly by branch (msk 59.6% / spb 14.3% /
142+
dxb 10.6% / ekb 10.2% / ala 5.3%).
139143
- CDC bridge, business_vault MDM, cold-offload CronJob, and per-branch edge
140144
clusters (`dxb`, `ala`) are **out of scope for the demo runtime** but
141145
described above so the design is reproducible.

‎docs/dv2-multi-branch/schema_dv2.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Контекст
44

5-
Multi-source / multi-branch e-com одежды/обуви. 5 локаций (MSK / SPB / EKB / DXB / ALA). Источники: 1С (УТ), Битрикс24, Excel-логистика, XML-обмен сайта, API маркетплейсов (ВБ/Озон).
5+
Multi-source / multi-branch DWH own-brand импортёра малой бытовой техники (легенда: [`domain.md`](../domain.md)). 5 локаций (MSK / SPB / EKB / DXB / ALA). Источники: 1С (УТ/ЗУП), Битрикс24, WMS, Excel-логистика (контейнерные манифесты), собственный D2C-сайт, API маркетплейсов (ВБ/Озон).
66

77
Naming convention основана на публичных данных и engineering-материалах крупных ритейлеров (X5 Retail Hero, Lenta BigTarget, Магнит). DDL-шаблоны — адаптация Celestinfo + Tampere DV2.0 automation patterns под ClickHouse.
88

0 commit comments

Comments
 (0)