CassaEventiAI

Applicazione desktop WPF (net10.0-windows) per la gestione cassa eventi: vendita, stampa scontrini, storno/riattivazione, reportistica, configurazione reparti/articoli/operatori e backup.

Requisiti

• Windows 10/11
• .NET 10 SDK
• Stampante Windows installata (se si usa la stampa)

Build ed esecuzione

cd src
dotnet restore
dotnet build
dotnet run

Publish

dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true

Stack tecnico

• UI: WPF + MVVM (CommunityToolkit.Mvvm)
• Persistenza: SQLite (Microsoft.EntityFrameworkCore.Sqlite)
• DI: Microsoft.Extensions.DependencyInjection
• Export Excel: ClosedXML
• Sicurezza password: BCrypt.Net-Next
• Target framework: net10.0-windows

Struttura progetto

CassaEventiAI/
├── CassaEventiAI.sln
└── src/
    ├── App.xaml / App.xaml.cs
    ├── CassaEventiAI.csproj
    ├── Data/
    │   └── CassaDbContext.cs
    ├── Models/
    │   └── Models.cs
    ├── Services/
    │   ├── AuthService.cs
    │   ├── BackupService.cs
    │   ├── ConfigService.cs
    │   ├── EventService.cs
    │   ├── ProductService.cs
    │   ├── ReceiptService.cs
    │   ├── ReportService.cs
    │   ├── SaleService.cs
    │   └── UsbService.cs
    ├── Printing/
    │   └── PrintingService.cs
    ├── ViewModels/
    │   ├── BaseViewModel.cs
    │   ├── FrontOfficeViewModel.cs
    │   ├── BackOfficeViewModel.cs
    │   ├── ReportViewModel.cs
    │   ├── StartupViewModel.cs
    │   ├── LoginViewModel.cs
    │   ├── DepartmentsViewModel.cs
    │   ├── ProductsViewModel.cs
    │   └── OperatorsViewModel.cs
    ├── Views/
    │   ├── FrontOffice/MainWindow.xaml
    │   ├── BackOffice/BackOfficeWindow.xaml
    │   ├── Reports/ReportWindow.xaml
    │   └── Shared/
    │       ├── StartupWindow.xaml
    │       ├── LoginWindow.xaml
    │       ├── OrderSummaryWindow.xaml
    │       └── ReceiptPreviewWindow.xaml
    ├── Converters/Converters.cs
    └── Resources/Themes/LightTheme.xaml

Funzionalità funzionali

FrontOffice (cassa)

• Articoli raggruppati per reparto (layout multi-colonna).
• Evidenza stock residuo su articolo quando TrackStock=true.
• Carrello con aumento/riduzione quantità.
• Vincolo stock: se abilitato non è possibile vendere oltre disponibilità.
• Decremento stock in vendita e ripristino stock su storno.
• Sconto percentuale con range 0..100; se attivo mostra importo sconto sopra al totale.
• Metodi di pagamento multipli (layout 3 per riga), posizionati sotto al totale.
• Calcolo resto automatico per pagamenti cash.
• Popup riepilogo ordine dopo il checkout (se ShowOrderSummary=true): articoli, totale, pagamento con pulsanti Ristampa e Chiudi.
• Anteprima scontrino accessibile tramite pulsante 🔍 nel footer (sempre visibile).
• Ristampa ultimo scontrino.
• Storno con ricerca scontrini emessi e riattivazione scontrini stornati.
• Header con nome utente connesso e orologio live.
• Footer metriche sessione (scontrini, totale incassato, ultimo ordine) + toolbar operativa.
• Pulsante Settings visibile solo agli admin.

BackOffice (Settings)

Tab Reparti:

• Attivazione/disattivazione, ordine, colore reparto.
• Nome reparto: max 15 caratteri.

Tab Articoli:

• Prezzo, reparto, stato attivo, stock (TrackStock, StockQty).
• Nome articolo: max 18 caratteri.

Tab Pagamenti: gestione metodi di pagamento.

Tab Configurazione:

• ShowOrderSummary: mostra popup riepilogo dopo checkout.
• ShowTotalInFooter: mostra totale incassato nel footer per i cashier.
• KioskMode: modalità schermo intero.

Tab Stampa:

• Selezione stampante Windows installata.
• PrinterEnabled: abilita/disabilita stampa.
• PrintFiscalReceipt: inibisce la stampa dello scontrino fiscale.
• PrintOperator: mostra/nasconde nome operatore sullo scontrino.
• Header/footer scontrino, extra footer legale (testo piccolo, solo primo scontrino).
• ExtraFooterEnabled / ExtraFooterOnlyFirst.
• PrintPrices, PrintDepartmentSubtotals.

