La descrizione originale
« Siamo due meccanici. Ogni ordine di riparazione riguarda un veicolo di un cliente, con diagnosi, interventi effettuati, ricambi utilizzati, ore impiegate e uno stato: ricevuto, diagnosticato, approvato, in lavorazione, completato, fatturato. Alcuni ordini attendono ricambi. Voglio vedere il carico di lavoro giornaliero, gli ordini in attesa di ricambi e quanto fatturabile nella settimana. »
Il piano convalidato prima della generazione
Prima di scrivere una sola riga di codice, Blueprint Maker traduce questa descrizione in un piano da convalidare. Per GarageClair, il piano proposto occupa un solo schermo: cinque entità, Ordine di riparazione, Veicolo, Cliente, Ricambio, Meccanico, e le loro relazioni: un ordine riguarda un veicolo, un veicolo appartiene a un cliente, un ordine utilizza ricambi e coinvolge un meccanico.
Anche gli stati dedotti dal testo compaiono nel piano: l’ordine di riparazione passa per ricevuto, diagnosticato, approvato, in lavorazione, completato, fatturato. I tre indicatori richiesti (carico di lavoro giornaliero, ordini in attesa di ricambi, fatturabile settimanale) sono esplicitati nero su bianco. Se manca qualcosa o c’è qualcosa di superfluo, lo si corregge qui: ciò che viene generato corrisponde esattamente a quanto annunciato.
- Entità: Ordine di riparazione, Veicolo, Cliente, Ricambio, Meccanico
- Relazioni: ordine → veicolo; veicolo → cliente; ordine → ricambi; ordine → meccanico
- Stati: ricevuto / diagnosticato / approvato / in lavorazione / completato / fatturato
- Indicatori: ordini di riparazione suddivisi per stato, ordini di riparazione in attesa di ricambi, ore fatturabili della settimana
La navigazione: una sezione per ogni entità
L’applicazione generata si apre con una barra laterale sobria: Dashboard, Ordini di riparazione, Veicoli, Clienti, Ricambi. Ogni sezione porta a una lista: non un semplice cahier d’atelier, ma una vera lista software, campo di ricerca in cima, colonne ordinabili con un clic, paginazione.
La lista degli ordini di riparazione mostra il veicolo, il cliente, lo stato sotto forma di badge colorato, la data di ricezione e l’importo fatturabile allineato a destra nel formato valutario. Un ordine in attesa di ricambi si riconosce immediatamente. Per i veicoli, un filtro per cliente e l’ordinamento per data dell’ultimo intervento permettono di ritrovare la cronologia in due clic.
La scheda veicolo, con tutta la sua cronologia
Cliccare su «Peugeot 308, AB-123-CD» apre la sua scheda: targa, cliente (cliccabile, porta alla scheda cliente), chilometraggio e soprattutto la parte che cambia tutto rispetto al registro cartaceo: la cronologia degli ordini di riparazione di QUESTO veicolo, in forma di tabella datata: 14 marzo, sostituzione frizione, fatturati 320 €; 2 giugno, tagliando, fatturati 145 €.
Questo collegamento non è puramente estetico: nasce direttamente dal database relazionale generato. Un cliente che richiama per la frizione trova la scheda in un clic, e la domanda che costava cara al vecchio registro scompare del tutto.
Inserimento di un ordine di riparazione
Il modulo «Nuovo ordine» è breve perché la struttura fa gran parte del lavoro: il veicolo si seleziona da un menu a tendina (niente targa da riscrivere manualmente, quindi niente errori di battitura), lo stato è una scelta tra le sei opzioni definite, i ricambi utilizzati si aggiungono uno alla volta con la relativa quantità e un campo dedicato alla diagnosi accoglie il testo libero del meccanico.
Al salvataggio, la lista degli ordini, la scheda veicolo e la dashboard riflettono immediatamente l’inserimento: tutti gli schermi leggono dallo stesso database.
La dashboard: i dati del pitch, calcolati sul database
La dashboard riprende esattamente gli indicatori richiesti nella descrizione: gli ordini in lavorazione suddivisi per stato, il numero di ordini in attesa di ricambi, le ore fatturabili della settimana e i veicoli consegnati nel mese.
Questi dati derivano da query sul database, non da inserimenti manuali: ogni modifica dello stato o aggiunta di un ricambio li aggiorna automaticamente. Un grafico semplice accompagna le tessere, mostrando la ripartizione degli ordini per stato, senza fronzoli: l’obiettivo è rispondere ogni mattina alle domande poste nel pitch.
Dati dimostrativi: valutare su schermate complete
GarageClair arriva già popolato: diversi mesi di attività simulata, una trentina di veicoli con targhe plausibili, una ventina di clienti, ordini di riparazione a ogni stadio e una gamma variegata di ricambi, inclusi, intenzionalmente, alcuni ordini in attesa di ricambi per verificare il funzionamento del filtro.
È una scelta deliberata: non si valuta uno strumento di gestione su tabelle vuote. I dati dimostrativi vengono poi cancellati per lasciare spazio ai dati reali. L’applicazione è accessibile tramite il suo URL dedicato e il codice sorgente completo è esportabile (ZIP o push su GitHub), standard Next.js + Prisma.