zentral/docs/APPLICATION_OVERVIEW.md

Apollinare Catering & Banqueting - Application Overview

Descrizione Applicazione Attuale

Cos'è Apollinare

Apollinare Catering & Banqueting Management Software è un gestionale completo per aziende di catering e banqueting che gestisce l'intero ciclo di vita di un evento, dalla prima richiesta del cliente fino all'esecuzione finale.

L'applicazione è attualmente in uso presso Apollinare Catering (Italia) ed è stata sviluppata su piattaforma Oracle APEX 21.1.0.

Funzionalità Principali

1. Gestione Eventi

Il cuore dell'applicazione è la gestione degli eventi di catering:

• Creazione Evento: Wizard guidato per la creazione di nuovi eventi
• Dati Evento: Data, orario cerimonia, orario evento, location, cliente
• Tipologie: Matrimoni, battesimi, comunioni, cresime, eventi aziendali, feste private
• Tipo Pasto: Pranzo, cena, pranzo buffet, cena buffet

2. Workflow Stati Evento

L'evento attraversa diverse fasi:

PREVENTIVO (100)     → Cliente interessato, preventivo in preparazione
    ↓
SCHEDA (200)         → Degustazione effettuata, scheda evento in preparazione
    ↓
CONFERMATA (300)     → Prima caparra ricevuta
    ↓
QUASI CONFERMATO (350) → In attesa conferma definitiva
    ↓
CONFERMATO (400)     → Evento confermato, in esecuzione
    ↓
SUPERATO (900)       → Evento concluso o annullato

3. Gestione Ospiti

Sistema sofisticato per la gestione degli ospiti:

• Tipi Ospiti: Adulti, bambini, staff, fornitori esterni
• Conteggi Separati: Seduti vs buffet, adulti vs bambini
• Coefficienti: Ogni tipo ospite ha coefficienti per il calcolo quantità

4. Lista Prelievo (Pick List)

Gestione automatizzata del materiale necessario:

• Articoli: Catalogo completo con immagini, quantità standard, coefficienti
• Categorie: Posate, piatti, bicchieri, tovagliato, decorazioni, attrezzature cucina
• Calcolo Automatico: Le quantità vengono calcolate automaticamente in base a:
  • Numero ospiti per tipo
  • Coefficienti categoria (A=Adulti, S=Seduti, B=Buffet)
  • Quantità standard articolo
• Disponibilità: Verifica impegni articoli su altri eventi nella stessa data

5. Gestione Risorse (Staff)

Pianificazione del personale:

• Tipi Risorsa: Camerieri, cuochi, barman, responsabili sala
• Assegnazione: Assegnazione risorse per evento
• Report: Riepilogo impegni risorse per data

6. Sistema Acconti e Pagamenti

Gestione finanziaria completa:

• Caparre Automatiche: Sistema 30% - 50% - 20%
• Tracking Pagamenti: Monitoraggio stato pagamenti
• Solleciti: Identificazione eventi con pagamenti in scadenza (65 giorni)
• Email Automatiche: Notifiche automatiche per pagamenti

7. Reporting

Sistema di reportistica integrato:

• Scheda Evento: PDF completo per cliente
• Preventivo: Documento commerciale
• Riepilogo Cucina: Per lo staff di cucina
• Riepilogo Allestimenti: Per team setup
• Griglia Eventi: Vista calendario operativa
• Report Costi: Analisi costi per evento/categoria

8. Calendario

Vista calendario interattiva:

• Visualizzazione: Eventi per giorno/settimana/mese
• Colori Stati: Codifica colore per stato evento
• Limiti: Controllo numero massimo eventi per data
• Conflitti: Verifica location già impegnate

9. Gestione Degustazioni

Per eventi come matrimoni:

• Pianificazione: Data e dettagli degustazione
• Tracking: Stato degustazione
• Note: Preferenze e allergie

10. Template Eventi

Sistema di template per velocizzare la creazione:

• Template Predefiniti: Configurazioni standard per tipologie evento
• Duplicazione: Copia evento esistente come base
• Versionamento: Sistema di versioni per tracciare modifiche

---

Proposta SaaS: CaterPro

Vision

Trasformare Apollinare in CaterPro, una piattaforma SaaS multi-tenant per la gestione di aziende di catering e banqueting, mantenendo le funzionalità core ma aggiungendo caratteristiche enterprise.

Target Market

1. Piccole Aziende di Catering (1-10 dipendenti)

   • Piano Basic
   • Gestione eventi semplificata
   • Fino a 50 eventi/mese

2. Medie Aziende di Catering (10-50 dipendenti)

   • Piano Professional
   • Multi-location
   • Fino a 200 eventi/mese

3. Grandi Aziende / Catene (50+ dipendenti)

   • Piano Enterprise
   • Multi-brand, multi-country
   • Eventi illimitati

Architettura SaaS

┌─────────────────────────────────────────────────────────────────┐
│                        CaterPro Cloud                            │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │   Tenant A  │  │   Tenant B  │  │   Tenant C  │  ...        │
│  │  (Catering  │  │  (Wedding   │  │  (Corporate │             │
│  │   Roma)     │  │   Planner)  │  │   Events)   │             │
│  └─────────────┘  └─────────────┘  └─────────────┘             │
├─────────────────────────────────────────────────────────────────┤
│                      Shared Services                             │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐          │
│  │ Auth/IAM │ │ Billing  │ │Analytics │ │   API    │          │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘          │
├─────────────────────────────────────────────────────────────────┤
│                      Infrastructure                              │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐          │
│  │  .NET 8  │ │  React   │ │PostgreSQL│ │  Azure   │          │
│  │   API    │ │   SPA    │ │ /Oracle  │ │  Cloud   │          │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘          │
└─────────────────────────────────────────────────────────────────┘

