Pages et espaces

Le dossier frontend-web/src/app contient 35 fichiers page.tsx, donc 35 URL. Elles se répartissent en quatre espaces qui partagent le même design system mais pas les mêmes droits. Cette page en donne l'inventaire complet : URL, rôle, données appelées et droits requis côté client et côté backend.

Toutes les pages, publiques comme privées, reprennent la présentation des écrans de l'application mobile : cartes blanches arrondies sur fond gris clair, carte jaune pour le tirage en cours, pilules et pastilles teintées, icônes du jeu mobile. Les pages citoyennes suivent les écrans mobiles équivalents (accueil, billetterie, tirage, boutique, profil) ; les pages Mairie et partenaires en appliquent les mêmes composants, avec des tuiles d'indicateurs (KpiTile) à icône. Le détail des couleurs et des composants est dans Design system.

#Lire les tableaux

• Données : hooks RTK Query (définis dans État et appels API) et endpoint du backend. « Aucune » signifie que la page n'appelle pas l'API.
• Droit client : contrôle effectué par RequireRole dans le layout de l'espace. C'est un confort d'interface, pas une protection.
• Droit backend : contrôle réel appliqué par les middlewares authenticate et requireRoles des routes appelées. La matrice complète est dans Autorisations et matrice des droits.

Les pages sans espace (erreurs) sont listées en fin de page.

#Espace public

Dix pages accessibles sans compte. La page d'accueil et la transparence utilisent PublicShell ; les cinq pages légales passent par LegalDocumentPage de LegalPage.tsx, qui affiche le document de content/legal.ts dans la langue choisie ; la connexion et l'invitation sont des pages autonomes. Le pied de page public et la coquille connectée listent les six documents légaux et un bouton « Gérer mes traceurs » (voir Analytique et consentement).

#Espace citoyen

Quatorze pages sous le groupe de routes (citoyen). Le layout (citoyen)/layout.tsx appelle RequireRole sans liste de rôles : tout compte authentifié y entre, y compris un administrateur ou un partenaire. Toutes les routes du backend appelées ici exigent authenticate, sauf les lectures publiques de la loterie et du catalogue.

La navigation de l'espace citoyen expose cinq onglets (Accueil, Tickets, Tirage, Boutique, Profil) et trois entrées réservées au bureau : Historique et POAP, Mes codes, Charte et aide.

#Dashboard Mairie

Sept pages sous mairie/layout.tsx, réservées au rôle ADMIN côté client. Côté backend, tout le routeur /admin applique authenticate puis requireRoles('ADMIN'). Ce middleware refuse aussi un administrateur qui n'a pas activé la 2FA quand ADMIN_MFA_REQUIRED vaut true (valeur par défaut, imposée en production) : la page s'affiche alors, mais les appels répondent 403 jusqu'à l'activation depuis /profil/securite/2fa.

#Espace partenaires

Quatre pages sous partenaire/layout.tsx, ouvertes aux rôles PARTNER et ADMIN. Le layout insère PartnerSelectionProvider (PartnerSelection.tsx) : il charge GET /partners et choisit l'établissement courant.

#Récapitulatif

flowchart LR
  V["Visiteur"] --> PUB["/ et pages publiques"]
  PUB --> CX["/connexion"]
  CX -->|"USER"| ACC["/accueil"]
  CX -->|"ADMIN"| MAI["/mairie"]
  CX -->|"PARTNER"| PAR["/partenaire"]
  CX -->|"2FA requise"| VER["/connexion/verification"]
  VER --> ACC
  VER --> MAI
  VER --> PAR

La redirection après connexion est calculée par homeForRole dans frontend-web/src/hooks/useAuth.ts, sauf si un paramètre next valide est présent.

#Pages d'erreur

Trois fichiers ne sont pas des pages mais des frontières d'erreur de l'App Router :

#Comptes pour parcourir les espaces

Les comptes du seed (citoyen@etherbay.fr, maire@etherbay.fr, boulangerie@etherbay.fr) et la manière d'obtenir le code de connexion en local sont décrits dans Comptes de démonstration et connexion. Les comptes Mairie et partenaire se connectent par /connexion?espace=pro, qui masque la tranche d'âge et le parrainage.

Pour ajouter une page, suivre Ajouter une page web.