---
suivi: 1454
date: 2026-09-04
sujet: Boîte dépôt — aide filtres en icône HelpHint
chantier: depot_factures
type: fix
statut: poussé
hash: 803f46e9
fichiers:
  - resources/js/Pages/DepotFactures/Index.vue
  - resources/js/Components/HelpHint.vue
  - tests/Unit/DepotBoiteAideFiltres1454SourceTest.php
  - tests/Unit/DepotFacture1450SourceTest.php
  - docs/suivi/SUIVI_1454_depot_aide_filtres.md
  - public/build/
---

# SUIVI #1454 — Aide discrète sur les cases de la boîte

## PROMPT ENVOYÉ

Le paragraphe de trois lignes sous les cases « Mes factures à compléter » /
« Voir mes dépôts » (#1450) est trop encombrant. Le remplacer par une icône
d’aide « ? », réutiliser un composant existant, accessible clavier, panneau
qui tient dans la colonne ~300 px. Ne pas défaire #1450 / #1407. Pas
d’overflow-x-hidden. Pas de logique de filtre.

## FICHES LUES

- `SUIVI_1450` — union des deux cases, texte à conserver ; `a_completer` coché par défaut.
- `SUIVI_1215` LEÇON — `HelpHint.vue` créé pour un « ? » réutilisable (v-tooltip trop court).
- `SUIVI_1407` — ancienneté / entité / recherche : non touchés.
- `SUIVI_1271` / `SUIVI_1444` — pas d’`overflow-x-hidden`.

Base : `origin/main` `2a8ed0ec` (chore #1453), ancêtre `f33abb92` (#1450).

## COMPOSANT RELEVÉ

Frise Workflow (`Factures/Show.vue`) : bouton `pi-question-circle` qui ouvre un
**Dialog** page-spécifique (`workflowAideDialogVisible`) — contenu workflow, non
réemployable tel quel.

Composant déjà prévu pour ce cas : `HelpHint.vue` (#1215), utilisé en prospection
et explorateur SharePoint. Réemployé. Prop optionnelle `panelClass` pour borner
la largeur à `min(16.5rem, 100vw-2rem)` (~264 px) dans la colonne étroite.
Focus clavier ouvre le panneau ; Escape le ferme ; `aria-label` / `aria-expanded`.

## TEXTE AFFICHÉ

Les deux cases se cumulent en union : vos dépôts et/ou les factures dont vous êtes le valideur, encore en boîte.

Type, validateur, entité et recherche s’ajoutent.

## SYNTHÈSE

Paragraphe permanent retiré. « ? » à droite des deux cases. Aucun PHP applicatif.
Aucun .php métier. Tests source uniquement.

## DÉPLOIEMENT-TEST

git pull origin main
php artisan optimize:clear
php artisan view:clear
Pas de migrate.

## LEÇON

La frise Workflow n’est pas un HelpHint : c’est un Dialog local. Chercher
`HelpHint.vue` (#1215) avant d’en créer un second. Dans une colonne ~300 px,
le panneau 22rem par défaut déborde : `panelClass` plus étroit, ancré à droite.