Aller au contenu

Pages de connexion et accueil de la plateforme

Cette page explique pourquoi les pages de connexion et l'accueil public de Kirexo se présentent comme ils le font une fois habillés au design system : un flux de connexion en deux étapes posé en plein écran, une distinction visuelle nette entre l'espace utilisateur et l'espace d'administration, et un accueil qui change de visage selon qu'il existe ou non des articles publiés. Elle ne décrit pas la mécanique d'authentification elle-même — pour ça, voir Architecture des firewalls et le how-to Se connecter à Kirexo. Pour le design system lui-même (tokens, thème, accent), voir l'explication Pourquoi un accent d'instance piloté serveur et la Référence du design system.

Le flux de connexion, inchangé mais réhabillé

Le mécanisme de connexion email-first — saisir son email, puis seulement après voir apparaître le champ mot de passe — préexistait au design system. L'habillage ne change rien à ce mécanisme : le Live Component App\Twig\Components\EmailFirstLogin (src/Twig/Components/EmailFirstLogin.php) est conservé tel quel. Validation de l'email, anti-énumération (un email inconnu ne révèle rien), protection CSRF, « rester connecté », lien « mot de passe oublié » : tout ce comportement reste identique. Seuls les templates changent.

Pourquoi ne toucher qu'à la présentation ? Parce que le comportement de connexion est déjà correct et déjà couvert par des tests. Le réhabiller en réécrivant le composant PHP introduirait du code de production à re-tester sans aucun gain fonctionnel — et risquerait, au passage, de casser le binding AJAX du Live Component (les LiveAction checkEmail / resetEmail, les props, l'élément racine <div {{ attributes }}> ancre du re-render). La frontière a donc été tracée nettement : le design system habille, il ne réécrit pas la logique.

Concrètement, l'utilisateur perçoit toujours les deux mêmes étapes :

  1. Étape email — il saisit son adresse ; un email vide ou mal formé le maintient à cette étape avec un message neutre.
  2. Étape mot de passe — une fois l'email validé, le champ mot de passe apparaît, avec le lien « mot de passe oublié ». Un lien « Modifier l'email » (l'action resetEmail) permet de revenir à l'étape précédente.

La soumission finale part vers le firewall Symfony (/login_check ou /admin/login_check), hors du composant. Ce déroulé est détaillé côté utilisateur dans Se connecter à Kirexo.

La connexion en plein écran : une page, pas un encart

Les pages de login s'inséraient à l'origine dans les layouts applicatifs (un layout « épuré » côté user, « sobre » côté admin). Le design system les pose en plein écran : templates/login/index.html.twig et templates/admin/login/index.html.twig étendent directement base.html.twig (et non plus un layout porteur de header), et placent un conteneur lg-wrap à deux colonnes directement dans le <body>.

Ce choix du plein écran répond à l'intention de la page. Se connecter n'est pas une action « dans » l'application : c'est le seuil par lequel on y entre. Une page de login n'a donc rien à afficher d'une session qui n'existe pas encore — ni liens d'espace, ni menu de compte, ni actions contextuelles.

Ce qu'elle garde, en revanche, c'est l'entête partagé, rendu au-dessus du lg-wrap (<twig:Header />). Il ne contredit pas le raisonnement, il l'illustre : sans session, cet entête se réduit à la marque et au sélecteur de thème — c'est-à-dire à ce qui n'exige aucune authentification. Rien de la coquille applicative n'est exposé à un visiteur non authentifié ; le lien « Se connecter » lui-même est masqué sur la page de connexion, où il n'aurait aucun sens.

Les deux colonnes du lg-wrap séparent motivation et action :

  • un aside (lg-aside) qui porte l'identité de marque et un message d'accroche ;
  • une carte (lg-main / lg-card) qui contient le titre, un sous-titre, d'éventuels messages flash, et le composant EmailFirstLogin.

Le landmark #main — cible du lien d'évitement du design system — est posé sur la colonne lg-main, de sorte que la navigation clavier saute directement au formulaire et non à l'argumentaire de l'aside.

Distinguer l'espace utilisateur de l'espace administrateur, dès le login

Kirexo sépare deux espaces qui n'ont pas le même rôle : l'espace utilisateur, où l'on écrit et publie ses articles, et l'espace d'administration, qui gère les comptes mais jamais le contenu (voir Architecture des firewalls). Cette séparation existe déjà côté sécurité — deux firewalls, deux sessions. Le design system la rend immédiatement lisible à l'œil, dès la page de connexion.

Côté utilisateur : une page qui motive à écrire

La page /login met en avant l'usage de la plateforme. Son aside affiche une accroche (« Écrire une fois, diffuser partout. ») et des chips rappelant les canaux de diffusion (Web, RSS, ActivityPub) — la marque, elle, n'y est pas répétée : elle est portée une seule fois, par l'entête. Le ton est celui d'un outil d'écriture : on rappelle au visiteur pourquoi il revient se connecter — reprendre l'écriture — avant de lui demander ses identifiants. C'est cohérent avec l'esprit « éditeur de texte » revendiqué pour l'espace utilisateur.

Côté administrateur : l'identité back-office, visible immédiatement

La page /admin/login affiche au contraire, dès l'arrivée, l'identité de l'espace d'administration. Ce repère tient à un seul élément : l'entête, rendu en space="admin", porte la pastille « Admin » à côté de la marque. Le ton du texte est sobre et signale une zone réservée (« Gestion des comptes et de la plateforme. L'accès est strictement réservé aux administrateurs. »).

