Événements, lieux et plans de salle

Ce que contient un événement et ses types de billets, comment un organisateur en crée, publie et annule un, les lieux sur la carte, les plans de salle avec brouillons et versions publiées, et comment une réservation temporaire garde des places pour un acheteur.

Pour le pack Full Stack

Ce que contient un événement

Partie	Valeurs
Textes, en anglais et en arabe	Titre (160 caractères), résumé (500) et description (5000). Le titre et la description en anglais sont nécessaires pour publier.
Adresse	Un slug construit à partir du titre anglais quand aucun n'est donné, rendu unique par un numéro.
Catégorie	`workshop`, `talk` ou `festival` dans les données d'exemple
Lieu et entrée	Un lieu, et des places `reserved` (places du plan publié du lieu) ou une entrée `general` (une quantité, sans numéros de place)
Planning	Début et fin dans le fuseau horaire propre à l'événement, et un programme d'au plus 24 éléments (une heure, un titre et un détail optionnel)
Visibilité	`public` (listé dans le catalogue et la recherche) ou `unlisted` (vendu par son seul lien)
Couleur	`pink`, `yellow`, `teal` ou `blue`. Un événement n'a pas de photo : son titre, sa date et sa couleur sont dessinés comme un billet.
Types de billets	De 1 à 10, chacun avec un nom, un prix (0 pour gratuit), une capacité, le maximum par commande (1 à 8) et un statut de vente : en vente, en pause ou fermé

Les prix sont conservés en unités mineures de la devise de l'espace de travail (2000 vaut 20,00 $), et la colonne de prix de l'éditeur nomme cette devise : celle dans laquelle les types de billets de l'événement ont été tarifés, ou pour un nouvel événement celle de l'espace de travail. Les frais de réservation, 3 % dans les données d'exemple, sont ajoutés par billet au paiement et payés par le participant ; un billet gratuit n'en porte aucun.

Les statuts et ce que montre le site

