# 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.
