Gestione dei Dati

Politiche di Retention dei Dati

Rela AI implementa un sistema di retention a livelli per ottimizzare i costi e rispettare le normative:

Le politiche vengono eseguite giornalmente tramite un job programmato:

1. I dati che superano i 30 giorni vengono spostati al tier di archivio
2. I dati che superano i 730 giorni vengono eliminati permanentemente
3. Viene generato un log delle operazioni di retention eseguite

I tenant Enterprise possono personalizzare i periodi di retention.

Esportazione GDPR

Per rispettare il diritto alla portabilità dei dati (GDPR Art. 20), viene offerta un'esportazione completa dei dati del tenant:

POST /api/v1/admin/data/export
{ "format": "json" }

L'esportazione include dati da 25 collezioni:

• Agenti, strumenti, configurazioni
• Eventi, attività, conversazioni
• Asset, piani di manutenzione
• Utenti, ruoli, permessi
• Registri di audit
• Integrazioni, webhook
• Report, estrazioni dati

Il processo è asincrono. Viene generato un link di download temporaneo valido per 24 ore e il richiedente viene notificato via email.

Cancellazione dei Dati del Tenant

La cancellazione completa dei dati richiede una conferma esplicita:

DELETE /api/v1/admin/data/tenant
{
  "confirmation": "DELETE-TENANT-{tenant_id}",
  "reason": "Customer request"
}

Il processo di cancellazione:

1. Valida la stringa di conferma
2. Contrassegna il tenant come pending_deletion
3. Attende un periodo di grazia di 72 ore
4. Elimina tutti i dati da tutte le collezioni
5. Genera un certificato di cancellazione

Solo il proprietario del tenant o un superadmin può eseguire questa azione.

Feature Flag

I feature flag permettono l'attivazione graduale delle funzionalità:

GET /api/v1/admin/features

Risposta:

{
  "features": {
    "new_dashboard": true,
    "ai_suggestions": false,
    "beta_reports": true
  }
}

I flag vengono risolti in cascata:

1. Globale — Valore predefinito per tutti i tenant
2. Piano — Override per tipo di piano
3. Tenant — Override specifico per tenant

Gli override del tenant hanno la massima priorità, permettendo di abilitare o disabilitare funzionalità per tenant specifici senza influenzare gli altri.

Versioning dell'API

L'API supporta il versioning tramite il path: /api/v1/, /api/v2/.

Header di Deprecazione

Quando un endpoint è contrassegnato per la deprecazione, vengono inclusi header:

Deprecation: true
Sunset: Sat, 01 Jan 2027 00:00:00 GMT
Link: </api/v2/agents>; rel="successor-version"

Date di Sunset

Ogni versione deprecata ha una data di sunset definita:

• I tenant vengono notificati 90 giorni prima del sunset
• Vengono inviati promemoria a 60, 30 e 7 giorni
• Dopo il sunset, gli endpoint restituiscono HTTP 410 Gone
• La documentazione reindirizza alla versione corrente

I tenant Enterprise possono richiedere estensioni del periodo di sunset.