Aller au contenu

Architecture

Section destinée à la personne qui maintient le site.

Brique Rôle
Nuxt 4 + Nuxt UI 4 site public, espaces Website / Congress / Reviewing / participant, routes serveur Stripe
Directus 11 base de contenu, API, authentification, permissions par rôle
Postgres base de données
Stripe paiement (Checkout carte/SEPA, factures pour les institutions), webhooks
Docker Compose stack locale et stack de production
frontend/                 Nuxt
  app/pages/              site public, /edit, /congress, /reviewer, /account
  app/utils/adminCollections.ts   définition des écrans d'édition (champs, listes, aperçus)
  server/api/stripe/      checkout, invoice, webhook
  server/api/admin/       refund (Organizer uniquement)
  scripts/init-schema.mjs collections, champs, rôles et permissions (idempotent)
  scripts/seed.mjs        données de démonstration
backend/extensions/       extensions Directus éventuelles
deploy/                   modèle nginx de l'hôte
documentation/            cette documentation (MkDocs)
docker-compose.yml        stack locale
docker-compose.prod.yml   stack VPS

Principes

  • Rien n'est écrit en dur dans les pages publiques : textes, menus, dates, tarifs viennent de Directus.
  • Le navigateur parle à Directus via le proxy /__directus du site ; la session est gardée dans localStorage (ivr2028_auth).
  • Les espaces internes (/edit/**, /congress/**) sont rendus côté client (ssr: false).
  • Les permissions sont appliquées par Directus, pas par l'interface : un Editor qui appelle l'API des inscriptions reçoit une erreur 403.
  • Le prix d'une inscription est recalculé côté serveur à partir de fee_categories, options (montants en centimes) et des échéances de settings (heure de Paris). Le navigateur n'envoie que des codes.

L'aperçu en direct

L'aperçu de l'espace Website est le vrai site, chargé dans une iframe (?preview=1).

  1. components/admin/PreviewPane.vue envoie le brouillon à l'iframe par postMessage (même origine uniquement, 120 ms après la dernière frappe).
  2. plugins/03.preview.client.ts, actif seulement dans une iframe, remplace la donnée correspondante (useNuxtData(clé)) sans rien enregistrer, puis fait défiler jusqu'à la section concernée.
  3. À chaque navigation, l'iframe répond ivr-preview-ready et l'éditeur renvoie son brouillon.

Chaque écran déclare sa cible dans adminCollections.ts (preview / itemPreview : chemin, clé de données, ancre). Une page ou une news en brouillon s'affiche dans l'aperçu mais reste en 404 pour les visiteurs.