v3 · 09/2026Come si costruiscono le interfacce dei prodotti software del gruppo, perché un applicativo fatto in una sede sia riconoscibile e manutenibile da un'altra. Diciassette sezioni: cosa vale, quanto vale, e dove sta scritto il valore.
Questo documento prescrive. Contiene enunciati, valori e specimen, non ragionamenti: le argomentazioni, le alternative scartate e i banchi di prova stanno nei dossier in fondo alla navigazione, e ogni sezione linka il proprio. Quando un dossier e questo documento divergono, vale questo.
Ogni regola dichiara il proprio strato, così chi legge sa subito se è negoziabile. È la differenza principale rispetto a uno standard qualunque: senza strati, “raggi 10px” e “il contrasto vince” hanno lo stesso peso, e nella pratica nessuno dei due viene rispettato.
Il documento governa due famiglie di software che non hanno gli stessi vincoli, e la distinzione va fatta all'avvio del progetto. Per questo è divisa in due parti: un nucleo comune che vale per tutti, e l'identità Maestrale che vale solo per i prodotti di catalogo.
Un prodotto carica due fogli: la base comune e una sola palette. Nient'altro va copiato dai fogli di documentazione.
| File | Contiene | Dove va |
|---|---|---|
| base.css | Neutri, semantici, tipografia, raggi, elevazione, spaziature: tutto ciò che non dipende dalla palette | Nel prodotto |
| palette-bordeaux.css | I ruoli di colore con il bordeaux dominante e il celeste co-primario | Una delle due |
| palette-celeste.css | I ruoli di colore con il celeste dominante e il bordeaux co-primario | Una delle due |
| doc.css · pres.css | La veste di questi fogli di documentazione | Solo qui |
Quindici sezioni sono scritte; resta il segnaposto di brand, e due — Brand e Visual Identity — dipendono dal brand manual e si scrivono con chi lo possiede. Due decisioni restano aperte e sono segnate nelle rispettive sezioni: il carattere delle etichette in maiuscolo e l'esistenza di un obbligo normativo di accessibilità — se c'è, la sezione 8 diventa un elenco di criteri verificabili invece di regole interne, e cambia il registro di tutto il documento.