Aller au contenu

TP RetroGame — Cahier des charges pour Omar

Page de révision des concepts

Cette page reprend les concepts de base avec des liens vers les cours de la formation

La page avant le chargement des données :

page accueil du jeu

Puis la page une fois les données récupérées…

page accueil du jeu

Objectif

Une salle d’arcade souhaite remplacer un traitement historique de résultats par une application Java 17 / Spring Boot avec :

Rappel de l’architecture et du fonctionnement

architecure de l'application

Pour ce projet, tu as la possibilité soit d’intégrer les règles métiers (validations, recherche des entités liées,…) au niveau du processus de récupération des lignes du ou des fichiers CSV en manipulant les Entities, soit mettre en place les règles métiers avec des classes, interfaces et records dans un package domaine.

Durée : 3 jours avec accompagnement.

Livrables attendus

Tu peux aussi réaliser une version simple MVC (controller, service, repository, entity,dto) sans le package domaine, mais ce n’est pas forcément ce qui se fera ultérieurement avec une architecture hexagonale.

Proposition d’un diagramme de classes (UML)

diagrammme de classes UML

Proposition d’un MCD (Merise)

Remarque : dans le diagramme ci-dessous, j’ai mis un smallint pour l’id de Score mais pour Java, il faudrait un Long donc un bigint sur le MCD.

MCD

Proposition d’un MLD (Modèle Logique)

Ce modèle correspond à la structure des futures tables en bases de données.

MLD

Suggestion d’une architecure simple MVC (sans domaine) : Les entités JPA représentent les objets persistants, les DTO transportent les données et les services appliquent les règles métier.

fr.formation.retrogame
├── batch/
│   ├── BatchConfiguration.java
│   ├── LigneScore.java
│   └── ScoreCsvProcessor.java
├── config/
│   └── JeuxInit.java
├── dto/
│   ├── ScoreDemande.java
│   └── ScoreReponse.java
├── entite/
│   ├── JeuEntity.java
│   ├── JoueurEntity.java
│   └── ScoreEntity.java
├── repository/
│   ├── JeuRepository.java
│   ├── JoueurRepository.java
│   └── ScoreRepository.java
├── service/
│   ├── ScoreService.java
│   └── ImportationScoresService.java
└── web/
    ├── BatchController.java
    ├── ScoreController.java
    ├── PageController.java
    ├── ImportationMvcController.java
    └── ErreurController.java
  1. Domaine Java : Jeu, Participant (abstraite), Joueur (héritage), Classable (interface), Score (record), encapsulation, validations, exceptions.
  2. Collections List, Set, Map, Streams filter, map, collect, groupingBy (voir cours si besoin)
  3. JUnit 5 : tests du domaine et des calculs (facultatif si pas le temps)
  4. Spring Boot : 3 couches, entités JPA, relation ManyToOne, PostgreSQL, requêtes JPQL.
  5. DTO validés, REST GET/POST, erreurs HTTP, Vavr Either<String, ScoreReponse>.
  6. Page Thymeleaf accessible listant les scores sous forme d’un tableau.
  7. Spring Batch : Job, Step, FlatFileItemReader, ItemProcessor, ItemWriter, chunks, compteurs et rejets.
  8. MockMvc : tests de l’API. (facultatif si temps insuffisant)
  9. Comparaison MVC et ports/adaptateurs sur le cas d’usage « enregistrer un score » (idem, si on n’a le temps).

Règles métier

Lors du traitement :

Journée 1 — Analyse - Java métier

Dans la partie Domaine,

Journée 2 — Spring Boot

Journée 3 — Batch et architecture

TODO prioritaires

Extensions (facultatifs)

Conclusion

Ce petit projet devrait suffire pour permettre la révision de toutes les notions abordées lors de la formation Java/Spring Boot de cette année.

ZIP du TP du projet MVC à télécharger et à compléter

Corrections