Come ArtigianaMente rende leggibili dati, stati e azioni in modo coerente in tutta l'app. È la grammatica dei numeri: vale per chi disegna e per chi sviluppa. Nato dal principio "range + stato + colpo d'occhio" (concept redesign app Salute), adattato a un gestionale aziendale: la logica sì, il giocattolo no.
Un numero da solo non dice niente. "Margine 14%" è muto; "Margine 14% · obiettivo 15% · sotto di 1 punto · causa: ore extra · [Controlla ore]" è una decisione pronta. Ogni schermata risponde a: va bene o c'è da controllare? e cosa faccio adesso?
Applicazione per contesto: nelle liste = sintesi · nei dettagli = spiegazione · in Home = decisione · in Analisi = grafico + interpretazione.
Mai "buono / non buono" stile app salute: su un gestionale aziendale suona infantile. Tono: "guarda qui: questa cosa richiede attenzione", non "ops, la tua azienda non sta bene!".
Mai media di settore o confronti con altre aziende. Quando non c'è confronto, il dato va spiegato con contesto operativo: "€4.500 da incassare · 2 clienti · uno scade domani". Il range non deve esserci sempre; il significato sì.
Distinzione fondamentale: il verde brand è UI, il verde stato è semantica. Non devono sembrare la stessa cosa.
| Colore | Uso |
|---|---|
| Verde brand #244D35 | Tab attiva, bottoni principali, header, accenti UI. MAI per dire "stato ok". |
| Verde stato #008A05 | Solo OK, pagato, completato, sotto controllo. |
| Arancione #E07912 | Da controllare, in scadenza, incompleto, fermo. |
| Rosso #C13515 | Solo critico vero: scaduto, sotto soglia, errore bloccante. |
| Ardesia #475569 | Neutro, archiviato, informativo. |
Rosso pieno quasi mai. Di norma: badge, bordo sottile, testo chiave o icona rossa. Card interamente rossa solo per errore bloccante, azione urgente oggi, rischio reale su soldi o lavoro (es. "liquidità sotto soglia domani"). Una fattura scaduta da 2 giorni ha badge/bordo rosso, non sfondo pieno.
In riga stanno: nome/oggetto, dato più importante, dot stato, micro-contesto (max 1 riga), eventuale badge. Non stanno in riga: causa completa, spiegazioni lunghe, più di un'azione, grafici, troppi numeri.
Azioni inline solo se leggere e sicure: Chiama, Sollecita, Apri, Conferma. Mai inline le azioni pesanti: Invia fattura, Chiudi lavoro, Cancella, Approva margine basso, Invia pacchetto commercialista — quelle vivono nel dettaglio.
Nei dettagli si usa una card standard riutilizzabile, sempre uguale. Lo stato viene prima del numero: Fabri prima capisce se preoccuparsi, poi guarda quanto.
Ordine fisso: badge stato → titolo umano → dato grande → confronto/range → causa → azione.
Limiti per schermata (se tutto è importante, niente è importante): Home = 1 card stato + max 3 priorità · Dettaglio lavoro = max 3 InsightCard · Soldi = max 4 · Analisi = max 5 · Liste = nessuna card formula completa.
Problemi = card visibili. OK = riepilogo compatto. L'app non deve sembrare sempre arrabbiata, ma nemmeno un prato di card verdi.
OK diventa card grande solo quando rassicura davvero: "Tutto sotto controllo oggi", "Nessuna scadenza critica nei prossimi 7 giorni", "Lavoro chiuso con margine sopra obiettivo".
La Home è una sintesi decisionale, non una dashboard. Zero grafici. Gerarchia fissa:
Nessuna sezione vuota: se non c'è contenuto, la sezione sparisce. Le urgenze vere salgono sopra tutto.
Ogni sezione (Soldi, Lavori, Richieste, Calendario) apre con una mini-card stato di sezione — una testata intelligente, non una seconda Home. Esempi: Soldi → "2 cose da sistemare · 6.200 € scaduti, 3 fatture da verificare" · Lavori → "1 lavoro da controllare · Bagno Musile sotto margine" · Calendario → "3 appuntamenti · 1 sovrapposizione mezzo".
Mai grafico muto. Ogni grafico è sempre accompagnato da: dato principale, confronto, spiegazione, causa, azione. (Vedi 5-azienda/analisi.html.)
Dove l'utente sta leggendo, guardando o scrivendo — non decidendo:
Ammessa al massimo una mini-sintesi sopra (es. in conversazione: "Richiesta da controllare · preventivo fermo da 8 giorni"), mai card dentro la chat.
La formula si applica a: ore, compiti, presenza, foto mancanti, rapportini, documenti personali, materiali. Mai soldi.
Solo tracking semplice. Stati: In programma · In corso · In verifica · Completato · Serve una tua conferma. Esempi: "Il tuo lavoro procede regolare · prossimo passaggio: montaggio parquet giovedì" · "Serve una conferma: abbiamo caricato una variante da approvare".
Mai visibili al cliente: margini, costi, ore extra, fornitori in ritardo, problemi interni, squadra.
La formula è universale; le soglie sono dell'azienda. In MVP: default hardcoded ma centralizzati in un solo punto del codice (mai sparsi). In Fase 2: schermata Impostazioni → Regole azienda. Questo rende il prodotto vendibile ad altre aziende senza complicare Fabri ora.
| Soglia | Default MVP |
|---|---|
| Margine minimo | 15% (obiettivo 25%) |
| Richiesta ferma | 24 ore senza risposta |
| Preventivo da sollecitare | 7 giorni senza risposta |
| Fattura "in scadenza" | entro 7 giorni |
| Liquidità minima | valore impostato a mano all'avvio |
| Ore extra "attenzione" | +10% sulle preventivate |