La Place : documentation fonctionnelle
Dernière mise à jour : 2026-11-03 · Sources : spécifications US01 à US12, tickets Jira (YAIAPI), tâches Freedcamp, code de l'application (branche du 2026-09-17) et ancienne documentation
Les statuts (en production ou en cours) ont été vérifiés par rapport aux tickets et à la branche de production du code (état au 2026-09-10).
À qui s'adresse cette documentation
Elle explique ce que fait La Place et ce que l'on peut y faire, sans entrer dans la technique. Les lecteurs principaux sont les acheteurs d'Api Restauration, qui négocient avec les fournisseurs. Les gestes des autres profils (Administrateur, Utilisateur API, Fournisseur, Manager plateforme) sont décrits aussi, pour que chacun sache ce que voient et font ses interlocuteurs.
Comment la lire
Chaque fiche suit le même parcours, du plus simple au plus fin :
- Les objets : de quoi parle-t-on (un maillage, un prix, un appel d'offres...) et quelles notions faut-il connaître.
- Les états : dans quels états l'objet peut se trouver, et ce que l'on voit à l'écran dans chacun.
- Les gestes : ce que l'on peut faire (où, qui, avant et après, conditions, conséquences).
- Les profils : qui a le droit de faire quoi (le tableau « Qui fait quoi » de chaque fiche).
- Les conséquences : ce que le geste déclenche ailleurs (autres objets, notifications, emails, outils aval).
Un geste est permis à un profil seulement si La Place l'autorise et si le bouton lui est affiché. Pas de bouton : la réponse est « non ».
Pour une première lecture, commencer par le glossaire, puis Profils et droits, puis la fiche Maillage, qui sert de modèle aux autres. En cas de blocage : Je suis bloqué.
Légende
- (en cours) : fonctionnalité qui n'est pas encore en production (recette, développement, ou décidée mais pas livrée). Elle figure dans le titre ou le paragraphe concerné. Quand elle remplace un comportement actuel, la fiche décrit d'abord le comportement actuel, puis un paragraphe « Nouveau comportement (en cours) ».
- Évolutions prévues : en fin de fiche, ce qui est envisagé sans être décidé.
- Libellés entre « » : textes affichés dans l'écran, tels qu'on les lit. Un message d'erreur de La Place est paraphrasé.
- Profils : Administrateur, Utilisateur Achats (l'acheteur), Utilisateur API (lecture seule), Fournisseur, Manager plateforme. Voir Profils et droits.
- Dans les états : camion vert (livré), orange (livré avec un autre produit), rouge (non délivré).
Questions fréquentes
- Comment valider un maillage ?
- Pourquoi je ne peux pas modifier un prix ?
- Que se passe-t-il quand je retiens un bassin ?
Arborescence
| Fichier | Contenu |
|---|---|
| 00-glossaire.md | Les termes et sigles (PG, REF, BT, AO...), un lien vers la fiche de chacun |
| 01-profils-et-droits.md | Les cinq profils et, par objet, ce que chacun peut faire |
| 02-contexte-filtres-favoris.md | Le contexte (plateforme, bassin), les filtres, les favoris, les tris |
| 03-je-suis-bloque.md | Les situations de blocage fréquentes et ce qu'il faut faire |
| Objets | |
| objets/produit-generique.md | Produit générique (PG) : création, publication, archivage, versions |
| objets/reference.md | Référence (REF) : versions, pré-maillage, indisponibilité |
| objets/reference-generique.md | Référence générique (en cours) |
| objets/unites.md | Unités et coefficients des PG et des références |
| objets/etiquettes.md | Étiquettes (labels, fabricants, marqueurs...) |
| objets/bassin-tarifaire.md | Bassin tarifaire (BT) et son fournisseur principal |
| objets/plateforme-fournisseur.md | Plateformes et fournisseurs, contacts, invitations |
| objets/maillage.md | Maillage : réponse du fournisseur pour un PG dans un bassin (fiche modèle) |
| objets/prix.md | Prix : soumission, validation, refus, réouverture |
| objets/appel-d-offres.md | Appel d'offres (AO) : création, lancement, modification |
| objets/ao-bassin.md | AO-bassin : un bassin dans un AO (périodes, rétention, clôture) |
| objets/configurateur-ao.md | Configurateur d'AO : génération automatique des AO |
| objets/negociation.md | Outil de négociation (en cours) |
| objets/utilisateurs.md | Comptes, connexion, invitations, favoris, notifications |
| Transverses | |
| transverses/imports-exports.md | Tous les imports et exports Excel |
| transverses/emails-et-flux.md | Emails envoyés, notifications, échanges avec les outils d'Api Restauration |
| Sources | |
| sources.md | Sources de la documentation : documents et version du code utilisés |