La descrizione originale
« Gestisco un'officina di riparazione di macchine da giardinaggio. Gestisco un magazzino di ricambi: ogni articolo ha un codice, un prezzo d'acquisto e una soglia di allerta, ed è collegato a un fornitore. Il magazzino si muove in entrata quando ricevo un ordine fornitore, in uscita quando un pezzo va su una riparazione. Voglio vedere il valore totale del magazzino, gli articoli sotto la soglia di allerta e i movimenti del mese. »
Il piano convalidato prima della generazione
Prima di scrivere una sola riga, Blueprint Maker traduce questa descrizione in un piano da convalidare. Per StockAtelier, il piano proposto sta in una schermata: quattro entità — Articolo, Fornitore, Movimento di magazzino, Ordine fornitore — e i loro collegamenti: un articolo appartiene a un fornitore, un movimento riguarda un articolo, un ordine raggruppa righe di articoli.
Anche gli stati dedotti dal testo appaiono nel piano: il movimento è un'entrata o un'uscita; l'ordine fornitore passa per bozza, inviato, ricevuto. I tre indicatori richiesti (valore del magazzino, articoli sotto soglia, movimenti del mese) figurano nero su bianco. Se un elemento manca o è di troppo, lo si corregge qui — ciò che viene generato è ciò che è stato annunciato.
- Entità: Articolo, Fornitore, Movimento di magazzino, Ordine fornitore
- Relazioni: articolo → fornitore; movimento → articolo; riga d'ordine → articolo
- Stati: entrata / uscita; bozza / inviato / ricevuto
- Indicatori: valore del magazzino, articoli sotto soglia, movimenti su 30 giorni
La navigazione: una sezione per entità
L'applicazione generata si apre su una barra laterale sobria: Cruscotto, Articoli, Fornitori, Movimenti, Ordini. Ogni sezione porta a un elenco — non un foglio di calcolo, un vero elenco di applicazione: campo di ricerca in testa, colonne ordinabili con un clic, paginazione.
L'elenco degli articoli mostra il codice, il nome, il fornitore, la quantità in magazzino, il prezzo d'acquisto allineato a destra in formato monetario e la soglia di allerta. Un articolo sceso sotto la sua soglia si individua immediatamente. Sul lato movimenti, un filtro per tipo (entrata / uscita) e l'ordinamento per data rimettono in mano lo storico in due clic.
La scheda articolo, con il suo storico
Cliccare su «Cinghia GX-390» apre la sua scheda: codice, fornitore (cliccabile, porta alla scheda fornitore), prezzo d'acquisto, quantità in magazzino, soglia di allerta. Sotto arriva la parte che cambia tutto rispetto al foglio di calcolo: lo storico dei movimenti di QUESTO articolo, in tabella datata — 12 marzo, entrata di 20 unità alla ricezione dell'ordine CF-2024-018; 27 marzo, uscita di 2 unità.
Questo collegamento non è cosmetico: viene dal database relazionale generato. Rinominare l'articolo lo rinomina ovunque, e la quantità visualizzata deriva dai movimenti — nulla è ricopiato a mano.
La registrazione di un movimento di magazzino
Il modulo «Nuovo movimento» è breve perché la struttura fa il lavoro: l'articolo si sceglie da un menu a tendina (nessun codice ridigitato a mano, quindi nessun refuso), il tipo è una scelta entrata / uscita, la quantità è un campo numerico, la data è precompilata a oggi, un campo commento accoglie il contesto («riparazione tosaerba sig. Bernard»).
Al salvataggio, l'elenco dei movimenti, la scheda dell'articolo e il cruscotto riflettono la registrazione — è lo stesso database per tutte le schermate.
Il cruscotto: le cifre del pitch, calcolate sul database
Il cruscotto riprende esattamente gli indicatori richiesti nella descrizione: il valore totale del magazzino in euro (somma delle quantità × prezzi d'acquisto), il numero di articoli sotto la loro soglia di allerta, il volume dei movimenti su 30 giorni e una ripartizione del magazzino per fornitore.
Queste cifre sono query sul database, non registrazioni: ogni entrata o uscita registrata le aggiorna. Un grafico semplice accompagna le tessere — l'andamento dei movimenti nelle ultime settimane — senza effetti scenici: l'obiettivo è rispondere ogni mattina alle domande poste nel pitch.
I dati dimostrativi: giudicare su schermate piene
StockAtelier arriva riempito: diversi mesi di vita simulata, una trentina di articoli dai nomi plausibili (cinghie, candele, lame, filtri dell'aria), quattro fornitori, ordini a tutti gli stadi e movimenti distribuiti nel tempo — tra cui, di proposito, alcuni articoli sotto la loro soglia per vedere l'allerta funzionare.
È una scelta deliberata: non si giudica uno strumento di gestione su tabelle vuote. I dati dimostrativi si cancellano poi per lasciare posto a quelli veri. L'applicazione vive sul suo URL dedicato, e il suo codice sorgente completo si esporta (ZIP o push GitHub) — Next.js + Prisma standard.