White Label e Partner

Configurazione White-Label

I tenant Professional ed Enterprise possono personalizzare l'aspetto della piattaforma. La configurazione viene gestita tramite PUT /api/v1/admin/white-label:

{
  "logo_url": "https://cdn.azienda.com/logo.png",
  "primary_color": "#1E40AF",
  "secondary_color": "#3B82F6",
  "app_name": "La Mia Piattaforma IoT",
  "custom_domain": "app.azienda.com",
  "favicon_url": "https://cdn.azienda.com/favicon.ico"
}

I colori devono essere valori esadecimali validi. Il logo viene visualizzato nella barra di navigazione e nelle comunicazioni email.

Attivare e Disattivare il Branding

Il branding personalizzato viene attivato o disattivato con un toggle:

PATCH /api/v1/admin/white-label/status
{ "active": true }

Quando disattivato, viene mostrato il branding predefinito di Rela AI. Le modifiche al branding vengono riflesse immediatamente in tutte le sessioni attive.

Risoluzione del Tema per Dominio

Il sistema risolve il tema visivo dinamicamente:

1. Il dominio viene estratto dalla richiesta HTTP
2. Viene cercato un tenant con quel dominio personalizzato configurato
3. Se trovato, viene applicata la configurazione white-label del tenant
4. Se non trovato, viene utilizzato il tema predefinito

La risoluzione funziona sia per domini personalizzati che per sottodomini del dominio principale di Rela AI.

Verifica del Dominio Personalizzato

Per utilizzare un dominio personalizzato, è richiesta la verifica DNS:

1. L'amministratore registra il dominio nella configurazione
2. Viene generato un record TXT di verifica: _relaai-domain-verify.app.azienda.com
3. L'amministratore configura il record DNS
4. La verifica avviene automaticamente (può richiedere fino a 24 ore)
5. Viene configurato un CNAME che punta a custom.relaai.com

Il sistema verifica periodicamente che i record DNS rimangano attivi. Se vengono rimossi, il dominio personalizzato viene disattivato automaticamente.

Branding nelle Email

Le comunicazioni email rispettano la configurazione white-label:

• Logo del tenant nell'intestazione
• Colori personalizzati su pulsanti e link
• Nome applicazione personalizzato nel mittente
• Dominio personalizzato nei link delle email

I template email vengono renderizzati dinamicamente con i valori di branding del tenant che origina la comunicazione.

Programma Partner

I partner possono gestire più sub-tenant da un account principale.

Abilitare Partner

POST /api/v1/admin/partners/enable
{ "partner_type": "reseller", "commission_rate": 0.20 }

Provisioning Sub-Tenant

POST /api/v1/admin/partners/tenants
{
  "name": "Cliente del Partner",
  "plan": "professional",
  "admin_email": "admin@cliente.com"
}

Limiti dei Partner

Ogni partner ha limiti sul numero di sub-tenant che può creare, definiti nel proprio accordo. Il sistema applica questi limiti automaticamente.

Revenue Sharing

Il sistema calcola automaticamente la distribuzione dei ricavi:

• Ogni pagamento dei sub-tenant viene registrato
• Viene applicata la percentuale di commissione del partner
• Viene generato un report mensile di revenue sharing
• I pagamenti vengono elaborati secondo il ciclo concordato

I partner possono consultare le proprie metriche in una dashboard dedicata.