Guida · Edizione 2026

Tutto quello che ti serve sapereper usare MA OS.

Setup iniziale, flusso quotidiano in cucina e sala, gestione HACCP, fiscale, ruoli del tuo team. Le 13 sezioni qui sotto coprono tutto. Cliccando su un link nella sidebar salti direttamente alla sezione.

/ 01

Primo accesso

Il titolare crea l'account dalla pagina /signup inserendo nome ristorante, P.IVA e indirizzo. Riceve email di conferma, accede a /dashboard.

Il dashboard è personalizzato per ruolo: il titolare vede anche incassi e analytics, il cameriere solo sala/comande/CRM.

Onboarding wizard — guida automatica di 5 step

Subito dopo il signup, MA OS apre il /dashboard/onboarding che ti porta passo-passo attraverso il setup minimo: dati ristorante, PIN titolare, sala+tavoli, stazione cucina, primo piatto a menu. Puoi saltare uno step e tornarci più tardi.

Se non lo completi, sulla home dashboard vedrai un banner rosso "Continua setup" con la percentuale di completamento e pillole dei passi rimanenti. Sparisce quando finisci o quando clicchi "Vai al dashboard" alla fine del wizard.

Cosa configurare PRIMA di aprire al pubblico

  • Sala e tavoli — da /dashboard/sala disegna le aree (dehors, sala principale, terrazza) e aggiungi i tavoli con numero posti.
  • Menu — categorie e piatti con allergeni, prezzo, categoria di stampa cucina.
  • Stazioni cucina — pizza, cucina, bar, dolci. Collega categorie menu a stazioni.
  • Stampanti — IP delle stampanti termiche LAN + Brother QL per le etichette.
  • Staff — dipendenti con ruolo e PIN (4 cifre).
  • POS bancari — matricola Nexi/SumUp/Ingenico + matricola RT (obbligo collegamento dal 5 marzo 2026).

/ 02

Apertura tablet e selezione operatore

All'apertura della PWA su tablet, MA OS chiede chi sei oggi: tocca la tua card, digita il PIN, scegli se "Ricordami su questo tablet" (cookie 30 giorni) o no (cookie di sessione).

Se nel ristorante c'è un solo staff attivo senza PIN, MA OS salta la schermata automaticamente. La tua "performance card" in alto mostra una percentuale di engagement.

In qualsiasi momento puoi cambiare operatore dal pulsante "Cambia" sotto il tuo nome nella sidebar.

/ 03

Comande sala / asporto / consegna

Dalla pagina /dashboard/comande hai due opzioni: tap su un tavolo, oppure pulsante "+ Nuovo asporto / consegna" per comande senza tavolo.

All'interno della comanda, scegli la categoria menu (Antipasti, Primi, Pizza, ecc.) e tappa il piatto per aggiungerlo. Il "+" buffer permette di toccare velocemente più volte senza roundtrip server: 6 tap = 1 chiamata con quantità 6.

Modificatori e note

Per piatti con modificatori configurati (senza pomodoro, + mozzarella, ecc.), si apre il dialog opzioni. Per note libere usa "+ Nota" sulla riga della comanda.

Invio in cucina

Le righe in stato "da inviare" diventano "inviate" col pulsante Invia X item in cucina. Vengono stampate sulla stampante della stazione di riferimento e compaiono nel KDS Cucina.

Pagamento e chiusura

