1. Dashboard

/ (Home) e /dashboard-finanziaria

La dashboard mostra una panoramica generale con:

• Numero totale di prodotti, ingredienti, ricette
• Statistiche fatture
• Prodotti non collegati a ingredienti
• KPI finanziari (spese, incassi, margine)
• Trend mensile
• Scadenze imminenti

2. Gestione Fatture

/fatture

3. Gestione Ingredienti

/ingredienti

Anagrafica completa degli ingredienti con:

• Nome, unita di misura, prezzo al kg/litro
• Macro categoria (Food, Beverage, Packaging, Detergenza)
• Categoria ingrediente (sottocategorie personalizzabili)
• Allergeni (glutine, lattosio, crostacei, etc.)
• Storico prezzi nel tempo con grafico andamento
• Utilizzo nelle ricette

4. Ricette e Sottoricette

/ricette

Gestione delle ricette con calcolo automatico del food cost:

• Creazione ricette con ingredienti e quantita
• Sottoricette - preparazioni base riutilizzabili in altre ricette
• Calcolo automatico costo per porzione
• Food cost percentage
• Visualizzazione ingredienti nidificati (quando si usa una sottoricetta)

5. Drinks

/drinks

Gestione cocktail e bevande:

• Codice drink progressivo automatico
• Ingredienti con quantita (ml, cl, etc.)
• Costo calcolato automaticamente
• Prezzo vendita e margine

6. Menu

/menus

Composizione menu completi:

• Aggiunta ricette al menu
• Aggiunta drinks al menu
• Calcolo food cost totale menu
• Prezzo suggerito basato su target margine

7. Preventivi

/preventivi

Creazione preventivi per eventi/catering:

• Upload PDF preventivi con estrazione automatica
• Gestione righe preventivo
• Stati: bozza, inviato, accettato, rifiutato

8. Magazzino

/magazzino

Gestione giacenze multi-ristorante:

• Ristoranti: Configurazione punti vendita
• Giacenze: Quantita in stock per ingrediente/ristorante
• Movimenti: Carichi (da fattura), scarichi (consumo), trasferimenti
• Alert scorte minime
• Valore magazzino per ristorante

Tipi di movimento

• carico: Entrata merce (da fattura)
• scarico: Uscita merce (consumo, vendite, sprechi)
• trasferimento: Spostamento tra ristoranti
• rettifica: Correzione inventariale

9. Inventario

/inventario

Sistema completo per inventari fisici:

• Creazione inventario: Per ristorante e macro-area (Food, Beverage, etc.)
• Righe inventario: Lista ingredienti da contare
• Pesate multiple: Supporto contenitori con tara
• Sessioni condivise: Link per inventario collaborativo via mobile

Contenitori con tara

Configura contenitori standard (secchi, gastronorm, etc.) con tara preimpostata per calcolo automatico del peso netto.

10. Gestione Finanziaria

Prima Nota /prima-nota

Registrazione movimenti finanziari: entrate e uscite, categorizzate per centro di costo, con collegamento a fatture/scadenze. Import da estratto conto bancario.

Centri di Costo /centri-costo

Definizione centri di costo per analisi spese: Cucina, Bar, Sala, Amministrazione, etc.

Banche /banche

Gestione conti bancari: configurazione IBAN/saldo, import movimenti, riconciliazione automatica con fatture.

Carte di Credito /carte-credito

Gestione carte aziendali: plafond, estratti conto PDF, tracciamento utilizzo.

10b. Prima Nota - Guida Dettagliata

/prima-nota

La Prima Nota e il registro cronologico di tutti i movimenti contabili dell'attivita. Permette di tracciare entrate e uscite, categorizzarle e collegarle a fatture e conti bancari.

Struttura della Pagina

La pagina e organizzata in 3 tab principali:

• Prima Nota: Movimenti contabili manuali e automatici
• Movimenti Bancari: Import e riconciliazione estratti conto
• Movimenti Carte: Movimenti delle carte di credito aziendali

Statistiche Riepilogative

In alto sono sempre visibili 4 card con i totali del periodo filtrato:

• Entrate: Totale movimenti in entrata (incassi, bonifici ricevuti)
• Uscite: Totale movimenti in uscita (pagamenti, spese)
• Saldo: Differenza tra entrate e uscite
• Movimenti: Numero totale di registrazioni

Tab Prima Nota

Creare un Nuovo Movimento

Clicca su "Nuovo Movimento" per registrare manualmente un'operazione:

• Data: Data dell'operazione
• Tipo: Entrata o Uscita
• Descrizione: Causale del movimento
• Importo: Valore dell'operazione
• Aliquota IVA: Per calcolo automatico imponibile (opzionale)
• Categoria: Macro-categoria (Fornitori, Personale, Utenze, etc.)
• Sottocategoria: Dettaglio categoria
• Centro di Costo: Reparto di riferimento (Cucina, Bar, etc.)
• Documento Rif.: Numero fattura o documento collegato

Azioni sui Movimenti

Ogni riga della tabella ha 3 pulsanti azione:

• Modifica (icona matita): Apre il form di modifica del movimento
• Dividi (icona split): Divide il movimento in piu categorie (vedi sotto)
• Elimina (icona cestino): Cancella il movimento

Split Movimenti

La funzione Split permette di dividere un singolo movimento in piu parti con categorie diverse. Utile quando una fattura contiene spese di nature diverse.

Checkbox Piano Finanziario (PF)

La colonna PF indica se il movimento e incluso nel Piano Finanziario per l'export Excel. I movimenti collegati a fatture sono inclusi automaticamente (indicato con "Auto").

Filtri Disponibili

• Periodo: Data da/a
• Tipo: Solo entrate o solo uscite
• Centro di Costo: Filtra per reparto
• Sottocategoria: Filtra per categoria spesa

Tab Movimenti Bancari

Questa sezione gestisce l'import e la riconciliazione dei movimenti da estratto conto bancario.

Import Movimenti

Per importare movimenti bancari:

1. Vai su /banche e seleziona il conto
2. Carica il file Excel/CSV dell'estratto conto
3. I movimenti appariranno nel tab "Movimenti Bancari"

Stati dei Movimenti Bancari

• Da riconciliare (arancione): Movimento non ancora abbinato
• Riconciliato (verde): Abbinato a fattura/movimento prima nota
• Ignorato (grigio): Escluso dalla riconciliazione

Riconciliazione

Clicca su "Riconcilia" per abbinare un movimento bancario a:

• Una fattura esistente (pagamento fornitore)
• Un movimento di prima nota
• Una nuova registrazione

Tab Movimenti Carte

Visualizza i movimenti delle carte di credito aziendali importati dagli estratti conto carte.

• Stessi stati dei movimenti bancari
• Possibilita di riconciliare con fatture/spese
• Tracciamento utilizzo per carta

Export e Report

Dal menu "Esporta" in alto a destra:

• Prima Nota Excel: Export movimenti filtrati per mese
• Piano Finanziario: Report costi fissi/variabili mensili
• CashFlow: Report saldi e movimenti mensili
• Piano Completo: Entrambi i report in un unico file

Selezione Multipla

Usa le checkbox a sinistra per selezionare piu movimenti e:

• Eliminare in blocco
• Modificare categoria/centro di costo in massa
• Esportare solo i selezionati

Scorciatoie da Tastiera

Clicca sull'icona ? in basso a destra per vedere le scorciatoie disponibili:

• N: Nuovo movimento
• F: Apri filtri
• R: Ricarica dati
• Esc: Chiudi modal

11. Incassi

/incassi

Gestione entrate giornaliere:

• Tipi incasso: Contanti, POS, Aggregatori (Glovo, Deliveroo)
• Riconciliazione con movimenti bancari
• Calcolo commissioni automatico
• Versamenti bancari: Tracciamento depositi contanti
• Sincronizzazione automatica da Syrve POS

12. Chiusura Turno

/chiusura-turno

Chiusura cassa giornaliera:

• Selezione turno (pranzo/cena)
• Inserimento fondo cassa inizio/fine
• Dettaglio incassi per tipo pagamento
• Differenza cassa (eccedenze/ammanchi)
• Sincronizzazione automatica da Syrve
• Registrazione incasso in prima nota