Statut	Sur le site
Brouillon	Masqué. Chaque nouvel événement commence ici.
Publié	Listé (s'il est public), cherchable, dans le sitemap, et en vente.
Complet	Listé, avec chaque type de billet affiché comme complet. La page reste ouverte et l'événement peut encore être enregistré.
Annulée	Retiré du catalogue. Sa page indique qu'il a été annulé, et ses billets n'ouvrent plus l'entrée.
Archivé	Masqué, dans l'onglet Terminés du tableau de bord, et retiré des listes d'événements enregistrés des participants.

Des données d'exemple neuves comptent 36 événements chez quatre organisateurs : 29 publiés, 2 complets, 1 annulé et 4 brouillons. Le site liste les 22 en vente ou en cours, dont 3 en cours, et 9 sont déjà terminés.

Publier, annuler et les autres actions

Action	Rôle
Publier	Exige le titre et la description en anglais, au moins un type de billet avec une capacité, un début dans le futur et, pour des places réservées, un plan publié au lieu. Sinon l'éditeur liste ce qui manque.
Dépublier	Retour en brouillon : les nouvelles ventes s'arrêtent, les réservations en cours sont libérées, et les billets déjà vendus restent valables.
Annuler l'événement	Les ventes et l'entrée s'arrêtent aussitôt, les réservations sont libérées, et chaque commande payée reçoit un e-mail. Aucun argent ne bouge : remboursez chaque commande depuis sa page. Confirmé en saisissant le slug de l'événement.
Dupliquer	Un nouveau brouillon nommé « (copy) » avec les mêmes types de billets et aucune vente.
Archiver	Pour un brouillon, un événement annulé ou terminé. Les commandes et les billets sont conservés.

Les commandes et les billets ne sont jamais supprimés dès qu'il y a eu un mouvement d'argent. Chaque action est inscrite dans le journal d'audit.

La page des événements et l'éditeur

Les onglets Tous, Publiés, Brouillons et Terminés, une recherche, et des filtres par catégorie, statut et dates (30 prochains jours, 90 prochains jours, cette année, événements passés), huit événements par page, avec les ventes par rapport à la capacité et le chiffre d'affaires sur chaque ligne.
Le menu de chaque ligne permet de prévisualiser, modifier, ouvrir les participants, dupliquer, publier, dépublier, archiver ou annuler l'événement.
/en/dashboard/events/new crée un événement et /en/dashboard/events/<id>/edit en modifie un, en quatre onglets (Détails, Billets, Programme, Visibilité) à côté d'un aperçu du billet et d'une liste de contrôle de préparation.
Un prix se verrouille après la première vente, pour que ce que les acheteurs ont payé reste exact. Le lieu et le mode d'entrée sont figés dès que des billets sont vendus, un type de billet vendu ne peut pas être supprimé, et une capacité inférieure au nombre de ventes est refusée.
Si quelqu'un d'autre a enregistré l'événement après que vous l'avez ouvert, l'éditeur l'indique et garde votre saisie non enregistrée jusqu'au rechargement.
/en/dashboard/events/<id>/attendees liste les billets de l'événement : titulaire, place, type, statut et heure d'entrée, avec une recherche et des filtres pour entrés, non entrés et annulés.

Lieux

Un lieu contient un nom dans les deux langues, une adresse, une ville, un fuseau horaire, une capacité, des notes d'accessibilité et de transport dans les deux langues, et un point optionnel sur la carte.
La page Lieux du tableau de bord affiche chaque lieu sur une carte et dans une liste avec ses places (réservées avec la version de son plan, ou entrée libre) et ses événements à venir. L'éditeur de lieu a un sélecteur de carte avec recherche de lieux.
Les cartes affichent les tuiles OpenFreeMap et la recherche de lieux utilise le service public Photon, tous deux sans clé. NEXT_PUBLIC_MAP_STYLE_LIGHT, NEXT_PUBLIC_MAP_STYLE_DARK et NEXT_PUBLIC_PLACE_SEARCH_URL dans le tableau de bord les pointent ailleurs.
Le site a une page par lieu avec ses événements et, pour un lieu à places, son plan publié.
Les données d'exemple ont 9 lieux. Room 3 et Mill Street Lecture Hall ont chacun un plan publié de 72 places ; les autres vendent en entrée libre.

Plans de salle

Un plan est une grille de 1 à 40 rangées de 1 à 60 places, avec jusqu'à six allées. Les places sont nommées par lettre de rangée et numéro (A12). L'éditeur de places s'ouvre sur /en/dashboard/venues/<id>/seating.

Chaque place peut être marquée accessible ou accompagnant (les deux affichées sur le plan de l'acheteur), désactivée (masquée aux acheteurs, pour une place cassée ou un emplacement de caméra), et recevoir un niveau de prix : le niveau 1 se vend comme le premier type de billet de l'événement, le niveau 2 comme le deuxième, et ainsi de suite.
Save layout conserve un brouillon, qui se modifie librement. Un lieu a un seul brouillon à la fois.
Publish fige le brouillon en version. Une version publiée ne change plus jamais : les places vendues avec elle continuent de la désigner, et un changement ultérieur est une nouvelle version créée avec Create new version. Publier exige au moins une place activée et pas plus de places activées que la capacité du lieu.
Un événement à places réservées vend le plan publié le plus récent de son lieu, dès que l'événement est publié.

Réservations temporaires de places

Choisir des places sur le plan ne réserve rien ; une réservation le fait. Elle garde les places (ou une quantité d'entrée libre) pour un acheteur pendant la durée de réservation de l'espace de travail, dix minutes dans les données d'exemple, comptée sur l'horloge du serveur, et l'acheteur voit le compte à rebours.
Deux acheteurs ne peuvent jamais réserver la même place. Une place prise un instant plus tôt est refusée avec un message invitant à en choisir une autre.
Une commande contient au plus 8 billets, et jamais plus que la limite propre à un type de billet. Un participant connecté a une réservation active par session : un nouveau choix remplace l'ancien.
Quand le temps est écoulé, les places sont libres pour les autres aussitôt, et un balayage toutes les 15 secondes nettoie les réservations expirées. Les montants d'une réservation sont une copie figée : un changement de prix ultérieur ne la modifie jamais.
La durée de réservation et la limite par commande sont des valeurs de l'espace de travail (hold_seconds, 600, et max_per_order, 8, dans les données d'exemple). Le tableau de bord ne les modifie pas.

Qui peut faire quoi

Permission	Autorise
`events.view`	Voir chaque événement, brouillons compris, et ses participants
`events.edit`	Créer, modifier et dupliquer des événements
`events.publish`	Publier, dépublier, annuler et archiver
`venues.view`	Voir les lieux et leurs plans
`venues.edit`	Créer et modifier des lieux, et enregistrer et publier des plans

Les rôles Propriétaire et Gestionnaire des données d'exemple les détiennent toutes les cinq ; Finance et Contrôle des billets n'en détiennent aucune.

Équipe, rôles et espaces de travail

Ce que vérifie l'API

L'éditeur et l'API refusent avec un code lisible par une machine : VERSION_CONFLICT (quelqu'un a enregistré avant), PRICE_LOCKED, HAS_SALES, EVENT_CLOSED, NOT_READY (avec ce qui manque dans details.missing), INVALID_TRANSITION et CONFIRMATION_REQUIRED.
Enregistrer un brouillon de plan que quelqu'un d'autre a enregistré après votre chargement donne un 409 VERSION_CONFLICT ; en publier un au-delà de la capacité du lieu donne un 400 OVER_CAPACITY.
POST /api/holds exige un Idempotency-Key, et répond avec la réservation et un jeton affiché une seule fois, envoyé ensuite comme X-Hold-Token. Une place qui n'est plus disponible donne un 409 SEAT_UNAVAILABLE, un type complet un 409 SOLD_OUT, une réservation expirée un 410 HOLD_EXPIRED.
GET /api/public/sessions/:code/availability répond avec l'heure du serveur, la durée de réservation, les frais et, pour une session à places réservées, l'état de chaque place. Le site le lit toutes les 20 secondes tant que le plan est ouvert.

Référence de l'API