ASPIC/journal/ASPIC - Documentation utilisateur.md

# ASPIC — Documentation utilisateur

*Application de Suivi des Prospects et Ingénierie Commerciale*

Ce document explique comment utiliser ASPIC au quotidien, écran par écran. Il est écrit pour l'utilisateur de l'application, pas pour un développeur — pour les détails techniques (choix d'architecture, code, structure de la base de données), voir le "Journal de développement ASPIC", document séparé dans ce même projet.

Ce premier jet couvre les deux écrans construits à ce jour (identification et liste des contacts). Il sera complété au fur et à mesure que de nouveaux écrans seront ajoutés à l'application.

## 1. Se connecter à ASPIC

Au lancement de l'application, l'écran d'identification s'affiche. Il comporte deux champs :

- **Identifiant** : votre code utilisateur.
- **Mot de passe** : un clic sur l'icône en forme d'œil, à droite du champ, permet d'afficher ou de masquer temporairement le mot de passe saisi, pour vérifier qu'il est correct avant de valider.

Un clic sur **Valider** (ou la touche Entrée) tente la connexion.

**En cas d'erreur :** un message s'affiche en rouge par-dessus le formulaire. ASPIC vous laisse trois tentatives :

- 1ʳᵉ tentative incorrecte : *"Utilisateur ou mot de passe incorrect. Il vous reste 2 essais"*.
- 2ᵉ tentative incorrecte : *"Utilisateur ou mot de passe incorrect. Dernier essai"*.
- 3ᵉ tentative incorrecte : l'application se ferme, sans message supplémentaire.

Pour fermer ce message d'erreur sans quitter l'application et corriger votre saisie, appuyez sur **Échap**.

**Quitter l'application** : la touche **Échap**, utilisée à tout autre moment sur cet écran (aucun message d'erreur affiché), ferme directement l'application.

Une fois l'identification réussie, vous êtes automatiquement redirigé vers l'écran "Liste des contacts".

## 2. La liste des contacts

C'est l'écran d'accueil de l'application une fois connecté : un tableau présentant tous vos contacts actifs, avec sept colonnes — Nom, Prénom, Département, Ville, Téléphone, Portable, Mail.

### Se repérer dans la liste

La barre en bas de l'écran indique en permanence : le nombre de contacts actuellement affichés sur le nombre total de contacts actifs, le tri en cours, et le filtre actif s'il y en a un.

### Trier la liste

Un clic sur l'en-tête **Nom** ou **Ville** trie la liste sur cette colonne ; un nouveau clic inverse le sens (croissant/décroissant). Les deux petites flèches à côté du titre de colonne indiquent le sens de tri actuellement sélectionné, et peuvent aussi être cliquées directement.

### Se déplacer et sélectionner un contact

- Un clic sur une ligne la sélectionne (encadré vert).
- Les flèches **haut/bas** du clavier déplacent la sélection ligne par ligne.
- **Page précédente / Page suivante** font défiler la liste par blocs.
- La touche **Entrée**, une fois un contact sélectionné, ouvre son détail *(écran à venir — pour l'instant un message temporaire s'affiche à la place)*.

### Actions sur un contact : le menu contextuel

Un **clic droit** sur une ligne sélectionne d'abord cette ligne, puis ouvre un petit menu avec deux actions : *Ajouter un nouveau contact* et *Afficher le détail de ce contact*.

Un **double clic droit** rapide sur la même ligne ouvre directement le détail du contact, sans passer par le menu.

### Filtrer la liste

L'icône en forme d'entonnoir, dans le bandeau du haut, ouvre le panneau de filtre. Vous pouvez filtrer sur n'importe laquelle des sept colonnes affichées (Nom, Prénom, Département, Ville, Tél, Portable, Mail), en combinant plusieurs filtres à la fois si besoin.

**Recherche par préfixe :** en terminant une valeur de filtre par une étoile (`*`), ASPIC recherche tous les contacts dont le champ *commence par* le texte saisi. Par exemple, `FOUR*` sur le champ Nom retrouve "Fournier", "Fourneau", etc. Sans étoile, la recherche cherche une correspondance exacte (la casse — majuscules/minuscules — n'a pas d'importance).

La case à cocher **Supprimer les filtres**, en haut du panneau, vide et désactive tous les champs de filtre en une seule action.

Une fois les filtres saisis, le bouton **Appliquer** met à jour la liste ; **Réinitialiser** efface la saisie du formulaire sans quitter le panneau. L'icône entonnoir se met en surbrillance dès qu'un filtre est actif, pour le rappeler visuellement même une fois le panneau refermé.

### Le menu principal

L'icône en forme de menu ("hamburger"), en haut à gauche, ouvre un menu avec les grandes sections de l'application. À ce stade, seule *Gestion des contacts* (cet écran) est active ; *Gestion des actions* et *Documentation* apparaissent grisées, en attente de leur développement.

### Fermer un panneau ouvert

Quel que soit le panneau actuellement ouvert (menu contextuel, menu principal, ou panneau de filtre), la touche **Échap** le referme. Si aucun panneau n'est ouvert, Échap n'a pas d'effet sur cet écran.

## À venir

- **Écran de détail du contact** : consultation et modification des informations d'un contact, et de l'historique de ses réalisations (actions menées auprès de lui — appels, échanges, prospections… — chacune pouvant porter son propre commentaire).
- Les données affichées correspondent à vos contacts actifs uniquement ; un contact supprimé n'est pas détruit mais simplement retiré de cette liste (récupérable en cas de besoin, fonctionnalité à venir).