Skip to content

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. 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 edges

Every relationship, defined.

EdgeFrom → toLive countWhat it means
producesproducer → wine0The grower made this bottling.
representsexport agent → producer0An export agent (courtier) represents the domaine for export. NEW layer.
importsimporter → wine0The importer brings this wine into the country.
distributesdistributor → wine0A distributor carries it within a state / market.
listed_byretailer / restaurant → wine0A venue lists it on a shelf or wine list.
in_regionwine / producer → region0Geographic origin in the appellation hierarchy.
awardedwine / producer → award0A critic score or accolade.

A path through the graph

One bottle, vine to table.

The sample path is loading from the graph.

Build on the graph

Query every relationship.