The directory is the public layer: businesses, their taxonomy, their relationships,
and the claim/nomination flow that moves a listing from seeded to verified.
Business
The central directory entity. Tenant-scoped to an Organization.
| Field | Type | Notes |
|---|
id | UUID | Primary key |
slug | string | Unique, used in /business/<slug> and tools |
name, description | string | Profile basics |
lat, lng, address, city, region, country | geo | Location |
website, email, phone | string | Contact |
status | enum | SEEDED · NOMINATED · CLAIMED · VERIFIED · SUSPENDED |
organization | FK | Owning workspace |
embedding | vector(1536) | Semantic search |
search_vector | tsvector | Full-text search (GIN) |
categories, tags; 1:1 ContextPack; 1:M ContextDocument,
Offer, Want, Review, BusinessRelationship.
Supporting entities
| Model | Purpose |
|---|
Category | Hierarchical taxonomy (self-referential parent) |
Tag | Faceted metadata (certification, business model, ownership, ecosystem) |
BusinessRelationship | Typed edges between businesses (partner, supplier, located-at, …) |
EnterpriseNetwork / NetworkMembership | Curated partner networks with roles + hierarchy |
Offer / Want | Murmurations-style offers and needs |
Review | Public reviews & scout attestations |
Nomination / Claim / OwnershipInvite | The seeded → verified ownership funnel |
AllianceProgram / AllianceMembership | Bundled partnership tiers |
Generated from the directory app models; field lists re-sync each iteration.