Tab Operatori: username, display name, ruolo (admin/cashier), stato attivo.

Tab Evento/Backup: gestione evento attivo, backup manuale/automatico.

Reportistica (finestra dedicata)

• Selezione periodo Da / A.
• Tab Venduto:
  • scontrini emessi, scontrini annullati, totale venduto, totale sconti applicati
  • griglia raggruppata per data + prodotto + prezzo (colonne: Giorno, Prodotto, Prezzo, Quantità, Importo totale)
• Tab Ordini emessi:
  • elenco ordini con colonna Sconto (vuota se nessuno sconto applicato)
  • dettaglio ordine selezionato con anteprima scontrino
  • layout colonne 60% elenco / 40% dettaglio
• Export Excel: include riga "Sconti applicati" nel riepilogo e stessa struttura colonne della griglia.

Stampa scontrini (tecnica + formato)

• Stampa e anteprima generate dalla stessa pipeline (ReceiptService + PrintingService).
• Scontrino testuale con separazione sezioni tramite carattere \x1E (taglio carta GDI).
• Sezione fiscale (inibibile con PrintFiscalReceipt=false):
  • intestazione da configurazione
  • numero ordine, operatore (opzionale), data/ora
  • righe prodotto con quantità/prezzo/totale
  • sconto percentuale e importo
  • totale, pagato e resto (per cash)
  • piè di pagina + extra footer legale in font piccolo
• Sezioni reparto (ritiro): create solo per reparti con PrintSeparateReceipt=true.
• Quantità senza decimali, importi con €.
• Font: Lucida Console — 11pt base, 14pt bold (intestazioni reparto), 8pt small (extra footer).

Ruoli, autorizzazioni e visibilità

Funzionalità	Admin	Cashier
Accesso Settings/BackOffice	Sì	No (pulsante nascosto)
Accesso Reportistica	Sì	No (pulsante nascosto)
Totali footer	Sempre visibili	Visibili solo se ShowTotalInFooter=true
Operazioni cassa (vendita/stampa/storno)	Sì	Sì

Sicurezza

• Login operatori con password hashate tramite BCrypt.
• Supporto ruoli applicativi (admin, cashier).
• Blocco eliminazione dell’utente correntemente loggato.
• Vincolo almeno un amministratore attivo.
• Supporto flusso cambio password obbligatorio (MustChangePassword).
• Validazioni input numerici in UI (sconto, contanti, ecc.).
• Gestione errori con messaggistica utente nei flussi critici.

Persistenza dati

Configurazioni JSON

Posizione: %APPDATA%\CassaEventiAI\Data\

File	Contenuto
app_settings.json	Impostazioni applicative (evento attivo, stampante, backup, footer totals, ecc.)
departments.json	Reparti (PrintSeparateReceipt, colore, ordine, attivo)
products.json	Articoli (prezzo, reparto, stock)
payment_methods.json	Metodi di pagamento
operators.json	Operatori e ruoli
receipt_config.json	Configurazione intestazione/piè di pagina e opzioni scontrino

Database SQLite evento

Posizione: %APPDATA%\CassaEventiAI\Events\<nome_evento>.db

Archivi eventi: %APPDATA%\CassaEventiAI\Archive\

Tabelle principali:

• Sales
• SaleItems
• OperatorShifts

Flusso operativo sintetico

1. Selezione/creazione evento.
2. Login operatore.
3. Apertura/aggancio turno operatore.
4. Vendita con stampa/anteprima.
5. Eventuale storno o riattivazione.
6. Chiusura turno con riepilogo.
7. Reportistica e/o export Excel.
8. Backup automatici o manuali.

Dipendenze NuGet (principali)

Queste sono le dipendenze principali usate dal progetto al momento:

Package	Versione	Uso
Microsoft.EntityFrameworkCore.Sqlite	10.0.9	Persistenza (SQLite)
Microsoft.EntityFrameworkCore.Design	10.0.9	Tooling EF Core (design-time)
CommunityToolkit.Mvvm	8.4.2	MVVM helpers (INotify, RelayCommand, ecc.)
Microsoft.Extensions.DependencyInjection	10.0.9	Dependency Injection / container
Microsoft.Extensions.Logging	10.0.9	Logging
ClosedXML	0.105.0	Export Excel (ReportService)
BCrypt.Net-Next	4.2.1	Hash password (AuthService)

Note operative

• Se CassaEventiAI.exe è aperto, la build può fallire per file lock: chiudere il processo prima di compilare.
• Le funzionalità di reportistica e settings sono intenzionalmente riservate agli admin.