Creare un Branding Aziendale

In questo tutorial configuri il branding applicato a ogni PDF che la piattaforma genera: report on-demand, report programmati e report generati dagli agenti IA.

Prerequisiti

Ti serve:

• Logo aziendale in PNG o JPG, massimo 2 MB.
• Colori aziendali in hex a 6 cifre (es: #003366, #F8F8F8).
• ~10 minuti.

Passo 1 — Caricare il logo

Il logo deve essere pubblicamente accessibile via URL (il generatore PDF fa fetch HTTP).

Opzioni:

• GCS pubblico: caricarlo nel bucket del tenant configurato come pubblico.
• CDN esterno: Cloudflare, Cloudinary, qualsiasi host.
• File storage di Rela: File → Carica, marcare come pubblico. L'URL risultante finisce negli appunti.

Verificare l'URL in una scheda in incognito del browser — deve mostrare il logo senza chiedere login.

Passo 2 — Creare il branding

1. Amministrazione → Marchi e Loghi → Nuovo.
2. Nome: "Aziendale 2026" (leggibile, descrittivo).
3. Nome azienda: "ACME Industries S.p.A.".
4. URL del logo: incollare l'URL del Passo 1.
5. Linee dell'header (una per linea):

   Divisione Manifattura
   Tel: +39 02 1234 5678
   acme.it

6. Testo destro: "Confidenziale".
7. Sfondo header: #003366 (blu aziendale).
8. Testo header: #FFFFFF (bianco).
9. Sfondo footer: #F8F8F8 (grigio chiaro).
10. Testo footer: #666666.
11. Colore accento (tabelle): #003366.
12. Font: Helvetica.
13. Testo del footer: "Report generato automaticamente da Rela AI".
14. Marcare come default del tenant: sì.
15. Salvare.

Passo 3 — Verificare con un report di prova

1. Dati → Report → Nuovo Report.
2. Titolo: "Test Branding".
3. Aggiungere un blocco heading + una tabella dummy.
4. Branding: lasciare vuoto (userà il default appena marcato).
5. Generare.

Aprire il PDF:

• Header con sfondo blu, logo, 3 linee di testo, "Confidenziale" a destra.
• Footer grigio con il testo definito.
• Tabelle con header blu aziendale.

Se qualcosa non va, modificare il branding e rigenerare.

Passo 4 — Brandings aggiuntivi (multi-cliente)

Se sei un fornitore di servizi con vari clienti:

1. Creare un branding per cliente: "Cliente Acme", "Cliente Beta", ecc.
2. NON marcarli come default — solo uno può essere il default del tenant.
3. In ogni report del cliente (on-demand o programmato), referenziare il branding_id specifico.
4. Il default del tenant continua ad applicarsi ai report senza branding_id esplicito.

Passo 5 — Rebrand futuro

Quando l'azienda aggiorna la sua identità:

1. Modificare il branding esistente (non creare uno nuovo — i riferimenti si perderebbero).
2. Cambiare logo, colori, testo.
3. Salvare.

I prossimi report programmati ereditano i cambiamenti immediatamente. I report storici mantengono il branding precedente (sono PDF congelati).

Limiti

• Un branding default per tenant. Marcarne uno nuovo smarca il precedente.
• Il logo deve essere URL pubblico. Dietro auth → il PDF esce senza logo.
• Colori hex a 6 cifre. #FFF (3 cifre) o red (nome) sono rifiutati.
• Niente gradienti, ombre o immagini di sfondo. Solo colori solidi.
• Font limitati a 3: Courier, Helvetica, Times.

Vedi admin/brandings per il riferimento completo dei parametri.