---
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.

---

<a id="risque-doc-feature-partiellement-implementee"></a>
## 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
