Passer au contenu principal

ArtinTech Solution

Adding a Review Step to a Newsroom Publishing Workflow

Dans la plupart des rédactions, ce n’est pas la personne qui envoie les pages qui les valide. La version 1.0 d’Inkfold connaissait les brouillons et les éditions publiées, et comptait entre les deux sur les discussions entre collègues. La version 1.1 ajoute ce que font vraiment les rédactions : envoyer en relecture, renvoyer avec une note, publier.

Un troisième état, pas un indicateur de plus

Il est tentant d’ajouter un booléen « à relire » à côté du statut. Nous avons plutôt ajouté une troisième valeur au statut lui-même : brouillon, en relecture, publié. Un booléen permettrait des combinaisons impossibles, comme une édition publiée qui reste à relire, et chaque requête devrait penser à vérifier les deux. Avec un seul champ, la règle existante selon laquelle seules les éditions publiées dont l’heure de publication est passée sont visibles des lecteurs continue de fonctionner sans changement : une édition en relecture n’est tout simplement pas publiée.

Deux colonnes accompagnent l’état : qui a envoyé l’édition en relecture, et la note du relecteur. La note est effacée quand l’édition est renvoyée ou publiée, pour qu’une ancienne remarque ne trouble jamais le tour suivant.

Une édition en attente de relecture dans la rédaction Inkfold, avec le champ de note du relecteur
Le rédacteur en chef voit qui a envoyé l’édition et peut la publier ou la renvoyer avec une note.

Des rôles faits de petits droits

Les rôles sont des listes de droits, et les routes sont regroupées par droit, pas par nom de rôle. En scindant l’ancien droit « gérer les éditions » en trois, le nouveau rôle est venu presque tout seul :

  • stories.edit — ouvrir éditions et pages, tracer et corriger les zones d’articles, envoyer en relecture.
  • issues.manage — créer des éditions, envoyer, importer, réordonner et supprimer des pages.
  • issues.publish — publier, programmer, dépublier, valider ou renvoyer une relecture.

Un opérateur de mise en ligne a les deux premiers, un rédacteur en chef les trois, et le nouveau correcteur seulement le premier : il peut corriger une faute dans un titre ou un cadre mal placé, mais ne peut ni envoyer, ni supprimer, ni publier. Les vues utilisent les mêmes droits : un correcteur ne voit jamais un formulaire d’envoi qu’il ne pourrait pas soumettre.

Création d’un utilisateur dans la rédaction Inkfold avec choix du rôle
Quatre rôles : administrateur, rédacteur en chef, opérateur de mise en ligne et correcteur.

Des transitions qui refusent de mal tourner

Chaque transition vérifie son état de départ sur le serveur : seul un brouillon peut partir en relecture, et seule une édition en relecture peut être renvoyée. Une édition sans pages ne peut pas être envoyée du tout. La publication fonctionne depuis le brouillon ou la relecture : un rédacteur en chef peut toujours publier directement à deux heures du matin. Quand l’édition est en ligne, les lecteurs qui l’ont demandé reçoivent un unique e-mail, une étape présentée dans le dernier article de la série.

Testé rôle par rôle

Chaque rôle a un test qui parcourt le circuit et essaie les routes interdites : l’opérateur envoie une édition en relecture sans pouvoir la renvoyer, le rédacteur en chef la renvoie avec une note que l’opérateur voit ensuite, et le correcteur corrige un titre mais reçoit un 403 pour l’envoi, la suppression et la publication.

À retenir

  • Modéliser le circuit comme les états d’un seul champ, pour rendre les combinaisons impossibles impossibles.
  • Définir les rôles comme des listes de petits droits et protéger les routes par droit.
  • Valider sur le serveur l’état de départ de chaque transition.
  • Tester chaque rôle contre les routes qu’il ne doit pas atteindre.

Plus tôt dans la série : un outil de balisage piloté au clavier. Connectez-vous comme rédacteur en chef dans la démo Inkfold pour voir une édition en attente de relecture ; le logiciel est sur Charming Theme.

Besoin de circuits de validation ou de rôles fins dans votre application Laravel ? Parlons-en — ArtinTech Solution en construit chaque mois.

Share this article

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *