Componenti della documentazione

Pagina di servizio per chi scrive la documentazione. I componenti vivono indocs-site/src/components e si importano nelle pagine .mdx conimport { Screenshot, LiveMap } from '~/components';. Quelli interattivi riusano il codice reale di web/shared, senza copie.

Screenshot

<Screenshot name="admin-map" alt="…" caption="…" />: mostra la variante chiara o scura secondo il tema scelto, si ingrandisce con un clic. I nomi sono inscreenshots.manifest.json.

/admin/e/…/mappa?date=2027-05-10

Mappa operativa del 10 maggio sui dati dimostrativi.

Le acquisizioni da smartphone hanno la cornice del telefono.

LiveMap

<LiveMap />: la mappa vera (BeachMap con il kit Coste360) sulla spiaggia dimostrativa.

Componente realeDati dimostrativi · Lido Demo · Spiaggia · 10/05/2027

Tutte · 124Libero · 93Prenotato in cassa · 2Da incassare · 29

Tocca o seleziona con la tastiera una postazione; trascina e usa i controlli per lo zoom.

LivePriceSimulator

<LivePriceSimulator pack="comfort" period="high" duration="week" />

Simulatore di prezzo

Componente reale

Calcolato dal motore prezzi reale (versione 1) sul listino dimostrativo, canale cassa.

Pacchetto

BaseComfortGazebo

Zona

Prima filaSeconda filaFile successive

Periodo

Bassa stagioneMedia stagioneAlta stagioneFerragosto

Durata

Mezza giornataGiornata3 giorniSettimana

Totale · 03/05/2027

25,00 €

di cui IVA: 4,51 €

Calcolo giorno per giorno

Giorno	Base		Totale
03/05/2027	25,00 €	Base: Listino rapido · row1 · Bassa stagione (set 2500)	25,00 €

StatusBadges

<StatusBadges /> oppure con descrizioni:

• Libero
• Prenotato online
• Prenotato in cassa
• Abbonato
• Abbonato assente oggi
• In attesa
• Da incassare
• Presente
• Bloccato
• Prelazione rinnovo
• Non disponibile

Libero

Prenotabile in cassa e online.

In attesa

Bloccata da un pagamento online in corso: si libera alla scadenza.

Da incassare

Occupata con un saldo ancora da incassare.

ApiOperation

<ApiOperation ids={['getPublicCalendar', 'createPublicBooking']} />

• GET/api/public/v1/{slug}/calendarDisponibilità sintetica per giorno di un mese (passo "Quando")Pubblica
• POST/api/public/v1/{slug}/bookingsCrea la prenotazione in stato held e la sessione di checkoutPubblica
• POST/webhooks/payments/{provider}/{establishmentId}Webhook del provider di pagamento (firma obbligatoria)Pubblica

Nomi degli screenshot

