Aller au contenu

Proposition RetroGame en version Hexagonale

architecture hexagonale

Fonctionnalités conservées et implémentation :

Le projet de correction de cette architecture peut être lancé avec les commandes suivantes :

docker compose up -d
mvn clean verify
java -jar .\retrogame-bootstrap\target\retrogame-bootstrap-1.0.0.jar

La page d’accueil sera accessible sur http://localhost:8080/, avec PostgreSQL exposé sur le port Windows 5433 (si docker utilisé). Dans Eclipse ou Intellij, importez la racine du projet avec Maven puis Existing Maven Projects : les 4 modules seront détectés.

RetroGame — architecture hexagonale complète

Projet complet zip en version hexagonale à télécharger

Première lecture

Modules Maven

Module Dépendances autorisées Responsabilité
retrogame-domain JDK seul Joueur, Jeu, Score, Points, ErreurScore
retrogame-application Domain + Vavr Ports IN/OUT, cas d’usage ScoreApplicationService et ImportationApplicationService
retrogame-infrastructure Application + Spring Data JPA / Batch Adaptateurs PostgreSQL et CSV, journalisation
retrogame-bootstrap Infrastructure + Spring Boot Web / Thymeleaf API REST, formulaire HTML, configuration, assemblage

Attention : les noms du modèle métier (Score, Joueur, Jeu) sont distincts des noms techniques (ScoreJpaEntity, etc.). Aucun import org.springframework ou jakarta.persistence ne doit apparaître dans domain ou application.

Démarrage Windows / Eclipse

Prérequis : Java 17, Maven 3.9+, Docker Desktop.

Depuis la racine du projet :

docker compose up -d
docker compose ps
mvn clean verify
java -jar .\retrogame-bootstrap\target\retrogame-bootstrap-1.0.0.jar

Ouvrir : http://localhost:8080/.

Dans Eclipse : File > Import > Maven > Existing Maven Projects puis sélectionner la racine contenant le POM parent ; importer les 5 POMs (parent + 4 modules). Lancer DemarrageRetroGame dans le module retrogame-bootstrap.

Le port PostgreSQL publié sur Windows est 5433 pour éviter le conflit 5432 constaté lors du TP. L’application utilise 127.0.0.1:5433, base/utilisateur/mot de passe retrogame.

Routes disponibles

GET  /
POST /importer
GET  /api/scores
GET  /api/scores?jeu=PAC
POST /api/scores
POST /api/batch/importer

Exemple PowerShell d’appel REST

$body = @{pseudo='Alice';codeJeu='PAC';points=1234;datePartie='2026-10-10'} | ConvertTo-Json
Invoke-RestMethod -Uri 'http://localhost:8080/api/scores' -Method Post -ContentType 'application/json' -Body $body
Invoke-RestMethod -Uri 'http://localhost:8080/api/batch/importer' -Method Post

Batch et anomalies

CSV embarqué : retrogame-bootstrap/src/main/resources/data/scores.csv ; une copie modifiable se trouve à la racine dans data/scores.csv.

Le premier fonctionne depuis Eclipse ou le JAR quel que soit le répertoire courant. Pour importer la copie modifiable depuis la racine :

$env:RETROGAME_CSV = 'file:./data/scores.csv'
java -jar .\retrogame-bootstrap\target\retrogame-bootstrap-1.0.0.jar

Pour une exécution dans Eclipse, vérifiez son Working Directory avant d’utiliser file:./data/scores.csv.

Chaque import génère :

logs/batch/import-{ID}/
  anomalies.csv    # erreurs de lecture, filtrage et rejets métier
  bilan.txt        # compteurs de Spring Batch et compteurs métier

Les données contiennent des scores négatifs, dates futures, codes de jeux inconnus, doublons, dates mal formées, points non numériques, mauvaises cardinalités CSV.

Ne pas confondre WRITE_COUNT avec les insertions. Le bilan expose importees et rejetsMetier séparément.

Réutiliser une base RetroGame précédente (de la correction MVC)

Le schéma conserve jeux(code,nom,genre), joueurs(pseudo), scores(id,pseudo,code_jeu,points,date_partie) et uk_partie.

Le nouveau docker-compose.yml utilise volontairement un nouveau volume nommé : il ne modifie donc pas automatiquement la base de l’ancien projet MVC. Si tu souhaites utiliser l’ancienne base, le port et le volume ciblés doivent être corrects. Il faut éviter de lancer les 2 applications sur le même port HTTP 8080.

Initialisation Spring Batch : le projet utilise un schéma PostgreSQL idempotent (retrogame-bootstrap/src/main/resources/db/schema-batch-postgresql.sql) avec CREATE TABLE/SEQUENCE IF NOT EXISTS.

Il est déclenché avec spring.batch.jdbc.initialize-schema: always, y compris lors d’un redémarrage.

Une base issue de Spring Batch 4 (schéma différent) nécessite une vraie migration. Ce script n’effectue pas de conversion de version.

Tests

mvn test
mvn -pl retrogame-bootstrap -am test

Le projet privilégie une architecture démonstrative complète et conserve les contrats HTTP/SQL du MVC source.

Il n’inclut pas de gestion d’authentification, de migrations Flyway, de reprise transactionnelle avancée ni de supervision de production, ça prendrait trop de temps !