A

Come si applica

Scope

Questo documento governa due famiglie di software che non hanno gli stessi vincoli. La distinzione va fatta all'avvio del progetto, prima di aprire una riga di codice, perché decide quali sezioni sono obbligatorie e quali non si applicano affatto.

Famiglia 1

Prodotti Maestrale

Software di catalogo che esce col nostro nome. Il committente è il gruppo, l'identità è la nostra, e il prodotto viene riconosciuto come parente degli altri.
  • Nucleo comune: per intero, obbligatorio.
  • Identità Maestrale: per intero, obbligatoria — una delle due palette, il marchio, la famiglia tipografica, la scala dei raggi.
  • Revisione: passaggio con l'UI/UX designer prima del rilascio.
  • Deroghe: puntuali, motivate e tracciate. Mai sull'identità senza approvazione.
Famiglia 2

Applicativi su commessa

Verticali costruiti per un cliente — ERP, MES, WMS e altri. Escono col nome del committente, e l'identità è tendenzialmente la sua.
  • Nucleo comune: per intero. È ciò che rende un applicativo nostro manutenibile da un'altra sede.
  • Identità Maestrale: non si applica se il cliente porta la propria. Se non porta nulla — “voglio un ERP” — si applica la nostra per intero come predefinito.
  • Base tecnica: sempre Mantine 9 su React 19.2, come i prodotti.
  • Deroghe: il cliente può ridefinire lo strato identità, e in casi estremi anche la struttura. Il nucleo no.
A.1La famiglia si dichiara all'avvio, per iscritto. Con la famiglia si dichiarano anche le altre quattro cose: quale dominante (se si applica la nostra identità), quali superfici — solo desktop, anche telefono —, se il prodotto ha ruoli e permessi, e chi è il referente per le deroghe.struttura
A.2Il nucleo non si deroga, per nessuna delle due famiglie e per nessun committente. Contrasto, accessibilità, comportamento a dati assenti, scrittura dei testi, tastiera e fuoco, salvataggio esplicito.nucleo
A.3Se il cliente porta la propria identità, si sostituiscono i valori dentro una copia della palette. I ruoli restano gli stessi e nessun componente cambia: è la ragione per cui i componenti citano --primary-fill e non un esadecimale.struttura
A.4Le linee guida per dominio si sommano, non sostituiscono. Dove esistono regole specifiche per ERP, MES o WMS, aggiungono vincoli a queste: non le annullano.struttura

Cosa vale dove

SezioneProdotti MaestraleSu commessa
3 · Design tokenObbligatoriaObbligatoria — la struttura dei token. I valori di marca vengono dall'identità in vigore
4 · TipografiaObbligatoriaObbligatoria per scala, pesi, pavimento, formati e scrittura. La famiglia è identità
6 · ImpaginazioneObbligatoriaObbligatoria
7 · Principi di interazioneObbligatoriaObbligatoria — nucleo
8 · AccessibilitàObbligatoriaObbligatoria — nucleo
9 · ComponentiObbligatoriaObbligatoria per anatomia, varianti, stati e misure. I colori arrivano dai ruoli
10 · Schermate tipoObbligatoriaObbligatoria
11 · Tabelle e datiObbligatoriaObbligatoria, e su ERP / MES / WMS con i vincoli aggiuntivi della griglia
12 · FormObbligatoriaObbligatoria
13 · Navigazione e shellObbligatoriaObbligatoria per le tre zone e le misure. Il marchio è quello del committente
14 · Notifiche ed erroriObbligatoriaObbligatoria — in gran parte nucleo
15 · ResponsiveObbligatoriaObbligatoria dove il progetto dichiara il telefono fra le superfici
16 · Documenti e PDFObbligatoriaObbligatoria per impaginazione e leggibilità. Il filetto di testata è identità
18 · SviluppoObbligatoriaObbligatoria — è ciò che rende il codice leggibile fra sedi
19 · Figma e codiceObbligatoriaObbligatoria come processo. La libreria è quella del progetto
20 · Governo dello standardObbligatoriaObbligatoria, con un percorso di deroga diverso: decide il referente di commessa
1–2 · Brand e Visual IdentityObbligatoriaNon si applica se il cliente porta la propria
5 · Sistema di coloreObbligatoria — una delle due palettePredefinito se il cliente non porta nulla; altrimenti si sostituiscono i valori nei ruoli
17 · PresentazioniObbligatoriaNon si applica

I domini su commessa

Da definire: ERP, MES, WMS, altro.

Ogni dominio ha vincoli che il nucleo comune non può prevedere: un MES lavora su schermi di reparto, spesso a distanza e con luce difficile; un WMS si usa in piedi con un terminale in mano; un ERP vive di griglie larghissime e di operatori che stanno otto ore sulla stessa schermata. Quando queste linee guida esisteranno, aggiungeranno vincoli su densità, dimensione dei target, contrasto minimo e scorciatoie da tastiera — non sostituiranno nulla di quanto è scritto qui.

Nel frattempoUn applicativo su commessa senza linee guida di dominio si costruisce sul nucleo comune per intero, dichiarando nel progetto i due o tre punti in cui il contesto d'uso impone di scostarsi — tipicamente la densità di riga e la dimensione dei target.