Gestion d'incidents - Production finale

Application desktop de gestion d'incidents informatiques. Elle permet de déclarer, consulter, modifier et suivre des tickets, avec une persistance réelle en base de données.

Ce projet est l'intégration des composants de trois groupes : la logique métier (Groupe 1), l'interface JavaFX (Groupe 2) et la base de données MySQL (Groupe 4).

Prérequis

• JDK 21 : version cible. Sur un JDK plus récent, l'application fonctionne mais la console affiche des avertissements de compatibilité sans gravité.
• Docker Desktop (pour la base MySQL).
• Maven n'est pas nécessaire : le wrapper mvnw est fourni.

Lancement

Sur macOS, si plusieurs JDK sont installés, activer le JDK 21 dans le terminal courant avant de lancer (console propre) : export JAVA_HOME=$(/usr/libexec/java_home -v 21)

1. Démarrer la base

docker compose up -d

Au premier lancement, la base gestion_incidents est créée et remplie de données de démonstration. Vérifier qu'elle est prête avec docker compose ps (le service doit être healthy).

2. Démarrer l'application

./mvnw javafx:run

La fenêtre s'ouvre sur la liste des tickets. Si la base n'est pas démarrée, l'application affiche un message clair invitant à lancer Docker.

Utilisation

L'application est organisée autour d'une fenêtre unique avec une barre latérale (Tous les tickets / Nouveau ticket) et une zone centrale qui affiche l'écran courant.

Consulter les tickets

L'écran d'accueil liste les tickets sous forme de cartes : titre, badges de statut et de priorité, extrait de la description, date de création. En haut, un compteur indique le nombre de tickets.

• Rechercher : la barre de recherche filtre en direct sur le titre et la description.
• Filtrer : le menu déroulant restreint l'affichage à un statut (Ouvert, En cours, Résolu, Fermé).

Créer un ticket

1. Cliquer sur Nouveau ticket dans la barre latérale.
2. Renseigner le titre (obligatoire, 100 caractères max), la description (obligatoire, 1000 caractères max), la priorité (Haute / Moyenne / Basse) et la catégorie (Matériel / Logiciel / Réseau / Sécurité).
3. Cliquer sur Créer le ticket.

En cas de saisie invalide, un message d'erreur apparaît sous le champ concerné, sans rien perdre des autres champs. En cas de succès, un message de confirmation s'affiche. Le ticket est créé au statut Ouvert et rattaché à l'utilisateur courant.

Consulter le détail d'un ticket

Cliquer sur une carte ouvre la vue détail : identifiant, titre, description, priorité, statut, date, catégorie et créateur. Deux actions y sont disponibles : Modifier et Supprimer.

Modifier un ticket

Depuis le détail, cliquer sur Modifier. Le formulaire est pré-rempli et expose en plus le champ statut, qui permet de faire évoluer le ticket (par exemple Ouvert vers En cours). Cliquer sur Enregistrer pour valider. Chaque changement de statut est tracé dans l'historique en base.

Supprimer un ticket

Depuis le détail, cliquer sur Supprimer : le ticket est retiré et un message de confirmation s'affiche au retour sur la liste.

Tests

./mvnw test

• Sans base démarrée : 45 tests unitaires passent, les 13 tests d'intégration sont sautés.
• Avec la base démarrée : 58 tests passent (45 unitaires + 13 d'intégration contre MySQL).

Arrêt

docker compose down        # arrête la base, conserve les données
docker compose down -v     # arrête et réinitialise les données de démonstration