Concepts

The domain model vocabulary used across LocusVia configuration, APIs, and documentation.

Domain model

text

Tenant
  -> Environment
     -> Domain
     -> App
        -> App Platform
           -> SDK App ID
     -> SDK API Key
     -> Link
        -> Link Target
     -> Fallback Policy
     -> SDK Event

Glossary

Tenant: A paying customer or organization that owns domains, apps, links, fallback policies, and SDK keys.
Environment: A tenant-scoped partition that groups Apps, Domains, SDK API Keys, Links, and Fallback Policies. Production and staging never cross-resolve.
Domain: A tenant-owned hostname in one Environment used for public links and mobile association files.
App: A tenant-owned mobile product that may span multiple platforms (iOS + Android).
App Platform: A platform-specific installable identity: iOS Bundle ID + Team ID, or Android package name + SHA-256 fingerprints.
SDK App ID: The Detour-compatible appID value used by a mobile SDK. Maps to exactly one App Platform.
SDK API Key: A public SDK credential that authenticates a tenant and authorizes one or more SDK App IDs in one Environment.
Link: A tenant-owned campaign or routing entry addressed by a domain and slug.
Link Target: A platform-specific or web destination selected from a Link during resolution.
Fallback Policy: A reusable rule set in one Environment that decides where a click goes when app handling is unavailable.
Click Context: Stored evidence of a public link click used to produce a future Deferred Link match. Contains a route payload snapshot.
Deferred Link: A resolved Link delivered to the SDK after install because the original click happened before app handling was available.
Deferred Match: The outcome of comparing SDK launch evidence with Click Contexts: deterministic, probabilistic, or none.

Key relationships

A Tenant has one or more Environments.
An Environment contains Apps, Domains, SDK API Keys, Links, and Fallback Policies.
An SDK App ID is globally unique and maps to exactly one App Platform.
A Domain and slug resolve to one Link within an Environment.
A Link has one or more Link Targets (iOS, Android, web).
Association files are generated per Domain from enabled App Platforms attached to that Domain.
Click Contexts store route payload snapshots from click time. Editing a Link Target affects future Click Contexts only.