# description
Canonical data model for the wine trade.

# $defs.producer.description
A winery / estate / négociant that makes wine.

# $defs.producer.properties.region.description
Region / appellation (free text or a region slug).

# $defs.producer.properties.farming.description
Farming practices (organic, biodynamic, …).

# $defs.producer.properties.production.description
{ annualCases, vineDensity, harvestPractices } — public scale facts.

# $defs.producer.properties.org.legal.description
Legal/regulatory dossier — { legalName, address, taxId, regulatoryIds{fda,cbma,duns,siren} }. PAID-tier only.

# $defs.producer.properties.org.contact.description
Contact details — { name, email, phone, pickupAddress }. PAID-tier only.

# $defs.producer.properties.geo.precise.description
Precise lat/lng + street address. Public tier sees coarse city/region only.

# $defs.sku.description
A specific bottling — the canonical wine unit. Producer + cuvée + vintage + format.

# $defs.sku.properties.region.description
Region / appellation (free text or a region slug).

# $defs.sku.properties.facets.description
Filterable projection of wine attributes.

# $defs.vintage.description
A vintage-level grouping (optional intermediate between wine and SKU).

# $defs.vintage.properties.region.description
Region / appellation (free text or a region slug).

# $defs.brand.properties.region.description
Region / appellation (free text or a region slug).

# $defs.person.description
An individual in the wine world (winemaker, vineyard manager, owner, oenologist, consultant). Role is carried on the person_of edge, not the type.

# $defs.person.properties.region.description
Region / appellation (free text or a region slug).

# $defs.vineyard.description
A named vineyard / parcel / cru site (distinct from a region). Rich parcel detail is optional + provenance-stamped.

# $defs.vineyard.properties.region.description
Region / appellation (free text or a region slug).

# $defs.export_agent.description
An export agent / courtier (e.g. Becky Wasserman & Co) that represents grower domaines for export — the layer between producer and importer.

# $defs.export_agent.properties.region.description
Region / appellation (free text or a region slug).

# $defs.importer.description
A US importer of record (TTB permit holder).

# $defs.importer.properties.region.description
Region / appellation (free text or a region slug).

# $defs.importer.properties.org.permit.description
TTB permit exists (the relationship is public; the holder dossier is gated).

# $defs.importer.properties.org.legal.description
License-holder dossier — { legalName, address, licenseNumber, taxId }. PAID-tier only.

# $defs.distributor.description
A wholesaler / distributor (state-licensed).

# $defs.distributor.properties.region.description
Region / appellation (free text or a region slug).

# $defs.distributor.properties.org.legal.description
License-holder dossier — { legalName, address, licenseNumber, statesLicensed }. PAID-tier only.

# $defs.retailer.properties.region.description
Region / appellation (free text or a region slug).

# $defs.retailer.properties.geo.description
{ lat, lng, city, state, zip } — see GeoPoint.

# $defs.retailer.properties.web.description
{ website, menus[], socials } — web presence.

# $defs.restaurant.properties.region.description
Region / appellation (free text or a region slug).

# $defs.region.description
A wine region / appellation with content + hierarchy.

# $defs.region.properties.region.description
Region / appellation (free text or a region slug).

# $defs.grape.properties.region.description
Region / appellation (free text or a region slug).

# $defs.place.properties.region.description
Region / appellation (free text or a region slug).

# $defs.term.description
A glossary concept / technique / classification.

# $defs.term.properties.region.description
Region / appellation (free text or a region slug).

# $defs.award.description
A discrete honor (Michelin star, Wine Spectator Grand Award, …).

# $defs.award.properties.region.description
Region / appellation (free text or a region slug).

# $defs.critic.description
A wine/restaurant critic or critic-outlet.

# $defs.critic.properties.region.description
Region / appellation (free text or a region slug).

# $defs.publication.properties.region.description
Region / appellation (free text or a region slug).

# $defs.price.description
A tenant's price for a wine — by tier, jurisdiction, and volume. Default-private, tenant-elected visibility: defaults to private and is shared only with accounts the publishing tenant authorizes (the price-feed model), but the tenant MAY widen visibility at its own election. The hard antitrust fence is on cross-tenant Ring-3 aggregates, not on a tenant publishing its own list.

# $defs.price.properties.region.description
Region / appellation (free text or a region slug).

# $defs.price.properties.jurisdiction.description
US state / country the tier applies in (NY, NJ, CA, …).

# $defs.price.properties.minQty.description
Volume threshold — ascending rows model volume discounts.

# $defs.price.properties.authorizedFor.description
Account ids the publisher authorizes to see this price (default: none).

# $defs.inventory.description
On-hand + allocated stock for a wine, per tenant. PRIVATE.

# $defs.inventory.properties.region.description
Region / appellation (free text or a region slug).

# $defs.account.description
A tenant's commercial relationship with a buyer (a retailer/restaurant/distributor). Sales + CRM are PRIVATE; contact + detailed profile are GATED; the buyer's existence/type is public via its retailer/restaurant entity.

# $defs.account.properties.region.description
Region / appellation (free text or a region slug).

# $defs.account.properties.buyerRef.description
The retailer/restaurant/distributor entity this account is for.

# $defs.account.properties.profile.description
Account profile — { cuisineType, wineListSize, naturalFocus, priceBand, ratings{yelp,google} }. PAID-tier only.

# $defs.account.properties.contact.description
Buyer contacts — { wineDirector, ownerName, email, phone }. PAID-tier only.

# $defs.account.properties.metrics.description
Sales metrics — { balance, salesTrailing12m, lastOrderAt, salesperson }. PRIVATE (tenant-owned MNPI).

# $defs.account.properties.crm.description
CRM/lead overlay — { leadStage, decisionMaker, competitors, opportunityRating }. PRIVATE.

# $defs.Provenance.properties.source.description
Source identifier (connector / publisher).