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.
Projet complet zip en version hexagonale à télécharger
docs/AUDIT_PROJET_ET_DIAGRAMMES.md
docs/ARCHITECTURE_HEXAGONALE.md
docs/diagrammes/architecture-hexagonale.svg
docs/diagrammes/mcd.svg
mld.svg
classes-jpa.svg
retrogame-domain
retrogame-application
ScoreApplicationService
ImportationApplicationService
retrogame-infrastructure
retrogame-bootstrap
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.
Score
Joueur
Jeu
ScoreJpaEntity
org.springframework
jakarta.persistence
domain
application
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/.
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.
File > Import > Maven > Existing Maven Projects
DemarrageRetroGame
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.
127.0.0.1:5433
retrogame
GET / POST /importer GET /api/scores GET /api/scores?jeu=PAC POST /api/scores POST /api/batch/importer
$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
CSV embarqué : retrogame-bootstrap/src/main/resources/data/scores.csv ; une copie modifiable se trouve à la racine dans data/scores.csv.
retrogame-bootstrap/src/main/resources/data/scores.csv
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.
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.
WRITE_COUNT
importees
rejetsMetier
Le schéma conserve jeux(code,nom,genre), joueurs(pseudo), scores(id,pseudo,code_jeu,points,date_partie) et uk_partie.
jeux(code,nom,genre)
joueurs(pseudo)
scores(id,pseudo,code_jeu,points,date_partie)
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.
docker-compose.yml
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.
retrogame-bootstrap/src/main/resources/db/schema-batch-postgresql.sql
CREATE TABLE/SEQUENCE IF NOT EXISTS
Il est déclenché avec spring.batch.jdbc.initialize-schema: always, y compris lors d’un redémarrage.
spring.batch.jdbc.initialize-schema: always
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.
mvn test mvn -pl retrogame-bootstrap -am test
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 !