Tenancy & Slugs

Overview:

• Tenants have a slug used for selection via header or query.
• The special slug default resolves to id t_default.

Constraints:

• slug is unique via CREATE UNIQUE INDEX tenants_slug_idx ON tenants(slug);
• Migration adds column first, then index (SQLite limitation).

Selection:

• Header: X-Tenant-ID: <tenant-id-or-slug>
• Query: ?tenantId=<tenant-id-or-slug>

Fallback:

• If no header/query is given, the API resolves to the default tenant.

Admin tips:

• Seed a predictable default tenant and demo project to validate deployments.
• When renaming slugs, update related configs and clients accordingly.