Interface utilisateur Swagger + Docker : configuration initiale

L'environnement est constitué d'un Mac avec un processeur Apple M1 exécutant le système d'exploitation Sonoma 14.6.1 et Docker Desktop en version 4.34.2. La structure de répertoire comporte trois sous-répertoires : top, docker et openapi. Le sous-répertoire docker contient un fichier .env et un fichier docker-compose.yml, tandis que le sous-répertoire openapi contient un fichier openapi.yml. Le fichier .env définit la variable d'environnement SWAGGER_UI_HOST_PORT. Le fichier docker-compose.yml définit un service appelé swagger-ui, qui utilise l'image officielle swaggerapi/swagger-ui:v5.17.14. La variable d'environnement SWAGGER_JSON est définie sur le chemin absolu du fichier openapi.yml, qui est monté en tant que volume à l'intérieur du conteneur Docker. Le conteneur expose le port 8080, et le fichier openapi.yml définit une documentation d'API minimale conforme à OAS 3.0.3. Pour créer le conteneur et l'image, l'utilisateur doit exécuter la commande docker compose create dans le terminal, puis démarrer le conteneur avec docker compose start. Enfin, l'utilisateur peut accéder à Swagger UI en ouvrant http://localhost:{SWAGGER_UI_HOST_PORT} dans son navigateur.