# Panoramica

# 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](/docs/venue/seating) (`/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](/docs/getting-started/assistant).

## Ruoli in sintesi

| Ruolo | Vede | Può fare |
|-------|------|----------|
| Owner | Tutto nella sua azienda | Controllo completo: fatturazione, membri, account Stripe, eliminazione azienda |
| Admin | Risorse operative | Gestisce eventi, prenotazioni (incl. rimborsi), membri — non fatturazione né creazione/eliminazione azienda |
| Manager | Operatività quotidiana | Crea/modifica eventi, tipi evento, posti, orari, prenotazioni — no aree, no rimborsi, no gestione membri |
| Member | Proprio contesto | Vede, crea e modifica le proprie prenotazioni |
| Employee | Superfici di sala + portale | Comanda e kitchen board, segni di servizio sulle prenotazioni (seated/completed/no-show), radio voce, propri turni/timbrature/ferie — no gestione prenotazioni o soldi |

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

## Prossimi passi

- [Fai la prima prenotazione](/docs/getting-started/first-booking)
- Le guide per lo staff (*Crea un evento*, *Prezzi*, *Widget*, …) compaiono automaticamente nell'hub quando il tuo ruolo lo consente.


---
> Source: https://placeful-app.com/docs/getting-started/overview