I pulsanti Cash · Carta · Altro aprono il dialog di pagamento. Per carta seleziona il POS terminale (auto-selezione se ce n'è uno solo). Inserisci il codice lotteria (8 caratteri A-Z 0-9) se il cliente lo fornisce. Conferma → emette documento commerciale + chiude comanda.

/ 04

KDS — Display cucina

Apri /dashboard/kitchen su un tablet in cucina. Mostra le comande aperte in card colorate per tipo servizio.

  • Bordo arancione = asporto, blu = consegna, normale = tavolo.
  • Numero comanda in alto, tempo di attesa colorato (verde < 5 min, ambra < 15, rosso oltre).
  • 1 tap sul piatto → in preparazione. 2 tap → pronto.
  • Quando tutti i piatti sono pronti → Tutto uscito chiude e libera il tavolo.

Suono opzionale per nuovi piatti. Auto-refresh ogni 30s + realtime via Supabase per update istantanei.

/ 05

Task giornata (assegnati a staff)

Da /dashboard/tasks il titolare crea cose da fare: "sfilettare 4 orate entro le 18", le assegna a Mario, e Mario le vede sulla sua dashboard.

Tap ▶ Prendo in carico, poi ✓ Fatto con note opzionali. Il titolare vede in tempo reale chi ha completato cosa, con timestamp e nome.

Categorie disponibili: cucina, prepping, sala, bar, magazzino, pulizie, manutenzione, amministrativo, altro. Priorità bassa/media/alta + scadenza datetime.

/ 06

HACCP — Conformità sanitaria

La sezione /dashboard/haccp raccoglie 11 moduli obbligatori per la conformità Reg. CE 852/2004 + 853/2004 + normativa italiana.

Frigoriferi

Letture firmate, soglie min/max, alert non-conformità.

Abbattimento

Cicli pesce crudo, semilavorati. Anti-anisakis Reg. 853.

Decongelamento

Registro prodotti con shelf life dopo decongelo.

Etichette rapide

Stampa 3 tap nome+scadenza+operatore+lotto.

Cambio olio friggitrice

Scadenza per giorni/ore d'uso + lotto fornitore.

Pulizia / sanificazione

Task ricorrenti firmati con frequenza.

Tracciabilità lotti

Forward e backward. Pesce: zona FAO + metodo.

Lotta infestanti

Roditori + striscianti + volanti + interventi esterni.

Oli esausti FIR/RENTRI

CER 200125 + Albo Gestori + alert 4ª copia.

Compliance dashboard

Score globale conformità con 14+ check.

Export audit

Report PDF stampabile per ASL.

/ 07

Documenti normativi stampabili

  • Cartello unico ingredienti (/dashboard/menu/cartello-unico) — obbligatorio per locali con vendita prodotti sfusi nelle 5 categorie del D.M. 20/12/1994 (gelateria, pasticceria, panetteria, pasta fresca, gastronomia).
  • Corrispettivi AdE (/dashboard/corrispettivi) — XML giornaliero esportabile per upload su Fatture e Corrispettivi.
  • Documento commerciale — stampa scontrino non fiscale dalla cassa (in attesa integrazione RT).
  • Export dati GDPR (Impostazioni → Esporta i miei dati) — JSON con tutto il tenant.

/ 08

Fiscale (RT + POS + Lotteria)

MA OS supporta il flusso fiscale italiano end-to-end. Stato attuale del pilot:

  • Codice lotteria scontrini — campo a 8 caratteri in cassa, stampato sul documento.
  • POS bancari — registra terminali (Nexi, SumUp, Ingenico) con matricola.
  • Collegamento POS-RT — campo matricola RT per ogni POS (obbligo 5 marzo 2026).
  • Chiusura giornaliera Z-report — chiusura cassa con XML AdE generato.
  • Driver RT reale — in fase di sviluppo. Per ora gli scontrini sono documenti commerciali non fiscali: mantieni in parallelo il vecchio sistema fiscale.

/ 09

Tablet, PWA, dispositivi

MA OS è ottimizzato per tablet landscape 11"+ (Lenovo Tab M11, Samsung Tab A9+, iPad). Funziona su tutti i browser moderni.

Installare come app (PWA)

  • Android Chrome: tocca i tre puntini → "Installa app".
  • iOS Safari: tocca condividi → "Aggiungi a Home".

L'app installata gira a tutto schermo, ha icona dedicata, funziona offline per le pagine già visitate.

Pull-to-refresh

Su smartphone/tablet, scorri verso l'alto e trascina giù per ricaricare i dati. L'indicatore rosso si riempie man mano che trascini.

/ 10

Ruoli e permessi

MA OS gestisce 5 gruppi di ruoli con permessi differenziati.

GruppoRuoli inclusiCosa vede
AdminTitolare, co-titolare, managerTutto: incassi, analytics, scontrini, impostazioni
Sala+ Cameriere, hostSala, comande, prenotazioni, CRM cliente
Cucina+ Chef, sous chef, aiuto-cuoco, cucinaKDS Cucina, HACCP, magazzino
HACCP+ MagazziniereTutti i moduli HACCP
MagazzinoMagazziniere + sous chef + adminMagazzino, ingredienti, fornitori, ordini

Quando un utente apre una rotta non permessa, MA OS lo reindirizza automaticamente alla sua "home" di ruolo (cameriere → /comande, chef → /kitchen).

/ 11

Domande frequenti

Posso cancellare una comanda dopo che l'ho inviata in cucina?

Sì, finché non è stata pagata o chiusa. I singoli piatti possono essere offerti (Comp) con motivazione e operatore tracciato, oppure annullati (Void) se la cucina non li ha ancora preparati.

Cosa succede se cambio operatore con una comanda aperta?

La comanda resta aperta. Cambiare operatore non chiude nulla: tu sei l'identità sul tablet, le comande sono entità persistenti del ristorante.

Come gestisco un cliente con allergia?

Aggiungi il cliente in CRM con il campo allergie. Quando lo associ a una comanda, le allergie sono evidenziate al cameriere e (se configurato) in cucina.

Il PIN dell'operatore lo dimentico, come faccio?

Il titolare può resettare il PIN dalla pagina Staff in Impostazioni. Per sicurezza nessuno può vedere il PIN dell'altro: si può solo reimpostarlo.

Quanto tempo restano i dati nel sistema?

Sempre, finché il tuo abbonamento è attivo. Puoi esportare tutti i tuoi dati in JSON in qualsiasi momento (diritto GDPR) da Impostazioni → Esporta i miei dati. Alla disdetta i dati restano disponibili 30 giorni poi vengono cancellati.

Posso usare MA OS senza connessione?

Parzialmente. Le pagine già caricate funzionano offline grazie alla PWA, ma le scritture (nuove comande, pagamenti) richiedono connessione. Per la sala consigliamo un router WiFi 6 dedicato.

Quanto costa?

Durante la fase pilot è gratuito. A regime: piano Essential 129€/mese (lock 2 anni) o 159€/mese (lock 1 anno); piano Pro 169€/mese (lock 2 anni) o 199€/mese (lock 1 anno). Tablet incluso in comodato d'uso (deve tornare integro a fine contratto). + IVA quando applicabile.

/ 12

MA Bot — assistente AI

In ogni pagina del sito trovi una bolla rossa 💬 in basso a destra: è MA Bot, un assistente conversazionale che risponde a domande tipo "come faccio questa cosa" e suggerisce il link diretto alla pagina giusta del software.

Esempi di domande che MA Bot capisce bene

  • "Come faccio una comanda asporto?"
  • "Dove configuro le stazioni cucina?"
  • "Cosa è il cartello unico?"
  • "Come assegno un task al cameriere Mario?"
  • "Come stampo le etichette HACCP?"
  • "A che serve l'abbattimento?"

Cosa MA Bot NON fa

  • Non crea comande / task / etichette al posto tuo (zero rischio di azioni inattese).
  • Non vede i tuoi dati operativi (clienti CRM, scontrini, registri HACCP).
  • Non sostituisce il commercialista o il consulente HACCP.

MA Bot è basato sull'API Google Gemini. Quando lo usi, il testo della domanda viene inviato a Google per generare la risposta. Per dettagli vedi Privacy §5-bis. Evita di scrivere a MA Bot nomi di clienti, allergie nominali o altri dati sensibili.

/ 13

Supporto

Hai bisogno di aiuto? Scrivici, rispondiamo in giornata lavorativa (sabato sera incluso durante il servizio per i clienti pilot).

Mangiare A di Barani Stefano · P. IVA IT01894110335

Guida operativa · MA OS