Evaluation Spring Boot : Gestion d’une Animalerie

Compétences

• Connaissance du framework Spring Boot
• Respect du modèle MVC
• Composants métiers (services)
• Composants d’accès aux données (entités, repository, orm/relationnel)
• Mise en place manuel des DTO sur les 2 classes (puis on verra avec MapStruct par la suite)
• Tests unitaires (optionnel)
• Documentation Java (JavaDoc)

Contexte et Objectifs

Ce projet vise à développer une application simple en Spring Boot pour gérer une animalerie. L’application doit permettra de gérer des espèces et des animaux.

Fonctionnalités attendues

• Gestion des espèces : Ajout, modification, suppression, et liste des espèces (CRUD).
• Gestion des animaux : Ajout, suppression, et liste des animaux par espèce (CRUD).
• Utilisation de DTOs pour séparer la logique métier de la représentation des données (avec ou sans MapStruct).
• Tests unitaires sur une des entités (au choix, une ou plusieurs méthodes d’un Service ou Repository)
• Intégration de Swagger pour documenter et tester les API (dans le pom.xml)
• Connexion à une base de données MySQL (ou PostgreSQL) en local ou via Docker.
• Mise en place de Swagger conseillé pour tester les endpoints de vos contrôleurs.

Structure du Projet (à respecter)

Vous devez créer les packages et les classes indispensables pour respecter le modèle MVC. Une seule classe ServiceAnimal suffit.

Détail pour la mise en place du projet

Une Espèce doit avoir un identifiant numérique auto-généré, un intitulé (nom), une description au format texte, une durée de vie et peut être associée à plusieurs Animaux.

Un Animal doit avoir un identifiant numérique auto-généré, un nom, un âge, une couleur qui peut ne pas avoir de valeur et un animal ne peut appartenir qu’à une seule Espèce.

Il n’y a pas d’informations sensibles à gérer mais l’utilisation des DTO est recommandé avec 2 méthodes respectant le standard de nommage :

• toDto(…) : pour retourner un objet DTO depuis une Entity.
• toEntity(…) : pour retourner un objet Entity depuis un DTO.

Il n’y a que 2 classes pour les DTO que vous pouvez faire en record ou class. Du coup, vous pouvez ajouter une donnée comme un attribut de String nommé problèmes que l’on a dans l’entité mais que l’on ne souhaite pas retourner au front dans le JSON !

Exemples de données possibles

• Quelques espèces :
  • Chien : Mammifère domestique connu pour sa fidélité, espérence de vie environ 15 ans
  • Chat : Félin domestique très indépendant et affectueux, 18 ans d’espérance de vie
  • Perroquet : Oiseau exotique connu pour imiter les sons, les voix, environ 35 ans d’espérance de vie
  • Lapin : Mammifère herbivore souvent élevé comme animal de compagnie avec une espérance de vie d’environ 7 ou 8 ans

Pour les animaux, ce que vous voulez…