Fonctionnalités et scénarios

S'approprier le logiciel à travers ses fonctionnalités et ses scénarios

Porphyry est un logiciel générique de catalogage participatif. Vous allez contribuer à son usage dans des domaines très divers et allez pouvoir l'améliorer en ajoutant des fonctionnalités et des corrections.

Pour cette séance, il est conseillé de travailler par binôme et de faire le point régulièrement avec les autres binômes de votre équipe.

Découverte des fonctionnalités

1. Ouvrez le site vitrine du collectif Hypertopic, lisez la page d'accueil puis la page de présentation du logiciel "Porphyry".
2. Vérifiez que chaque fonctionnalité est formulée selon les deux critères donnés en cours.
3. Notez dans l'espace de discussion de votre équipe, ce que vous ne comprenez pas. Vos collègues ou vous-mêmes pourront essayer de le reformuler ou de l'expliquer ensuite.
4. En première approximation et en lien avec votre matrice de la semaine dernière : Quels seraient les items de votre catalogue ? Leurs catégories ? Par quels types de contributeurs seraient-ils produits ? Prévoyez-vous plusieurs "points de vue" ? Discutez en dans votre espace de discussion.

Scénarios de consultation

Lecture de scénarios

Dans cette section, pour disposer d'items et de catégories en nombre suffisant, nous utiliserons les données concernant les vitraux de l'Aube.

1. Consultez les scénarios du feuilletage d'un portfolio.
   • À quelle fonctionnalité officielle correspondent-ils ?
   • Suivez le déroulement des scénarios en les testant pas à pas sur le site en production.
   • Vérifiez qu'ils suivent les critères indiqués au tableau.
2. Faites de même avec celui correspondant à la consultation d'items similaires à un premier item, sachant que l'item dont il est question est ici.

Scénarios d'édition

Pour tester les scénarios d'édition, nous allons utiliser notre propre serveur Porphyry (frontend) configuré de telle sorte qu'il interroge le serveur Argos (backend) de test :

docker run -p 3000:80 benel/porphyry

Porphyry est désormais disponible à l'adresse http://localhost:3000 Vous devez voir à peu près la même quantité de données que précédemment (mais de qualité un peu inférieures). Attention, comme le serveur de test est partagé avec tous les autres développeurs, il y a quelques règles à respecter : vous pouvez ajouter des données mais ne supprimez pas ou ne modifiez des données existantes au risque de causer des problèmes aux autres développeurs (notamment pour leurs tests).

Rédaction d'un scénario de "fix"

1. Sur l'environnement de test que vous venez de mettre en place, déroulez le scénario ci-dessous :

   #language: fr
   
    Fonctionnalité: Décrire un item à l’aide d’attributs
   
    Scénario:
      Soit un item en cours de création
      Et l'utilisateur "alice" connecté
      Quand l'utilisateur indique "Musée de Vauluisant, Troyes" comme valeur de l'attribut "spatial"
      Alors la valeur de l'attribut "spatial" est "Musée de Vauluisant, Troyes"

2. Consultez le ticket #143 et faites l'expérience du dysfonctionnement.

3. Ajoutez à la description de cette fonctionnalité un second scénario anticipant la résolution du dysfonctionnement (notez le dans votre espace de discussion et comparez vos propositions).

Rédaction d'un scénario pour une fonctionnalité

1. Créez un point de vue et quelques catégories, puis à partir de votre item, référencez les.
2. Rédigez un scénario correspondant à la fonctionnalité de description d'un item avec une catégorie.
3. D'après la liste des fonctionnalités et vos essais sur le logiciel, y a-t-il d'autres cas ? Nommez les puis écrivez un scénario pour chacun.
4. Cherchez des ticket décrivant un dysfonctionnement de cette fonctionnalité. Que pourriez-vous faire ici également ?

Mise en place d'une preuve de concept

1. Pour chaque primitive de Porphyry, indiquez comment vous l'instancieriez dans votre projet :

   Primitive	Nom en français	Usage	Dans votre projet
   Item	item	Ce que l'on catalogue
   Corpus	corpus	Ensemble plus ou moins cohérent d'items
   Attribute	attribut	Élément consensuel de description de l'item
   AttributeName	nom d'attribut	ex : "auteur", "lieu", "date" (s'ils sont consensuels), "licence", "vignette"...
   AttributeValue	valeur d'attribut	ex : Tartempion, Troyes, 2018, 1914/8...
   Resource	ressource	Contenu documentaire principal d'un item (image, texte, page Web, etc.)
   Topic	rubrique / catégorie	Élément de description de plusieurs items dépendant du point de vue d'une personne ou d'un groupe de personnes
   Viewpoint	point de vue	Regroupement des rubriques portées par le même groupe de personnes et faisant "système" (notamment par une organisation hiérarchique des rubriques)
   User	portfolio	Combinaison cohérente de points de vue et de corpus pour un usage donné

2. Installez votre propre Argos (backend) et configurez Porphyry (frontend) pour qu'il s'y connecte.

3. Commencez à ajouter des données qui illustrent ce que vous obtiendriez dans votre projet.