Nome	Vista	Descrizione
admin-login	desktop	Pagina di accesso al pannello del gestore.
admin-today	desktop	Vista "Oggi": arrivi, presenze, incassi da riscuotere del giorno.
admin-map	desktop	Mappa operativa del giorno con gli stati delle postazioni e la legenda.
admin-map-labels	desktop	Mappa operativa con le etichette "Entrambi": codice della postazione e cognome di chi la occupa.
admin-map-mobile	mobile	Mappa operativa su smartphone, per il giro in spiaggia.
admin-map-spot	desktop	Mappa operativa con il pannello di una postazione occupata aperto.
admin-planning	desktop	Planning: postazioni per riga e giorni in colonna.
admin-bookings	desktop	Elenco delle prenotazioni con filtri per stato, canale e date.
admin-booking-detail	desktop	Dettaglio di una prenotazione: righe, pagamenti, storico e azioni.
admin-booking-new	desktop	Pannello "Nuova prenotazione" con preventivo in tempo reale.
admin-customers	desktop	Anagrafica clienti con ricerca.
admin-customer-detail	desktop	Scheda cliente: contatti, consensi, prenotazioni e abbonamenti.
admin-passes	desktop	Abbonamenti stagionali e giorni rilasciati.
admin-renewals	desktop	Rinnovi: campagna con conto alla rovescia della prelazione e proposte agli abbonati (M5).
admin-waitlist	desktop	Lista d'attesa: coda in ordine di priorità con l'offerta in corso (M5).
admin-season-rollover	desktop	Cambio stagione: cosa copiare e anteprima della nuova stagione (M5).
admin-customer-credits	desktop	Scheda cliente, sezione crediti: disponibile, in scadenza e registro dei movimenti (M5).
admin-test-mode	desktop	Modalità prova: interruttore, link di anteprima della pagina pubblica ed eliminazione delle prenotazioni di prova (ADR 0019 A).
admin-imports	desktop	Importa dati: rapporto di validazione di un file CSV di clienti con una riga da correggere (ADR 0019 F).
admin-cash-registers	desktop	Casse dello stabilimento: cassa predefinita, stato della sessione e azioni (ADR 0019 D).
admin-map-selection	desktop	Mappa operativa con tre postazioni selezionate e la barra delle azioni di gruppo (ADR 0019 C).
admin-map-block	desktop	Blocco di due postazioni dalla mappa: periodo, fascia e motivo (ADR 0019 C).
admin-pass-price	desktop	Scheda di un abbonamento con la sezione Prezzo e il prezzo manuale (ADR 0019 E).
admin-notifications	desktop	Campanella delle notifiche del pannello aperta (ADR 0019 F).
admin-report-exports	desktop	Report con il menu Esporta elenchi in Excel o CSV (ADR 0019 F).
admin-cash	desktop	Cassa: sessione aperta, movimenti e totali per metodo.
admin-corrispettivi	desktop	Riepilogo dei corrispettivi giornalieri.
admin-daily-sale	desktop	Vendita rapida: dove (postazione o solo zona), formula, pack, extra, totale con IVA e pagamento.
admin-daily-sale-map	desktop	Mappa del giorno con il pannello "Vendi giornata" aperto su una postazione libera.
admin-ticket-print	desktop	Anteprima di stampa di un biglietto giornaliero (scontrino 80 mm).
admin-tickets	desktop	Ticket del giorno: riepilogo, elenco dei biglietti e corrispettivi per aliquota.
admin-assign-panel	desktop	Mappa del giorno con il pannello "Da assegnare" e un biglietto scelto.
admin-entry-types	desktop	Configurazione dei biglietti d'ingresso (Adulto, Ridotto, Bambino).
admin-entry-sale	desktop	Vendita rapida, scheda Ingressi: quantità per tipo, posti rimasti e totale.
admin-entry-gate-mobile	mobile	Varco sul telefono del personale: lettura del QR con la fotocamera o codice scritto a mano.
admin-pricing	desktop	Listino: regole di prezzo, prezzi fissi, promozioni e convenzioni.
admin-price-simulator	desktop	Simulatore di prezzo con il dettaglio del calcolo.
admin-price-matrix	desktop	Matrice dei prezzi per pacchetto e periodo.
admin-price-coverage	desktop	Copertura del listino: giorni senza prezzo evidenziati.
admin-policies	desktop	Regole di prenotazione, acconto e cancellazione.
admin-catalog	desktop	Catalogo: componenti, pacchetti ed extra.
admin-zones	desktop	Zone della spiaggia e modalità di vendita (posto, zona, quantità).
admin-pools	desktop	Pool a quantità (lettini, parcheggio, ingressi).
admin-seasons	desktop	Stagioni e periodi tariffari.
admin-closures	desktop	Giorni di chiusura.
admin-team	desktop	Utenti dello stabilimento e ruoli.
admin-establishment	desktop	Dati dello stabilimento, fuso orario e lingue.
admin-map-kit	desktop	Stabilimento, scheda Mappa: scelta del kit di illustrazioni (Moderno o Classico) con l'anteprima di ciascuno (ADR 0024).
admin-maps-list	desktop	Elenco delle mappe dello stabilimento.
admin-map-editor	desktop	Editor della mappa con il kit grafico Coste360.
admin-setup-wizard	desktop	Configurazione guidata del primo avvio.
admin-online-settings	desktop	Pagina pubblica: modalità, tema, termini e incorporamento.
admin-payment-settings	desktop	Pagamenti online: Stripe e verifica delle credenziali.
admin-email-settings	desktop	Email transazionali: mittente, modelli e invio di prova.
admin-reports	desktop	Report: scelta del periodo e indicatori del riepilogo (M5).
admin-api-keys	desktop	Chiavi API: elenco con permessi, ultimo uso e scadenza (M5).
admin-webhooks	desktop	Webhook: endpoint, eventi scelti, stato e ultima consegna (M5).
admin-devices	desktop	Dispositivi abbinati con utente, ultimo utilizzo e stato (M6).
admin-printers	desktop	Stampanti sull'edizione server: la stampa ESC/POS è spiegata (app desktop) e si stampa dal browser (ADR 0021).
admin-printers-desktop	desktop	Stampanti nell'app desktop: stampante di rete raggiungibile, instradamento e ultime stampe (dati simulati, ADR 0021).
public-when-mobile	mobile	Pagina pubblica, passo "Quando" su smartphone.
public-when-desktop	desktop	Pagina pubblica, passo "Quando" su desktop.
public-where-mobile	mobile	Passo "Dove": scelta del posto sulla mappa, della zona o della quantità.
public-where-desktop	desktop	Passo "Dove" su desktop.
public-what-mobile	mobile	Passo "Cosa": pacchetto ed extra con il prezzo aggiornato.
public-what-desktop	desktop	Passo "Cosa" su desktop.
public-who-mobile	mobile	Passo "Chi": dati del cliente, consensi e tempo di blocco.
public-who-desktop	desktop	Passo "Chi" su desktop.
public-confirmation-mobile	mobile	Conferma della prenotazione con codice, QR e aggiunta al calendario (.ics).
public-confirmation-desktop	desktop	Conferma della prenotazione su desktop.
public-manage-mobile	mobile	Area "Gestisci la prenotazione" aperta dal link magico: saldo, modifica, cancellazione.
public-manage-desktop	desktop	Area di gestione della prenotazione su desktop.
public-embed	desktop	Widget embed.js dentro la pagina del sito del lido (iframe).
public-embed-mobile	mobile	Widget embed.js su smartphone dentro il sito del lido.