---
suivi: 1215
date: 2026-08-05
sujet: Prospection — aide « ? » colonne État foncier
chantier: foncier / prospection
type: feature
statut: poussé
hash: cc8f05f2
fichiers:
    - resources/js/Components/HelpHint.vue
    - resources/js/Pages/Foncier/Prospection/Index.vue
    - database/data/journal_mises_a_jour_post_2026_06_12.php
    - public/build/
    - docs/suivi/SUIVI_1215_prospection_aide_etat_foncier.md
---

# SUIVI #1215 — Aide états fonciers (Prospection)

## PROMPT ENVOYÉ

Ajouter un « ? » discret sur l’en-tête ÉTAT de la grille Prospection, avec le
texte CDC littéral (7 états + 2 axes complémentaires). Réutiliser un composant
existant si possible. Recenser les autres libellés candidats sans les coder.
Journal + build + push.

## Fiches lues

- #1208 — grille Prospection, colonne État, 3 modes ; ne pas toucher logique /
  filtres / pastilles / colonne 1 / modale.
- #1201 — bandeau MAJUSCULES (en-têtes) — le panneau d’aide force `normal-case`.
- #1181 — dictionnaire ERP = CLI docs, pas d’UI d’aide colonne.
- #1192 — ergonomie discrète (pas d’alerte ambre/rouge pour une aide).

## OBJET 2 — Composant retenu

Inventaire : `v-tooltip` (textes courts) ; `WorkflowAideDialog` (dialog workflow
spécifique) ; popover ad hoc Factures/Show (superadmin, non générique) ;
`WorkflowComptaEcrituresHover` (hover domaine compta) ; centre d’aide / #1181
(pas adaptés à un en-tête de colonne).

**Nouveau composant générique** : `resources/js/Components/HelpHint.vue`
- props : `title` (opt.), `ariaLabel` ; contenu via **slot**
- ouverture au **survol** et au **clic** (pin tactile) ; Esc / clic dehors ferme
- « ? » gris discret (`#9CA3AF`), panneau `max-w` / `max-h` scrollable (mobile)

## OBJET 1 — Intégration

Uniquement `Prospection/Index.vue` en-tête colonne État (les 3 modes partagent
le même `<thead>`). Texte CDC inchangé. Aucun back / migration.

## OBJET 3 — Recensement (instruit, non codé)

| Écran | Libellé | Pourquoi |
|-------|---------|----------|
| Prospection (grille) | Statut cadastral (badge Remplacée) | Confondu avec l’état foncier — déjà mentionné dans l’aide État |
| Prospection / fiche parcelle | Occupation | Idem, 3ᵉ axe |
| Dossiers fonciers | Statut dossier | Cycle métier opaque pour les nouveaux |
| Offres foncières | Statut offre (#1198) | Transitions et libellés non évidents |
| Commercialisation / lots | Statuts stock / réservation / dation | Machine d’états dense |
| Factures / dépôt | Étapes workflow | Déjà une aide Dialog — modèle à généraliser ailleurs |
| Étude Fi / lots | Régimes de TVA | Libellés fiscaux peu parlants |
| Foncier actes / promesses | Statut acte / promesse | Couplé à l’état parcelle (#1213) |
| Mes tâches | Importance / mode validation | Codes internes affichés |

## DÉPLOIEMENT-TEST

```
git pull origin main
php artisan view:clear
php artisan journal:sync
```

Pas de migrate. Vérifier « ? » sur État (3 modes), survol + clic, mobile.

## LEÇON

Pas de composant d’aide colonne réutilisable avant #1215 — `v-tooltip` insuffisant
pour un texte long structuré ; un petit `HelpHint` générique évite les popovers
ad hoc. Séparer le contenu CDC (slot) du mécanisme UI.