#3 update doc openapi + #10 custom configDataset

Author: bfoujols

app/Command/InitCommand.php

@@ -14,6 +14,7 @@ public function execute(InputInterface $input, OutputInterface $output): int
 
             (new \Controller\api\InitApi())->getStructure();
             (new \Controller\api\InitApi())->getData();
+            (new \Controller\api\InitApi())->copyConfig();
 
 		    return Command::SUCCESS;
 	}

app/Controller/api/InitApi.php

@@ -75,4 +75,14 @@ public function getData(): array
             "message" => "API VELIKO is running"
         ];
     }
+
+    public function copyConfig(): array
+    {
+        copy(__DIR__ . '/../../docker/configDataset.json', __DIR__ . '/../../var/configDataset.json');
+
+        return [
+            "status" => "success",
+            "message" => "API VELIKO is running"
+        ];
+    }
 }

app/Controller/api/InitController.php

@@ -10,9 +10,10 @@ class InitController implements ControllerInterface
 {
     #[Attributes\Get(
         path: '/api/init/data',
-        operationId: 'initApiData',
-        summary: 'initApiData',
-        description: 'Initialisation de l\'API VELIKO se fait au dédut projet. Elle permet de récupérer les données des stations et des status des stations sur API officielle de VELIB',
+        tags: ['Initialisation'],
+        operationId: 'InitData',
+        summary: 'init-data',
+        description: 'Vous pouvez initialisation de l\'API VELIKO. Elle permet de récupérer les données des stations et des status des stations sur API officielle de VELIB',
     )]
     #[Attributes\Response(
         response: '200',
@@ -53,6 +54,7 @@ public function execute(Request $request): string|null
         header('Content-Type: application/json');
 
         try {
+            (new \Controller\api\InitApi())->copyConfig();
             $listTest = (new \Controller\api\InitApi())->getData();
         } catch (\Exception $e) {
             http_response_code(500);

app/Controller/api/SchemaController.php

@@ -10,9 +10,10 @@ class SchemaController implements ControllerInterface
 {
     #[Attributes\Get(
         path: '/api/init/schema',
-        operationId: 'initApiSchema',
-        summary: 'initApiSchema',
-        description: 'Initialisation de la scruture de la base de données de l\'API VELIKO se fait au dédut projet. Elle permet de créer les tables de la base de données',
+        tags: ['Initialisation'],
+        operationId: 'InitSchema',
+        summary: 'init-schema',
+        description: 'Vous pouvez initialisation de la scruture de la base de données de l\'API VELIKO. Elle permet de créer les tables de la base de données en cas de reset',
     )]
     #[Attributes\Response(
         response: '200',

app/Controller/api/Station/StationIdController.php

@@ -10,6 +10,7 @@ class StationIdController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/station/{id}',
+        tags: ['station'],
         operationId: 'getStationById',
         description: 'Récupérer les informations d une station par son ID (station_id)<br>
         La description des champs:<br>

app/Controller/api/Station/StationStatusIdController.php

@@ -11,6 +11,7 @@ class StationStatusIdController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/station/{id}/status[/{optional}]',
+        tags: ['station'],
         operationId: 'getStationStatusById',
         description: 'Récupérer le status d une station par son ID (station_id)<br>
         Statut d une station dans son état actuel, celle-ci à une timestamp de dernière mise à jour (last_reported).<br>

app/Controller/api/Station/StationsController.php

@@ -10,6 +10,7 @@ class StationsController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/stations',
+        tags: ['station'],
         operationId: 'getStations',
         description: 'Récupérer une liste des informations des stations<br>
         La description des champs:<br>

app/Controller/api/Status/StationsStatusController.php

@@ -10,6 +10,7 @@ class StationsStatusController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/stations/status',
+        tags: ['status', 'station'],
         operationId: 'getStationsStatus',
         summary: 'getStationsStatus',
         description: 'Liste des status des stations, voici la structure de données

app/Controller/api/Velo/VeloByIdController.php

@@ -10,6 +10,7 @@ class VeloByIdController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/velo/{id}',
+        tags: ['velo'],
         operationId: 'getVeloById',
         summary: 'getVeloById',
         description: 'Information du vélos, voici la structure de données

app/Controller/api/Velo/VeloController.php

@@ -10,6 +10,7 @@ class VeloController implements ControllerInterface
 {
 	#[Attributes\Get(
         path: '/api/velos',
+        tags: ['velo'],
         operationId: 'getVelos',
         summary: 'getVelos',
         description: 'Liste des vélos, voici la structure de données