Salta al contenuto
Uso personale

ristocrm — gestionale modulare per ristoranti e hotel

Gestionale SaaS modulare per ristoranti e hotel a licenza firmata crittograficamente (Ed25519): dalla sala alla cucina, dal check-in hotel al report vendite, ~215 test automatici.

Progetto privato — in uso personale
  • Node.js
  • TypeScript
  • Express
  • SQLite
  • Vitest
  • Playwright
  • Ed25519
ristocrm — gestionale modulare per ristoranti e hotel

Gestionale modulare per ristoranti e strutture ricettive, costruito come prodotto SaaS a licenza modulare: ogni cliente attiva solo i moduli di cui ha bisogno e il sistema li abilita dinamicamente in base a una licenza firmata crittograficamente, senza bisogno di build separate.

In sintesi

ristocrm copre l'intero ciclo operativo di un locale — dalla prenotazione del tavolo all'incasso, dal check-in in hotel alla sincronizzazione della disponibilità con le OTA — restando gestibile da un unico pannello, con ruoli e permessi diversi per amministratore, sala, cucina e magazzino.

Per chi

Piccoli e medi ristoranti, B&B e hotel boutique che oggi gestiscono prenotazioni, comande, magazzino e camere con strumenti scollegati tra loro (carta, WhatsApp, fogli Excel). Ruoli staff configurabili — non solo i quattro di default: si possono creare ruoli su misura scegliendo sezione per sezione cosa vedono.

Cosa fa

Ristorante — Menu e sito

  • Menu con categorie, prezzi, allergeni e foto piatto; menu a tema con date di attivazione (es. menu di Natale).
  • Link pubblico condivisibile per ogni menu, editor del sito a blocchi con pagine personalizzabili, upload di siti già pronti in bundle ZIP.
  • Gestione di logo e foto header per il branding del locale.

Ristorante — Sala e ordini

  • Piantina sala interattiva (drag & drop), multi-sala, vista a elenco alternativa; stati tavolo: libero, occupato, da pulire, riservato.
  • QR/link unico per tavolo (menu, ordina, segnala allergie), presa comande da parte dello staff.
  • Display cucina (KDS) in tempo reale con stati piatto (in attesa → in preparazione → pronto → servito), self-ordering da smartphone per i tavoli a menu fisso.

Ristorante — Conto, cassa e fornitori

  • Calcolo conto con coperto e servizio configurabili, incasso multi-metodo, emissione scontrino (provider fiscale collegabile).
  • Anagrafica fornitori, magazzino con soglie di scorta minima e storico movimenti, ordini d'acquisto (bozza → inviato → ricevuto).
  • Collegamento ricetta → ingredienti, con scarico automatico del magazzino a ogni vendita.

Ristorante — Prenotazioni e allergeni

  • Prenotazione tavolo self-service dal sito, con conferma o rifiuto da parte dello staff.
  • Segnalazione allergie dal tavolo via QR, risolta in tempo reale con badge visibile in Sala.

Ristorante — All you can eat

  • Prezzo fisso per adulto/bambino (con età massima bambino), supplementi su piatti premium.
  • Limite di tempo al tavolo e penale per piatto avanzato.

Hotel

  • Tipologie di camera con galleria foto, descrizione, servizi e capienza; tariffe per periodo/stagione.
  • Camere fisiche assegnate al check-in, housekeeping (libera/occupata/pulizia/manutenzione).
  • Prenotazione self-service con pagina pubblica dedicata per camera, o diretta da staff (telefono/walk-in); check-in/check-out, fatture interne.
  • Sincronizzazione disponibilità via iCal: esportazione pubblica e importazione da OTA esterne (Booking.com, Airbnb).

Trasversali (ristorante e hotel)

  • Notifiche automatiche agli ospiti (email/SMS) su richiesta, conferma e annullamento.
  • Acconti online — caparra fissa o percentuale — con incasso manuale come alternativa.
  • Report vendite: incassi, scontrino medio, piatti più venduti, incasso per metodo di pagamento.

Piattaforma e gestione staff

  • Account staff con login proprio, ruoli configurabili scegliendo sezione per sezione cosa ciascuno può vedere.
  • Registro azioni (chi ha incassato, risolto un allergene, ricevuto un ordine fornitore...).
  • Hub d'ingresso Ristorante/Hotel quando entrambi i moduli sono attivi, tema chiaro/scuro nativo su tutto il pannello.

Licensing (lato fornitore)

  • Moduli attivabili singolarmente per cliente via licenza firmata digitalmente, funzionamento offline con periodo di grazia.
  • Console web per vedere lo stato dei clienti, sospendere o revocare una licenza.
  • Console locale per generare nuove licenze senza riga di comando.

Architettura, stack tecnico e i problemi ingegneristici reali affrontati lungo il percorso.

Screenshot

Modalità:
Schermata di ingresso: si sceglie l'area da gestire (Ristorante o Hotel) in base ai moduli attivi in licenza.
Piantina sala interattiva multi-sala, stato dei tavoli in tempo reale (libero/occupato/da pulire/riservato).
Comande in tempo reale per tavolo, sempre a tema scuro per leggibilità durante il servizio — vedi episodio 7 del diario di sviluppo.
Permessi granulari sezione per sezione: ogni ruolo vede solo le aree del pannello di sua competenza.
Incassi, scontrino medio, piatti più venduti e incassi per metodo di pagamento nel periodo scelto.
Pagina self-service dedicata a ogni tipologia di camera, con verifica disponibilità in tempo reale — vista ospite, non staff.