--- title: Product — Risques & vigilance : Général domain: product bucket: risques tags: [documentation, feature-scope, ui, store, guide-utilisateur] applies_to: [product, review, documentation] severity: medium validated_on: 2026-06-25 source_projects: [app-alexandrie] --- # Product — Risques & vigilance : Général > Extrait de la base de connaissance Lead_tech. Voir `knowledge/product/risques/README.md` pour l'index complet. --- ## Documentation d'une feature partiellement implémentée (store sans UI) ### Risques - Le guide utilisateur décrit une fonctionnalité câblée côté store/service mais jamais exposée dans l'UI écran - L'utilisateur cherche une étape (ex. joindre une capture d'écran) qui n'existe pas réellement dans l'application - Faux sentiment de complétion : la story semble livrée parce que le store/service existe, alors que le parcours utilisateur est inutilisable ### Symptômes - Le store ou le service existe (ex. `uploadSupportAttachment`) mais l'écran ne contient aucun composant UI correspondant : pas d'`ImagePicker`, pas de bouton d'attachement - Le guide mentionne une étape sans contrepartie visible à l'écran - La story spec annonce la feature comme livrée alors que seul le câblage technique est présent ### Bonnes pratiques / mitigations - **Règle** : avant de documenter une feature dans le guide utilisateur, vérifier que l'UI l'expose effectivement à l'utilisateur final — ne pas se fier aux seuls stores/services - Croiser systématiquement la story spec (feature annoncée) avec l'implémentation écran réelle - Si la fonctionnalité est dans le store mais pas dans l'écran : soit la documenter comme "disponible prochainement", soit ne pas la mentionner du tout - Contexte technique : guide utilisateur / scope feature — app-alexandrie 13-04-2026