extracted objects

2025-12-17 13:02:12 +01:00
commit 7dd4ea08e1
195 changed files with 70591 additions and 0 deletions
--- a/docs/APPLICATION_OVERVIEW.md
+++ b/docs/APPLICATION_OVERVIEW.md
@@ -0,0 +1,336 @@
+# 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.