Funzionalità SaaS Aggiuntive

Multi-Tenancy

• Isolamento Dati: Ogni cliente ha i propri dati completamente isolati
• Customizzazione: Logo, colori, branding personalizzabile
• Subdomain: cliente.caterpro.com

Gestione Utenti Avanzata

• Ruoli Predefiniti: Admin, Manager, Operatore, Cucina, Solo Lettura
• Ruoli Custom: Creazione ruoli personalizzati
• SSO: Integrazione Azure AD, Google Workspace
• 2FA: Autenticazione a due fattori

Integrazioni

• Calendario: Google Calendar, Outlook, Apple Calendar
• Pagamenti: Stripe, PayPal, bonifici SEPA
• Contabilità: Export per Fatture in Cloud, QuickBooks, Xero
• CRM: Salesforce, HubSpot
• E-commerce: Preventivi online, pagamenti online

Mobile App

• App iOS/Android: Per staff in mobilità
• Check-in Ospiti: QR code per eventi
• Inventario Mobile: Scansione barcode articoli
• Foto Evento: Upload diretto da app

Analytics & BI

• Dashboard Real-time: KPI principali
• Report Avanzati: Analisi trend, stagionalità
• Forecasting: Previsioni ricavi
• Export: Excel, PDF, API

Automazioni

• Email Marketing: Campagne automatiche
• Reminder: Notifiche scadenze, follow-up
• Workflow: Automazione processi custom
• Webhooks: Integrazione con sistemi esterni

Pricing Model

Basic - €49/mese

• 1 utente admin + 2 operatori
• 50 eventi/mese
• 500 articoli catalogo
• Report base
• Email support

Professional - €149/mese

• 5 utenti inclusi (+€15/utente aggiuntivo)
• 200 eventi/mese
• Articoli illimitati
• Multi-location (fino a 3)
• Report avanzati
• Integrazioni base
• Chat support

Enterprise - €399/mese

• Utenti illimitati
• Eventi illimitati
• Location illimitate
• API access
• Integrazioni premium
• White-label option
• SLA garantito
• Account manager dedicato

Add-ons

• Mobile App: +€29/mese
• E-commerce Module: +€49/mese
• Advanced Analytics: +€39/mese
• Custom Integrations: Su richiesta

Stack Tecnologico Proposto

Backend (.NET 8)

├── CaterPro.API                 # Web API REST
├── CaterPro.Core                # Domain models, interfaces
├── CaterPro.Application         # Business logic, CQRS
├── CaterPro.Infrastructure      # Data access, external services
├── CaterPro.Identity            # Authentication/Authorization
└── CaterPro.Workers             # Background jobs

Frontend (React TypeScript)

├── src/
│   ├── components/              # Reusable UI components
│   ├── features/                # Feature-based modules
│   │   ├── events/              # Event management
│   │   ├── inventory/           # Article/inventory
│   │   ├── calendar/            # Calendar views
│   │   ├── reports/             # Reporting
│   │   └── settings/            # Configuration
│   ├── hooks/                   # Custom React hooks
│   ├── services/                # API services
│   ├── store/                   # Redux/Zustand state
│   └── utils/                   # Utilities

Database

• Primary: PostgreSQL (per SaaS cost-efficiency)
• Alternative: Oracle (per clienti enterprise on-premise)
• Cache: Redis
• Search: Elasticsearch (per ricerca articoli/eventi)

Infrastructure

• Cloud: Azure / AWS
• Container: Docker + Kubernetes
• CI/CD: GitHub Actions / Azure DevOps
• Monitoring: Application Insights / DataDog

Roadmap Migrazione

Fase 1: Core Migration (3-4 mesi)

• Setup architettura .NET 8
• Migrazione modelli dati
• API REST per entità principali
• Frontend React base
• Autenticazione JWT

Fase 2: Feature Parity (2-3 mesi)

• Gestione eventi completa
• Sistema calcolo quantità
• Workflow stati
• Report PDF
• Calendario

Fase 3: SaaS Features (2-3 mesi)

• Multi-tenancy
• Billing integration
• User management avanzato
• Customization engine

Fase 4: Advanced Features (3-4 mesi)

• Mobile app
• Integrazioni terze parti
• Analytics avanzati
• E-commerce module

Vantaggi Competitivi

1. Esperienza Reale: Basato su software in produzione da anni
2. Specifico per Settore: Non un gestionale generico adattato
3. Calcolo Automatico: Algoritmo quantità unico nel settore
4. Workflow Collaudato: Processo testato su centinaia di eventi
5. Localizzazione: Già disponibile in italiano, facilmente estendibile

Competitor Analysis

Feature	CaterPro	Caterease	Total Party Planner	Better Cater
Gestione Eventi	✅	✅	✅	✅
Calcolo Auto Quantità	✅	❌	❌	Parziale
Multi-tenant	✅	❌	❌	✅
Mobile App	✅	✅	❌	✅
Italiano	✅	❌	❌	❌
API Pubbliche	✅	Parziale	❌	✅
Prezzo Entry	€49	$75	$50	$99

---

Conclusioni

L'applicazione Apollinare rappresenta un'eccellente base per lo sviluppo di una soluzione SaaS nel settore catering. Le funzionalità core sono mature e testate, la business logic è ben documentata, e l'architettura può essere modernizzata mantenendo la compatibilità con i processi esistenti.

La migrazione a .NET + React TypeScript permetterà:

• Scalabilità orizzontale per SaaS
• Developer experience moderna
• Ecosystem di librerie più ampio
• Deployment cloud-native
• Costi operativi ridotti

Il mercato italiano del catering è frammentato e sottosevito da soluzioni software moderne, rappresentando un'opportunità significativa per un prodotto SaaS verticale ben eseguito.