Technical documentation
The wine trade, as a graph.
Every wine resolves to one canonical SKU, then links to each party that moves it from vineyard to table — the producer, the export agent, the importer, the distributor (state by state), and the shops and restaurants that carry it — and to the substance behind it: the people who make it, the vineyardsit comes from, and the grapes, farming, and techniques it’s built on. The diagram below is live — counts come straight from the public graph. Every node is clickable.
Entity-relationship diagram
Entities and how they connect.
Counts are live public-graph facts and update hourly. Arrows point in the canonical edge direction (actor → wine; export agent → producer). The wine/SKU is the hub every trade actor attaches to.
The wall
What's public, gated, and private.
The diagram above is the public graph — free and anonymous. Two tiers sit behind a wall and never appear there: sensitive license-holder detail (paid) and tenant-owned commercial data (private). The classification is part of the open standard — every field declares its tier.
Public · the diagram above
Identities + relationships + public web presence. Producers, wines, regions, who imports/distributes what, a venue’s existence and location.
Gated · paid
License-holder dossiers — legal name, address, permit/license numbers, contacts, and precise premises geo for importers & distributors. Public-sourced, but paid-only in aggregate.
Private · tenant-authorized
Tenant-owned commerce — pricing (always; per-recipient), inventory, sales, and customer/CRM. Never public; shared only with the accounts the publisher authorizes.
The edges
Every relationship, defined.
| Edge | From → to | Live count | What it means |
|---|---|---|---|
| produces | producer → wine | 0 | The grower made this bottling. |
| represents | export agent → producer | 0 | An export agent (courtier) represents the domaine for export. NEW layer. |
| imports | importer → wine | 0 | The importer brings this wine into the country. |
| distributes | distributor → wine | 0 | A distributor carries it within a state / market. |
| listed_by | retailer / restaurant → wine | 0 | A venue lists it on a shelf or wine list. |
| in_region | wine / producer → region | 0 | Geographic origin in the appellation hierarchy. |
| awarded | wine / producer → award | 0 | A critic score or accolade. |
| person_of | person → producer | 0 | A winemaker / owner / vineyard manager — role + tenure on the edge. NEW. |
| farms | producer → vineyard | 0 | The producer works this vineyard (estate / leased / purchased fruit). NEW. |
| sourced_from | wine → vineyard | 0 | A bottling's fruit comes from this vineyard. NEW. |
| farmed_as | wine / producer → term | 0 | A farming practice (organic, biodynamic, regenerative). NEW. |
| uses_technique | wine / producer → term | 0 | A winemaking technique (carbonic, skin-contact, amphora). NEW. |
A path through the graph
One bottle, vine to table.
The sample path is loading from the graph.
Build on the graph