Pourquoi rendre l'ambiance admin visible avant même la connexion ? Parce que la page de login admin n'est pas un détail périphérique : c'est le premier écran de l'espace d'administration. Un administrateur qui atterrit sur /admin/login doit savoir d'un coup d'œil qu'il est au bon endroit — et qu'il n'est plus dans l'interface d'écriture. La distinction visuelle est un repère, pas une décoration.

Un panneau qui suit le thème, un seul repère d'espace

L'aside de la page admin est le même composant lg-aside que celui de la connexion utilisateur (templates/admin/login/index.html.twig). Il suit le thème choisi par le visiteur : un aplat --accent-soft en clair, un fond --surface en sombre, un texte en --ink / --ink-2 dans les deux cas. Deux raisons justifient ce choix.

Le choix clair / sombre du visiteur prime. Le thème est une préférence de confort, propre à chaque visiteur (voir Pourquoi le thème reste, lui, une préférence locale). Un panneau qui garderait un fond sombre en thème clair occuperait près de la moitié de l'écran en contredisant ce choix, sur la première page que voit l'administrateur.

Un repère d'espace unique évite deux marques concurrentes. La pastille « Admin » de l'entête suffit à dire où l'on est. Ajouter un second marqueur dans l'aside dupliquerait l'information, et deux marques finissent par diverger. C'est le même raisonnement qui a retiré de l'aside l'ancien pseudo-logo « Kirexo ADMIN » : la marque est portée une seule fois, par l'entête partagé (voir Entête partagé).

Il en allait autrement auparavant. L'aside portait aussi la classe bo-side, qui donne un fond sombre fixe à la barre latérale de la coque admin. Dans assets/styles/screens.css, .bo-side est déclarée après .lg-aside, avec la même spécificité. En thème clair, elle l'emportait donc à l'ordre de déclaration et imposait son fond sombre, quel que soit le choix du visiteur. En thème sombre, la règle [data-theme="dark"] .lg-aside, plus spécifique, reprenait la main. Le panneau ne suivait donc le thème qu'à moitié, et le commentaire de .bo-side (« constante dans les deux thèmes ») ne décrivait pas ce qui s'affichait réellement. Retirer bo-side de l'aside supprime ce conflit de cascade. La feuille rappelle désormais, en commentaire, de ne jamais combiner .lg-aside avec une classe de coque à fond fixe.

Préfixe bo-, jamais ad-