13. Scadenzario

/scadenzario

Gestione scadenze pagamenti:

• Scadenze fatture fornitori
• Scadenze personalizzate
• Alert scadenze imminenti
• Stato pagamento (da pagare, parziale, pagato)

14. IVA e Fiscale

Registro IVA /registro-iva

Registro acquisti e vendite con export Excel/PDF.

Liquidazione IVA

Calcolo IVA mensile/trimestrale, confronto IVA a credito vs debito, storico liquidazioni.

15. Budget

/budget

Pianificazione e controllo budget:

• Budget per categoria spesa
• Budget per centro di costo
• Periodo (mensile/annuale)
• Alert superamento soglia
• Confronto budget vs consuntivo

16. Analytics e Forecast

Analytics /analytics

Analisi ABC: Classificazione prodotti/ingredienti per importanza, dashboard con grafici interattivi, trend temporali.

Forecast /forecast-bi

Previsioni finanziarie: proiezione cash flow, analisi trend, drill-down per categoria/centro costo.

17. Integrazione Syrve POS

Integrazione completa con il sistema POS Syrve per sincronizzazione automatica di vendite, turni e chiusure cassa.

Configurazione /syrve

Pagina principale per configurare la connessione al server Syrve:

• URL Server API: Indirizzo del server Syrve (es. https://api.syrve.com)
• Credenziali: Username e password per autenticazione API
• Test connessione: Verifica che le credenziali siano corrette
• Statistiche: Numero prodotti sincronizzati, mappati e vendite importate

Mapping Prodotti /syrve/mapping

Collegamento tra prodotti del POS Syrve e ricette/ingredienti del sistema:

• Sincronizza prodotti: Importa la lista prodotti dal POS
• Mapping manuale: Associa ogni prodotto Syrve a una ricetta
• Suggerimenti AI: Il sistema suggerisce automaticamente i mapping basandosi sui nomi
• Filtri: Visualizza solo prodotti mappati, non mappati o con suggerimenti

Vendite /syrve/vendite

Importazione e visualizzazione delle vendite dal POS:

• Sync vendite: Importa vendite per range di date
• Dettaglio vendite: Visualizza quantita vendute per prodotto
• Calcolo food cost: Confronta vendite con costo ricette mappate

Turni OLAP /syrve/turni

Analisi avanzata dei turni di cassa tramite API OLAP di Syrve:

• Riepilogo turni: Visualizza incassi per turno (pranzo/cena)
• Dettaglio pagamenti: Breakdown per tipo pagamento (contanti, carte, etc.)
• Analisi temporale: Trend incassi giornalieri/settimanali
• KPI operativi: Scontrino medio, coperti, performance oraria

Chiusure Cassa /chiusure-turno

Gestione delle chiusure turno con sincronizzazione automatica da Syrve:

• Lista chiusure: Tutte le chiusure con stato (pending, confermato, sincronizzato)
• Import automatico: Sincronizzazione programmata alle 17:00 (pranzo) e 01:00 (cena)
• Dettaglio incassi: Contanti, POS, buoni pasto, aggregatori
• Spese cassa: Registrazione uscite di cassa (prelievi, piccole spese)
• Differenza cassa: Calcolo automatico eccedenze/ammanchi
• Conferma manager: Workflow approvazione chiusure

Dashboard Analytics /dashboard-syrve

Dashboard completa con KPI e analytics dalle vendite Syrve:

• KPI principali: Fatturato, scontrino medio, numero transazioni
• Top prodotti: Classifica prodotti piu venduti
• Mix vendite: Analisi per categoria prodotto
• Trend temporali: Grafici andamento giornaliero/settimanale/mensile
• Confronto periodi: Comparazione con periodi precedenti

18. Funzionalita AI

/admin-ai

Il sistema utilizza l'intelligenza artificiale per:

19. Flusso Operativo Consigliato

Note e Supporto

• Logs: I log dell'applicazione sono in src/logs/
• Database: SQLite in src/instance/foodcost.db
• Backup: Consigliato backup giornaliero del database
• Export: La maggior parte delle viste supporta export Excel/PDF