> ## Documentation Index
> Fetch the complete documentation index at: https://docs.earthcare.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Directory

> Business and the surrounding directory entities — the public system of record.

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)                                |

**Relationships:** M2M `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                                              |

<Note>Generated from the `directory` app models; field lists re-sync each iteration.</Note>