Piattaforma cloud
Web App Gestionale (SaaS)
La piattaforma web rappresenta l’evoluzione cloud dell’ecosistema Nyxia Camper: stesse regole di business e stesso modello dati concettuale del plugin WordPress, orchestrati in un’area riservata dedicata a staff e amministratori. La sincronizzazione con il sito pubblico è progettata in modo che prenotazioni, disponibilità e stati pagamento restino allineati tra vetrina e gestionale.
Architettura logica
| Layer | Ruolo |
|---|---|
| Sito pubblico (WordPress + plugin) | Ricerca date, disponibilità in tempo reale, richiesta prenotazione, redirect pagamento hosted. |
| Web App gestionale (SaaS) | Configurazione, operatività, reportistica, team — dopo autenticazione. |
| Integrazioni (API / webhook / gateway) | Collegamenti verso pagamenti, portali istituzionali, contabilità e automazioni — con chiavi e permessi dedicati. |
Onboarding e accesso
Percorsi previsti per portare una struttura da zero a operativa, con separazione netta tra contesto tenant (la tua organizzazione) e utenti (persone che accedono).
- Provisioning: creazione account struttura, verifica email/dominio ove previsto, assegnazione del primo amministratore.
- Wizard iniziale: definizione area sosta, unità ricettive (piazzole), stagionalità di base e collegamento al sito WordPress per la sync.
- Autenticazione: credenziali con policy password; supporto a secondo fattore (2FA) per ruoli sensibili; recupero account sicuro.
- SSO aziendale (roadmap / piani enterprise): accesso tramite provider IdP comuni (es. Google Workspace, Microsoft Entra) per team numerosi.
Multi-struttura, team e matrice permessi (RBAC)
Per gestori con più sedi o società di servizio: più aree sosta sotto un unico account, con permessi per sede o ruolo.
| Ruolo tipico | Esempi di permesso |
|---|---|
| Amministratore | Piani e fatturazione SaaS, utenti, integrazioni, tutte le sedi, export sensibili. |
| Operatore reception | Calendario, check-in/out, incassi cassa, note operative; niente impostazioni globali né billing. |
| Solo lettura / contabilità | Report, export CSV/PDF, consultazione log pagamenti; niente modifica prenotazioni salvo eccezioni configurate. |
Configurazione: listini, mappe, blackout e canali
Il gestionale è il punto dove regole e inventario diventano comportamento uniforme tra canali.
- Listini e stagionalità: prezzi per notte, per persona, misti; minimi/massimi soggiorno; weekend; extra (animali, corrente, ombreggiatura).
- Blackout ed eventi: chiusure per manutenzione, feste, manifestazioni — allineate al concetto di blackout già gestibile lato plugin WordPress.
- Mappa piazzole (anche solo organizzativa): tipologie, servizi per unità, assegnazione visiva o elenco strutturato per ridurre errori in accoglienza.
- Canali di prenotazione: sito web (plugin), telefono, walk-in — tutti convergono sullo stesso calendario e motore prezzi per evitare doppie vendite.
Dashboard analitica
Visualizzazione centralizzata di KPI operativi e finanziari:
- Grafici occupazione piazzole — trend per periodo, confronto stagionale, picchi e giorni critici.
- Andamento incassi — aggregazioni mensili e annuali, confronto con periodi precedenti, breakdown per canale di pagamento ove applicabile.
- Filtri per intervallo date, area sosta e tipologia servizio (es. piazzola con corrente).
Gestione prenotazioni
- Calendario operativo con spostamento soggiorni in drag-and-drop, validazione anti-sovrapposizione e rispetto dei vincoli di prezzo.
- Inserimento manuale per ospiti senza prenotazione online: stesso motore di disponibilità e prezzo del flusso pubblico.
- Stati (richiesta, confermata, in attesa pagamento, chiusa, annullata) allineati al ciclo di vita del backend.
Check-in, check-out e operatività quotidiana
- Arrivo e partenza: registrazione effettiva del soggiorno, saldo in cassa o via link, allegati utili (regolamento firmato dove previsto).
- Note operative interne: annotazioni visibili solo allo staff (non pubblicate sul sito).
- Task e manutenzione leggera: attività collegate a piazzola (es. pulizia post-checkout, intervento tecnico) con stato completamento.
CRM ospiti e comunicazioni multicanale
- Profilo ospite: storico soggiorni, preferenze, contatti — utile per fidelizzazione e riconoscimento alla reception.
- Email: template transazionali (conferme, promemoria, link pagamento); allineamento a SMTP/configurazioni come lato plugin dove applicabile.
- SMS / WhatsApp Business (roadmap / integrazioni): messaggi critici (promemoria arrivo, OTP opzionale) con log di consegna e opt-out.
- Multilingua: contenuti ospite in lingua selezionata ove supportato dai template.
Pagamenti e incassi
- Registro incassi: importi, acconti, saldi, collegamento agli ordini gateway.
- Log “chi ha pagato”: storico per riconciliazione cassa e amministrazione.
- Gateway esterni (Stripe, SumUp, PayPal, ecc.): link di pagamento hosted — nessun PAN sul proprio server, coerente con il plugin WordPress.
- Ponte verso contabilità: export strutturati (CSV, API) per import in gestionale contabile o intermediari; dettaglio dipende da integrazioni di piano.
Finanza, GDPR e adempimenti
- Corrispettivi e fatturazione: dove previsto da processo, supporto a documentazione richiesta dalla struttura (es. export dati per fatturazione elettronica tramite software terzo — Nyxia non sostituisce il commercialista).
- GDPR: base giuridica del trattamento, tempi di conservazione, diritto di accesso/rettifica/cancellazione, export dati ospite su richiesta.
- Registro trattamenti e DPA: informativa per il titolare della struttura; elenco subprocessors aggiornato nella documentazione legale del servizio.
Logistica camper e perimetro fisico
Stato di ogni piazzola/unità in tempo reale:
| Stato | Uso tipico |
|---|---|
| Libera | Prenotabile e visibile come disponibile sul sito. |
| Occupata | Legata a soggiorno attivo o blocco operativo. |
| Manutenzione | Esclusa dalla vendita fino a riapertura manuale. |
Integrazioni hardware (opzionali / roadmap)
Sbarre automatiche, tornelli, lettori tessere o badge: integrazione tramite fornitori terzi e API dove tecnicamente e contrattualmente fattibile; non parte del nucleo minimo del gestionale.
Area account, piani ed export
- Piano abbonamento: upgrade/downgrade con limiti su piazzole, utenti, storico dati e funzioni avanzate.
- Export: PDF e CSV per riepiloghi fiscali, presenze, statistiche — con permessi per ruolo.
- Gestione team: inviti utente, disattivazione, assegnazione ruoli e sedi.
Integrazioni tecniche: API, webhook e audit
- API e webhook: eventi (nuova prenotazione, pagamento completato, cambio stato piazzola) verso sistemi esterni; autenticazione con chiavi rotabili.
- Audit log: chi ha modificato prenotazioni critiche, listini, integrazioni — con timestamp e identità utente, per contestazioni e controlli interni.
- Rate limiting: protezione degli endpoint pubblici e delle chiavi API da abuso.
Abbonamento SaaS, fatturazione Nyxia e SLA
| Tema | Contenuto tipico |
|---|---|
| Fatturazione del servizio | Abbonamento periodico verso la struttura (rinnovi, IVA, metodo di pagamento) secondo condizioni contrattuali pubblicate. |
| SLA e supporto | Livelli di servizio e tempi di risposta possono variare per piano (es. business vs enterprise); dettaglio nei termini di servizio. |
| Changelog | Registro release consultabile per allineare processi interni alle novità prodotto (vedi Riferimento). |
Infrastruttura, backup e ambiente client
- Backup e continuità: policy di backup, obiettivi di ripristino (RTO/RPO) comunicati nei documenti legali/operativi del servizio.
- Residenza dati: preferibilmente UE per dati anagrafici e operativi; dettaglio per regione e subprocessors in documentazione privacy.
- Browser: ultimi versioni di browser evergreen consigliate; funzionalità critiche potrebbero richiedere TLS moderno e cookie di sessione abilitati.
- Mobile: interfaccia responsive; eventuale PWA o app nativa come evoluzione — l’offline completo è raramente garantito per natura cloud.
Funzionalità avanzate (roadmap / integrazioni Italia)
Estensioni verso adempimenti tipici delle strutture ricettive italiane; rollout e piani tariffari possono variare.
Tassa di soggiorno automatizzata
Calcolo in base a comune, tipologia ospite e pernottamenti, con export per versamenti e controlli; parametri allineabili alle delibere regionali.
Schedine alloggiati (Alloggiati Web / Questura)
Generazione e invio schedine alloggiati secondo specifiche del portale, validazione campi obbligatori e tracciamento invii per audit.
Email di check-in automatiche
Invio programmato agli ospiti (link modulo, orari reception, documenti utili) per ridurre carico in accoglienza.
Customer care
Supporto integrato dal footer dell’area riservata: ticket o richieste contestuali alla schermata (es. allegare ID prenotazione) per tempi di risposta più rapidi.
Glossario, FAQ, troubleshooting e requisiti WordPress
Glossario
| Termine | Significato |
|---|---|
| Tenant | Organizzazione (struttura o gruppo) isolata nel SaaS. |
| Unità / piazzola | Risorsa prenotabile elementare; può avere servizi e stato logistici. |
| Soggiorno | Periodo di occupazione legato a ospiti e prenotazione; genera incasso e presenze. |
| Sync | Allineamento dati tra gestionale cloud e plugin sul sito WordPress. |
| Gateway hosted | Pagamento su pagina del provider (nessun dato carta sul tuo server). |
FAQ
- Il gestionale sostituisce il plugin WordPress?
- No: il plugin resta la vetrina sul sito; il cloud amplia configurazione e operatività. La coerenza è garantita dalla sincronizzazione.
- Dove finiscono i dati dei miei ospiti?
- In ambienti gestiti dal servizio SaaS e, per quanto esposto in vetrina, nei flussi del sito secondo privacy policy della struttura e del fornitore.
- Posso usare solo il gestionale senza sito?
- Operativamente sì per walk-in e canali interni; la vetrina online richiede un front (es. WordPress + plugin) se vuoi prenotazioni dal web.
Troubleshooting rapido
| Sintomo | Cosa verificare |
|---|---|
| Disponibilità sul sito non aggiornata | Cache plugin/CDN, job di sync, modifiche recenti in gestionale non ancora propagate; vedi Sincronizzazione. |
| Pagamento riuscito ma prenotazione in attesa | Webhook gateway, log ordini, differenze fuso orario; verificare ID transazione nel registro incassi. |
| Email non ricevute dall’ospite | SPF/DKIM del dominio mittente, spam, template disattivati; log invii lato gestionale. |
Requisiti lato WordPress (sync)
- Plugin Nyxia Camper Booking installato e aggiornato a versione compatibile.
- Credenziali o token di collegamento configurati nel gestionale e nel plugin (come da guida installazione).
- REST API WordPress raggiungibile e non bloccata da firewall o plugin di sicurezza senza eccezioni.
Dettaglio endpoint e permessi: documentazione plugin WordPress.
Changelog
Le novità di prodotto sono pubblicate in un registro versioni (release notes) fornito dal canale ufficiale (sito Nyxia, area clienti o email prodotto). Usa il changelog per pianificare formazione interna e test di regressione sulle integrazioni.
Sincronizzazione con il plugin WordPress
Il modello dati è unificato: disponibilità, prenotazioni e stati visibili online riflettono le regole gestite nel cloud.
- Meccanismo: aggiornamenti periodici o event-driven (a seconda implementazione) tra API del gestionale e REST del plugin; latenza nominale dipende da carico e cache.
- Conflitti: in caso di modifiche quasi simultanee su sito e gestionale, prevale una policy esplicita (es. ultima modifica validata, o priorità gestionale per stati operativi) — da confermare nella documentazione tecnica di release.
- Propagazione: manutenzione piazzola o spostamento soggiorno in gestionale si riflettono in vetrina dopo elaborazione e invalidazione cache dove applicabile.
Documentazione Nyxia Camper — Web App Gestionale (SaaS).