Commesse aperte
| Codice | Cliente | Stato | Importo | Scadenza | ||
|---|---|---|---|---|---|---|
| ✓ | C-4821 | Comune di Rho | In scadenza | 128.450,00 | 28/06/2026 | |
| C-4820 | Immobiliare Sesto | Completata | 42.100,00 | 14/06/2026 | ||
| C-4817 | Tecnoimpianti | Bloccata | 9.980,50 | — |
Dove vanno le cose. Struttura di navigazione, layout delle pagine tipo, anatomia delle tabelle, posizione delle azioni, uso delle maiuscole. Sono le convenzioni che rendono un applicativo del gruppo prevedibile anche quando è fatto da un'altra sede.
Quasi tutto ciò che segue è struttura: è il predefinito e si deroga con una ragione. Le poche righe di nucleo sono segnate.
Un solo schema per tutti i prodotti: barra di intestazione fissa in alto, navigazione verticale a sinistra, contenuto a destra. La navigazione orizzontale a schede in cima è esclusa: non regge oltre sette voci e i gestionali ne hanno sempre di più.
Qui la regola è meno ovvia di quanto sembri, e vale la pena spiegarla: il maiuscolo si legge più lentamente perché elimina il profilo della parola, che è ciò che l'occhio riconosce prima delle lettere. Va bene per un'etichetta che si localizza — due parole, sempre nello stesso posto — e va male per una voce che si legge e si sceglie.
| Elemento | Forma | Corpo | Perché |
|---|---|---|---|
| Intestazione di gruppo nel menu | MAIUSCOLO | 13px · +0.09em | Si localizza, non si legge. Separa senza aggiungere colore. |
| Voce di menu, anche padre | Tondo, semigrassetto se attiva | 15px | Si legge e si scegliene una. |
| Intestazione di colonna | MAIUSCOLO | 13px · +0.09em | Ancora la colonna, si scorre di rado. |
| Titolo di sezione in pagina | MAIUSCOLO | 13px · +0.09em | Divide, non informa. |
| Tag di stato | MAIUSCOLO | 13px · +0.05em | Una o due parole, si riconoscono a forma. |
| Titolo di pagina | Tondo | 22-24px | È la frase più letta della pagina. |
| Schede, pulsanti, etichette di campo | Tondo, iniziale maiuscola | 14-15px | Testo da leggere. |
| Dati (nomi, codici, importi) | Come sono nel dato | 15px | Il maiuscolo forzato falsifica il contenuto. |
text-transform, mai scrivendo il testo in maiuscolo nel codice o nel database: i lettori di schermo leggerebbero le sigle lettera per lettera, e il dato non sarebbe più cercabile.Tre posti, e uno solo per ogni tipo di azione.
È la pagina più frequente di un gestionale, quindi la più standardizzata: intestazione, barra strumenti, tabella, piede.
La tabella è il componente su cui si passa più tempo, quindi ha le regole più strette.
| Aspetto | Regola | Strato |
|---|---|---|
| Ordine delle colonne | Identificativo, poi la descrizione che l'utente cerca, poi stato, poi numeri, poi date. Le azioni all'estrema destra. | struttura |
| Allineamento | Testo a sinistra. Numeri, importi e date a destra, in cifre tabulari, così le unità si incolonnano. Mai numeri centrati. | nucleo |
| Intestazione | MAIUSCOLO 13px su fondo appena distinto, appiccicata in alto quando la tabella scorre. | struttura |
| Righe | Separate da un filetto, non a bande alternate. Altezza 38px comoda / 30px compatta, a corpo invariato. | struttura |
| Selezione | Filetto co-primario sui bordi della riga e sul lato sinistro. Nessun fondo colorato. | struttura |
| Azioni di riga | A destra, icone da 28px. Fino a tre visibili; oltre, un menu a tre punti. Restano visibili anche senza passaggio del puntatore. | nucleo |
| Ordinamento | Intestazione cliccabile con freccia sulla colonna ordinata. Una colonna alla volta. | struttura |
| Paginazione | In basso, conteggio a sinistra e numeri a destra. Scorrimento infinito escluso: in un gestionale serve poter dire "pagina 3". | struttura |
| Valore assente | Trattino lungo — in grigio medio, allineato come il dato. Mai cella vuota, mai "N/D", mai zero al posto del nulla. | nucleo |
| Larghezze | Le colonne di dati brevi si dimensionano sul contenuto; una sola colonna elastica assorbe lo spazio. Il testo lungo si tronca con i puntini e il valore intero nel suggerimento. | struttura |
| Oltre dieci colonne | Selettore di colonne obbligatorio, con una scelta predefinita di 6-8 colonne e le altre disponibili. La prima colonna resta bloccata a sinistra durante lo scorrimento orizzontale, così l'identificativo non si perde. | nucleo |
| Riga di totali | In fondo, appiccicata, con filetto superiore più marcato. Solo per colonne sommabili. | struttura |
Un record si apre in una pagina, non in un dialogo: ha un indirizzo condivisibile, si può aprire in una scheda nuova, e non intrappola l'utente.
I prodotti si costruiscono su Mantine 9 e React 19.2, con il solo Table di libreria: mantine-datatable non si usa. Questo capitolo non reinventa i componenti: dice quale componente realizza ogni convenzione e cosa va impostato nel tema perché il predefinito coincida con lo standard.
mantine-datatable, la tabella è un componente interno. Table disegna la griglia e nient'altro: ordinamento, selezione, paginazione, densità e selettore di colonne vanno scritti una volta in un componente condiviso del gruppo, non riscritti a ogni pagina. Le regole della sezione 4 sono la specifica di quel componente.| Convenzione | Mantine | Note di configurazione |
|---|---|---|
| Impianto della pagina | AppShell | header={{height:56}}, navbar={{width:{base:236, collapsed:64}, breakpoint:'sm'}}. Su schermo stretto la navigazione si sovrappone invece di ridursi. Lo stato aperto/chiuso in localStorage. |
| Interruttore navigazione | Burger | In AppShell.Header, primo figlio a sinistra. |
| Voci di menu | NavLink | Voce in tondo 15px; il filetto attivo con styles={{root:{borderLeft:...}}}, non con variant="filled" che colora tutto il fondo. Nel menu chiuso, Tooltip position="right" con il nome. |
| Intestazione di gruppo | Text | tt="uppercase" fw={600} fz={13} lts="0.09em" c="dimmed". Non è un NavLink: non deve essere cliccabile. |
| Briciole di pane | Breadcrumbs | Separatore /, ultimo elemento non cliccabile. |
| Tabella | Table | withTableBorder no, withRowBorders sì, striped no. Intestazione appiccicata con Table.ScrollContainer + stickyHeader. Ordinamento, selezione e paginazione si costruiscono a mano: Table non li porta. |
| Selettore di colonne | Popover + Checkbox | Obbligatorio: le tabelle superano le dieci colonne. La scelta si ricorda per utente e per tabella con useLocalStorage, sempre con defaultValue: in v9 il valore è tipizzato string | undefined e senza predefinito la prima apertura non ha colonne. |
| Filtri che non stanno in barra | OverflowList | Nuovo in v9. I chip dei filtri attivi non vanno a capo né si tagliano: quelli che non entrano si raccolgono in “+N”. Sostituisce il conteggio calcolato a mano. |
| Schede di dettaglio | Tabs | variant="outline"; la scheda attiva nell'indirizzo tramite value controllato. |
| Dialogo | Modal | radius={5} centered. Piede costruito con Group justify="flex-end"; con l'azione distruttiva, justify="space-between". |
| Pannello laterale | Drawer | position="right" size="lg". Mai position="left": quel lato è della navigazione. |
| Notifica | notifications | position="top-right", autoClose={4000}; errore autoClose={false}. |
| Attesa | Skeleton | Nella forma del contenuto. Loader solo dentro un pulsante che sta lavorando. |
| Tag di stato | Badge | variant="outline" sempre; radius={8}. Mai variant="light": in v9 non è più una velatura trasparente ma un fondo pieno, quindi viola due regole invece di una. |
| Azioni di riga | ActionIcon | variant="subtle" size={28}. Oltre tre azioni, Menu con IconDots. |
| Paginazione | Pagination | radius={8}, in Group justify="space-between" col conteggio. |
| Form | @mantine/form | validateInputOnBlur sì, validateInputOnChange no. Lo schema si collega con schemaResolver: in v9 Standard Schema (Zod v4, Valibot, ArkType) è nativo e i pacchetti mantine-form-*-resolver non si installano più. |
| Campo in attesa | Input (loading) | Nuovo in v9 su tutti i campi: la ricerca e le combobox che interrogano il server usano loading, non un Loader messo in rightSection a mano. |
| Date | DatePickerInput | valueFormat="DD/MM/YYYY", locale="it", prima colonna lunedì. |
| Numeri e importi | NumberInput | decimalSeparator="," thousandSeparator=".". In tabella, ff="var(--mantine-font-family)" fvn="tabular-nums" e allineamento a destra. |
| Grafici | @mantine/charts | Richiede Recharts 3. I colori vengono dalla rampa della dominante (--chart-1..3), mai da color="blue.6". Per le liste di barre in linea, BarsList (nuovo in v9) invece di un grafico intero. |
| Calendari e agende | @mantine/schedule | Nuovo in v9: viste giorno / settimana / mese / anno, trascinamento e ridimensionamento degli eventi. Non si scrive più un'agenda a mano. Gli eventi si colorano con la rampa, non con i semantici. |
| Icone | @tabler/icons-react | Solo la variante lineare (Icon*, non *Filled), stroke={1.8}, size={18} nel menu e in tabella, size={20} nei pulsanti. |
Mantine 9 porta cinque componenti che prima non c'erano. Non si adottano perché sono nuovi: si adottano se sostituiscono codice che stavamo scrivendo a mano.
L'elenco completo sta nella guida di migrazione di Mantine. Qui stanno solo i punti che cambiano una regola scritta in questo documento: chi rilegge un prodotto costruito sulla versione precedente dello standard corregge questi e ha finito.
| Punto | v7 | v9 |
|---|---|---|
| Colore del testo | <Text color="dimmed"> | La prop color è stata rimossa da Text e Anchor: si usa c="dimmed". Vale anche per le intestazioni di gruppo del menu. |
| Raggio predefinito | sm (4px) | È salito a md (8px). Il nostro tema dichiara defaultRadius: 'sm' (5px) e da qui è una sostituzione consapevole, non un'eredità: i raggi restano 5 / 8 / 12. |
Variante light | velatura trasparente | Ora è un colore solido. Esiste v8CssVariablesResolver per ripristinare il comportamento vecchio: non si usa — rimetterebbe in circolo la velatura che il sistema ha escluso. |
| Validazione | pacchetti resolver dedicati | Standard Schema nativo: schemaResolver con Zod v4, Valibot o ArkType. Supportata anche la validazione asincrona: codici, partite IVA, unicità verificata sul server. |
| Notifiche | il passaggio del mouse sospende quella notifica | Sospende il timer di tutte le notifiche visibili. La regola non cambia (autoClose={4000}, limit={3}), ma i tempi vanno riprovati con la pila piena. |
Stato in localStorage | value era string | Ora è string | undefined: menu aperto/chiuso, colonne visibili, densità e tema vogliono tutti un defaultValue esplicito. |
| Intestazione appiccicata | useHeadroom tornava un booleano | Torna { pinned, scrollProgress }. L'ombra --elev-raised può così comparire in proporzione allo scorrimento invece che di colpo. |
| Rinomine | TypographyStylesProvider, Collapse in, Spoiler initialState | Typography, expanded, defaultExpanded. positionDependencies su Popover e Tooltip è stata rimossa: il ricalcolo è automatico. |
| Hook di misura | ref passato all'hook | useResizeObserver, useMouse e useMutationObserver usano il ref di callback; useFullscreen si è diviso in useFullscreenElement e useFullscreenDocument. |
| React | 18 | 19.2+. Con useEffectEvent le callback restano stabili senza useCallback a mano: le colonne della tabella e i gestori di riga si semplificano. |
llms.txt, skill contestuali e un server MCP sperimentale. Chi sviluppa con un assistente li colleghi: sono la fonte per i nomi dei componenti e delle prop. Non sono la fonte per le regole di interfaccia, che stanno qui — un agente che conosce Mantine ma non MaeDesign produce codice corretto e fuori standard: velature, un pieno per ogni bottone, raggi predefiniti. Entrambi i riferimenti, non uno.Il predefinito di Mantine non coincide con lo standard su quattro punti: raggi troppo morbidi — e in v9 il predefinito è salito da sm a md —, corpo del testo a 16px, spaziature diverse dalla scala a 4px, e un colore primario da definire. Il tema li allinea una volta per tutte.
// theme.ts — le sole sostituzioni che servono export const theme = createTheme({ fontFamily: 'IBM Plex Sans, system-ui, sans-serif', fontFamilyMonospace: 'IBM Plex Mono, ui-monospace, monospace', headings: { fontFamily: 'IBM Plex Sans, system-ui, sans-serif', fontWeight: '600' }, // corpo 15px: il predefinito Mantine (md = 16) è troppo grande per una tabella densa, // sm (14) troppo piccolo per il testo principale. 13px è il pavimento assoluto. fontSizes: { xs: '13px', sm: '14px', md: '15px', lg: '17px', xl: '20px' }, lineHeights: { xs: '1.4', sm: '1.5', md: '1.55', lg: '1.5', xl: '1.35' }, // raggi 5 / 8 / 12 — Mantine parte da 2/4/8/16/32, troppo morbido da lg in su. // defaultRadius resta 'sm': in v9 il predefinito di libreria è md, quindi qui è una scelta nostra. radius: { xs: '3px', sm: '5px', md: '8px', lg: '12px', xl: '12px' }, defaultRadius: 'sm', // scala a 4px spacing: { xs: '8px', sm: '12px', md: '16px', lg: '24px', xl: '32px' }, // il primario è la DOMINANTE scelta a inizio prodotto: bordeaux o celeste. // I due array stanno in palette-bordeaux.ts / palette-celeste.ts. primaryColor: 'brand', primaryShade: { light: 7, dark: 5 }, colors: { brand: brandScale, accent: accentScale, ...semantic }, // nessuna ombra sui componenti fermi: l'ombra è solo per ciò che galleggia shadows: { xs: 'none', sm: 'none', md: '0 4px 14px rgba(15,17,21,.10)', lg: '0 10px 30px rgba(15,17,21,.14)' }, components: { Badge: { defaultProps: { variant: 'outline', radius: 'sm' } }, Alert: { defaultProps: { variant: 'outline', radius: 'md' } }, Card: { defaultProps: { withBorder: true, shadow: undefined, radius: 'md' } }, Paper: { defaultProps: { withBorder: true, shadow: undefined } }, Table: { defaultProps: { striped: false, withRowBorders: true, verticalSpacing: 'xs' } }, Modal: { defaultProps: { radius: 'md', centered: true } }, Drawer: { defaultProps: { position: 'right', radius: 0 } }, Button: { defaultProps: { radius: 'sm' } }, Tabs: { defaultProps: { variant: 'outline' } }, }, // NESSUN cssVariablesResolver. In v9 la variante light usa colori solidi: // v8CssVariablesResolver ripristinerebbe le velature che il sistema ha escluso. });
style ripetuto su venti Badge è un token mancante nel tema. Se una regola vale per tutta l'applicazione, va in theme.components, dove si cambia in un punto.Confermati: Mantine 9 su React 19.2 senza mantine-datatable · tabelle spesso oltre le dieci colonne, quindi selettore di colonne e prima colonna bloccata · icone Tabler · navigazione che si riduce a 64px, con 10-12 voci macro al primo livello · agende con @mantine/schedule, non più disegnate a mano.
Resta da scrivere il nucleo: comportamento a dati assenti, scrittura dei testi, tastiera e fuoco, conferme e salvataggio. È lo strato dichiarato non derogabile e oggi conta poche righe.