Les classes propres au back-office utilisent le préfixe bo- (bo-side, bo-brand…), jamais ad- : un préfixe ad- est fréquemment bloqué par les bloqueurs de publicité, ce qui casserait silencieusement le style de l'admin. bo-side reste la barre latérale de la coque admin, même si la page de connexion ne l'utilise plus. Cette convention est détaillée dans la Référence du design system.

Cette discrétion visuelle ne remplace pas la discrétion technique : pour un visiteur déjà connecté à l'espace utilisateur, /admin/login renvoie carrément un 404 — l'admin se masque entièrement. C'est un mécanisme distinct, expliqué dans Masquer l'admin : 404 plutôt que 403. L'habillage de la page ne concerne que ce qu'un visiteur légitime (anonyme ou administrateur) voit.

L'accueil de la plateforme : deux états selon le contenu

L'accueil public (/, route app_home, servie par src/Controller/AppHomeController.php) a deux visages, selon qu'il existe ou non des articles publiés. Ce n'est pas une coquetterie : une plateforme fraîchement installée et une plateforme vivante n'ont pas le même besoin.

État vide : inviter à écrire le premier article

Quand aucun article n'est publié, l'accueil affiche un écran d'invitation : un titre (« Votre carnet est prêt. »), un texte d'incitation, un bouton principal « Écrire le premier article », et trois étapes d'onboarding indicatives. Une plateforme vide ne doit pas afficher une liste vide — un trou — mais orienter vers la seule action qui a du sens à ce stade : écrire.

Un détail important : le bouton « Écrire le premier article » pointe vers l'accueil de l'espace utilisateur (/u, route app_user_home), pas vers l'éditeur. Ce n'est pas une approximation : la création d'un article exige un carnet — la route de création porte l'identifiant du carnet (/u/carnets/{id}/articles/nouveau, src/Controller/AppArticleNewController.php) — et l'accueil public ne sait pas dans lequel des carnets du visiteur il faudrait écrire. Le CTA mène donc là où ce choix se fait.

État rempli : le fil des articles publiés

Dès qu'au moins un article est publié, l'accueil bascule sur le fil des articles : un masthead (titre de la plateforme) suivi de la liste des articles publiés, du plus récent au plus ancien. Chaque article affiche son titre, son extrait, sa date de publication et ses canaux de diffusion (Web, RSS, Mastodon/ActivityPub, API).

Les titres d'articles y sont des liens inertes (href="#"), et ce n'est pas un oubli : la lecture publique d'un article n'a pas lieu sur la plateforme, mais sur le site du carnet servi par le plugin web, à son propre domaine (voir Rendu public d'un site). Or un article publié peut très bien appartenir à un carnet sans site — tant qu'aucun domaine ne lui est rattaché, il n'existe aucune adresse publique vers laquelle pointer. Le fil donne donc à voir l'activité de la plateforme sans promettre une destination qui n'existe pas toujours.

Pourquoi un service synchrone et pas un bus

Le choix « vide vs liste » se décide entièrement à partir d'une donnée : la liste des articles publiés. Le controller la récupère via un service applicatif synchrone, App\Service\Article\ArticleFeedProvider (src/Service/Article/ArticleFeedProvider.php), qui délègue à ArticleRepositoryInterface::findPublishedForPublic() — les articles publiés d'auteurs actifs uniquement (voir Effacement public). La chaîne est controller → service → repository, sans bus Messenger.

C'est l'application directe du pattern 1 de Kirexo : la logique de lecture interne (rendu d'une page, d'un dashboard) passe par des services synchrones injectés, pas par un query bus. Le bus Messenger est réservé à l'asynchrone réel (diffusion découplée d'un article publié vers les plugins, via RabbitMQ) ou aux routes dédiées de type API. Afficher l'accueil n'est ni l'un ni l'autre : c'est une lecture, immédiate, dans le cycle de la requête. Le raisonnement général est posé dans Architecture.

Le controller reste volontairement fin : il ne calcule rien. La distinction « vide vs liste » est un simple test de cardinalité côté Twig (articles is empty), pas une branche métier dans le code PHP. Le controller délègue la lecture et passe la liste au template ; le template décide de l'écran à afficher.

Voir aussi