POS Receipt
Un POS leggero che alcune associazioni del paese in cui vivo usano durante le sagre — anche se, a dispetto del nome, di pagamenti elettronici non ne gestisce: niente carte di credito né POS bancari, si ferma a ordini, scontrini e magazzino. Si compone l'ordine dal menu, si stampa lo scontrino da 51 mm con le comande per la cucina e per il bar, e le scorte scalano da sole: in cassa e in cucina si sa sempre cosa è ancora disponibile. Backend Flask con API REST su MySQL, frontend in un unico file HTML senza framework né build, tutto in rete locale.

La sfida che ho risolto
Prima si scriveva tutto a mano. Le cassiere segnavano l'ordine su un foglio, e ogni ordine costava tempo: tempo per scriverlo, tempo per fare i conti a mente, tempo con la fila che si allungava dietro. E bastava una riga sbagliata o una grafia poco chiara perché la confusione arrivasse fino in cucina. Poi c'era il magazzino, che semplicemente non esisteva: senza un conteggio aggiornato capitava di vendere un piatto già finito e accorgersene solo quando bisognava tornare dal cliente a disdire. Ora l'ordine si compone toccando il menu, i conti li fa il programma, e le scorte scalano a ogni scontrino: quello che è finito si vede prima di venderlo.
Cosa fa
È il programma che alcune associazioni del paese in cui vivo usano come registratore di cassa e magazzino durante le feste. Alla cassa si prende l’ordine, si stampa lo scontrino e si va avanti; in cucina interessa una cosa sola, sapere in tempo reale quante porzioni restano di ciascun piatto. Il resto del programma esiste per tenere insieme queste due cose.
L’interfaccia è divisa in cinque schede — Ordini, Magazzino, Statistiche, Scontrini e Impostazioni — e si usa da un PC alla cassa, oppure da un tablet in sala collegato allo stesso server.
Come funziona
Il giro di un ordine è tutto qui. Si scelgono i prodotti dal menu, si indicano i coperti ed eventualmente il nome del cliente e una nota, poi si passa al riepilogo: lì compaiono subtotale, coperto calcolato sul numero di persone e totale, e c’è ancora modo di correggere una quantità o togliere una riga prima di confermare. Alla conferma, in un’unica transazione il backend registra lo scontrino con le sue righe e scala le scorte dei prodotti ordinati. Da quel momento il magazzino è aggiornato per tutti: chi guarda la scheda Magazzino da un altro dispositivo vede le stesse quantità.
Poi c’è la stampa, che è la parte che mi piace di più. Quello che esce dalla termica da 51 mm non è un foglietto solo: il primo è lo scontrino per il cliente, con il riepilogo e il totale, e a seguire c’è una comanda separata per ogni reparto coinvolto — il cameriere per il cibo, il bar per le bevande, il bar per i caffè. Ogni comanda riporta soltanto le righe di sua competenza e viene stampata solo se l’ordine contiene qualcosa di quella categoria: un giro di sole birre non produce comande per la cucina. Sono tutte sulla stessa striscia, separate dai tratteggi su cui si strappa, e la pagina è impostata con larghezza fissa e altezza automatica, così esce della lunghezza giusta senza sprecare carta.
Ogni scontrino resta consultabile, ricercabile per nome cliente e ristampabile dalla scheda dedicata; se viene eliminato — un ordine sbagliato, un cliente che cambia idea — le quantità tornano in magazzino, perché la cancellazione fa l’operazione inversa e riaccredita le scorte.
Il Magazzino gestisce i prodotti: prezzo, giacenza, categoria, creazione e cancellazione. L’ordine con cui compaiono nel menu si cambia trascinandoli, il che sembra un dettaglio ma alla cassa conta parecchio: i piatti più richiesti si vogliono in cima, e cambia da una festa all’altra. Le Statistiche danno il riepilogo di incassi, coperti e pietanze vendute — anche questo stampabile, utile a fine serata — con la possibilità di azzerare tutto prima dell’evento successivo. Nelle Impostazioni si mettono nome, indirizzo, data dell’evento e prezzo del coperto, cioè quello che finisce in testa allo scontrino, e si gestiscono categorie e prodotti.
Com’è fatto
Il backend è Python con Flask: una API REST su MySQL e poco più di una dozzina di endpoint, con le operazioni delicate — creazione ed eliminazione di uno scontrino — chiuse dentro una transazione, in modo che scorte e righe d’ordine non possano mai restare disallineate. Lo schema è quattro tabelle più le impostazioni, con vincoli di chiave esterna che impediscono di cancellare un prodotto già finito su uno scontrino.
Il frontend è deliberatamente spartano: un solo file HTML con dentro CSS e
JavaScript, nessun framework, nessuna build, nessuna dipendenza da scaricare.
Si apre in un browser e funziona. È una scelta presa guardando dove gira
davvero — un portatile prestato, sotto un tendone, spesso senza connessione — e
dove l’unica cosa che conta è che la sera della festa si accenda e parta. Su
Windows c’è un .bat che avvia backend e frontend e apre la pagina: doppio
clic e si lavora. Gli altri dispositivi puntano all’IP locale del server e
vedono gli stessi dati.
Screenshot
Riepilogo: subtotale, coperto calcolato sulle persone e totale, ancora modificabile.
Stampa: lo scontrino del cliente e una comanda per ogni reparto coinvolto.
Magazzino: prezzi e giacenze modificabili al volo, ordine del menu trascinabile.
Statistiche: incassi, coperti e pietanze vendute, azzerabili a fine evento.
Scontrini: ricerca per cliente, ristampa e annullamento con ripristino delle scorte.
Impostazioni: intestazione dello scontrino, prezzo del coperto, categorie e prodotti.