Ubiquitous Language

Browse and discover ubiquitous language terms in the Service Marketplace domain

Service Marketplace Domain Language(19 terms)

Service Marketplace

Bounded context for sourcing, profiling, and dispatching independent service providers. Replaces the deprecated name Labor Marketplace.

View details

Provider

A service-providing organization projection in the marketplace, scraped from a source URL or entered manually. Replaces Plan 3 Contractor. Future party-directory integration links to Organization.

View details

Professional

A person projection for an expert associated with a provider. Future party-directory integration links to Person. Replaces contact-oriented naming.

View details

Provider Type

The provider category. Defaults to GENERAL_CONTRACTOR; the TypeScript union also includes architect, engineer, specialty trades, and OTHER. Broader marketplace roles are intended to hang off ProviderProfile.

View details

Service Area

A city/state coverage tuple, optionally narrowed by neighborhood or ZIP code. Multiple cities may share a state. Requires at least one city.

View details

City

A named geographic city referenced by service areas. Names are normalized to legacy title case.

View details

City Text

Free-form comma-separated city input parsed into city names. Example — Brooklyn, Queens, Manhattan.

View details

Source URL

Vendor-portal URL from which a service provider was scraped. Each active provider has at most one. Normalized to an http(s) URL.

View details

Scrape Run

One invocation of the provider scraping pipeline. Produces a raw provider payload and a persistence outcome. The current deterministic adapter sets scrapeRunId to null.

View details

Provider Status

active or deleted. Deleted providers reject service-area changes. markDeleted is a soft delete.

View details

ProviderProfile

Placeholder for future provider marketplace projection data (marketplace and onboarding status, categories, regions). Stubbed pending the api-v2 Prisma phase; do not treat as persisted Airtable behavior.

View details

Marketplace Status

ProviderProfile overlay — DRAFT, ACTIVE, SUSPENDED, ARCHIVED. Domain-only until api-v2 persistence.

View details

Onboarding Status

ProviderProfile overlay — NOT_CONTACTED, OUTREACH_SENT, UNDER_REVIEW, ONBOARDED, DECLINED. Domain-only until api-v2 persistence.

View details

ServiceOffering

Placeholder for future provider-specific offerings (service type, project types, minimum project size). Stubbed pending the api-v2 Prisma phase.

View details

LicenseCredential

Placeholder for future professional/provider licensure. Stubbed pending the api-v2 Prisma phase.

View details

InsuranceCredential

Placeholder for future provider insurance. Stubbed pending the api-v2 Prisma phase.

View details

US State

Two-letter US state or DC code on a ServiceArea. Invalid codes are a domain invariant error.

View details

ZIP Code

Optional ZIP narrowing a ServiceArea.

View details

Create from URL

Workflow that validates a source URL, runs the module-local deterministic provider scraper, persists a Provider, and optionally links a party-directory Organization.

View details