Panoramica

Benvenuto in Placeful — piattaforma multi-tenant per gestire eventi, posti, fasce orarie e prenotazioni con pagamenti Stripe, widget di prenotazione embeddabile e accesso basato sui ruoli per i team aziendali.

Cosa puoi fare

• Le aziende sono il tenant. Ogni azienda possiede eventi, tipi evento, aree, posti, orari e prenotazioni. Gli utenti appartengono a una o più aziende con un ruolo: owner, admin, manager, member.
• Gli eventi hanno una data (eventualmente multi-giorno), una finestra di prenotazione opzionale e una capacità. Le prenotazioni si fanno sugli eventi — a meno che l'azienda giri in modello di prenotazione areas, dove i clienti prenotano un'area direttamente per una finestra oraria (un'azienda a eventi può anche consentire entrambi — vedi Prenotazione aree).
• Mappa del locale e tavoli — lo staff disegna le aree e posiziona i tavoli fisici su una pianta visuale (/venue/map); ogni prenotazione può essere fissata ai tavoli — anche su più tavoli — dalla mappa posti (/venue/seating), dall'editor prenotazione o dal planner.
• Chiusure — regole (intervalli di date, ricorrenze settimanali, fasce orarie) che bloccano locale, area o tavolo (/availability/calendar).
• Planner — griglia mensile su /admin/planner che dipinge chiusure, prenotazioni, eventi e spostamenti tavoli per giorno.
• Le prenotazioni riservano capacità (posti o slot orari) e attraversano una macchina a stati: Pending → Free / Paid / Added (gli stati confermati) → Cancelled, Failed, Expired, oppure la catena rimborsi RefundPending → Refunding → Refunded / RefundFailed. Un codice promo inviato parcheggia la prenotazione in PromoPending finché lo staff la approva o rifiuta.
• Il widget è un calendario di prenotazione embeddabile (iframe + snippet script) generato per azienda per siti esterni.
• Stripe gestisce checkout, account connessi per azienda (payout più fee applicativa della piattaforma), rimborsi e fatturazione degli abbonamenti ai pacchetti.
• Waitlist — sugli eventi con waitlist_enabled, i clienti a sold-out possono mettersi in coda e vengono promossi FIFO quando si libera un posto.
• Comande — menu con categorie, modificatori, portate e giacenze opzionali; conti live sulla comanda staff, un kitchen board con invio portate e ritmi di preparazione, auto-ordine QR per gli ospiti, scontrini stampabili e un cassetto cassa giornaliero con chiusura Z-report (/orders).
• Personale — dipendenti con organico, contratti, turni, attività, timbrature, ferie e riepiloghi buste paga; un portale self-service e stanze radio voce stile walkie-talkie per la sala.
• App membri — una PWA installabile su /m: prenotazioni di oggi, mappa posti, auto-ordine, kitchen board e notifiche push.
• Google Calendar — lo staff può replicare le prenotazioni confermate sul proprio calendario e vedere i conflitti con i blocchi occupati.
• Assistente AI — un assistente in-app (pulsante sparkle, oppure Ctrl+K → Chiedi all'assistente nella command palette) risponde a domande sui dati della tua azienda e su questa documentazione, propone modifiche da confermare e ti porta ai record — vedi Assistente AI.

Ruoli in sintesi

Gli sviluppatori (staff piattaforma con flag developer) bypassano tutti i controlli di ruolo.

Prossimi passi

• Fai la prima prenotazione
• Le guide per lo staff (Crea un evento, Prezzi, Widget, …) compaiono automaticamente nell'hub quando il tuo ruolo lo consente.