update documentation #3424

src/Dto/Api/Response/SignalementResponse.php

@@ -13,6 +13,7 @@
 use App\Entity\Enum\MotifRefus;
 use App\Entity\Enum\ProfileDeclarant;
 use App\Entity\Enum\Qualification;
+use App\Entity\Enum\SignalementNewStatus;
 use Nelmio\ApiDocBundle\Attribute\Model;
 use OpenApi\Attributes as OA;
 
@@ -43,12 +44,18 @@ class SignalementResponse
     )]
     public Adresse $adresse;
     #[OA\Property(
-        description: "Le statut du signalement peut prendre l'une des valeurs suivantes : `en cours` (le signalement est actif), `fermé` (le signalement est terminé), `refusé` (le signalement a été refusé), ou `archivé` (le signalement a été archivé).",
-        type: 'string',
-        enum: ['en cours', 'fermé', 'refusé', 'archivé'],
-        example: 'fermé'
+        description: "Le statut du signalement peut prendre l'une des valeurs suivantes : <br>
+        <ul>
+            <li>`NOUVEAU`</li>
+            <li>`EN_COURS`</li>
+            <li>`FERME`</li>
+            <li>`ARCHIVE`</li>
+            <li>`REFUSE`</li>
+        </ul>
+        .",
+        example: 'FERME'
     )]
-    public string $statut;
+    public SignalementNewStatus $statut;
 
     #[OA\Property(
         description: 'Date à laquelle le signalement a été validé par un responsable territoire.<br>

src/Entity/Enum/AffectationNewStatus.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Entity\Enum;
+
+use App\Entity\Behaviour\EnumTrait;
+
+enum AffectationNewStatus: string
+{
+    use EnumTrait;
+
+    case NOUVEAU = 'NOUVEAU';
+    case EN_COURS = 'EN_COURS';
+    case FERME = 'FERME';
+    case REFUSE = 'REFUSE';
+}

src/Entity/Enum/AffectationStatus.php

@@ -42,4 +42,15 @@ public static function mapFilterStatus(string $label): int
             default => throw new \UnexpectedValueException('Unexpected affectation status : '.$label),
         };
     }
+
+    public static function mapNewStatus(int $codeStatus): string
+    {
+        return match ($codeStatus) {
+            0 => AffectationNewStatus::NOUVEAU->value,
+            1 => AffectationNewStatus::EN_COURS->value,
+            2 => AffectationNewStatus::REFUSE->value,
+            3 => AffectationNewStatus::FERME->value,
+            default => throw new \UnexpectedValueException('Unexpected affectation status : '.$codeStatus),
+        };
+    }
 }

src/Entity/Enum/SignalementNewStatus.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Entity\Enum;
+
+use App\Entity\Behaviour\EnumTrait;
+
+enum SignalementNewStatus: string
+{
+    use EnumTrait;
+
+    case NOUVEAU = 'NOUVEAU';
+    case EN_COURS = 'EN_COURS';
+    case FERME = 'FERME';
+    case ARCHIVE = 'ARCHIVE';
+    case REFUSE = 'REFUSE';
+}

src/Entity/Enum/SignalementStatus.php

@@ -56,4 +56,16 @@ public static function mapFilterStatus(string $label): int
             default => throw new \UnexpectedValueException('Unexpected signalement status : '.$label),
         };
     }
+
+    public static function mapNewStatus(int $codeStatus): SignalementNewStatus
+    {
+        return match ($codeStatus) {
+            1 => SignalementNewStatus::NOUVEAU,
+            2, 3 => SignalementNewStatus::EN_COURS,
+            6 => SignalementNewStatus::FERME,
+            7 => SignalementNewStatus::ARCHIVE,
+            8 => SignalementNewStatus::REFUSE,
+            default => throw new \UnexpectedValueException('Unexpected signalement code status : '.$codeStatus),
+        };
+    }
 }

src/Factory/Api/SignalementResponseFactory.php

@@ -40,7 +40,7 @@ public function createFromSignalement(Signalement $signalement): SignalementResp
         $signalementResponse->uuid = $signalement->getUuid();
         $signalementResponse->reference = $signalement->getReference();
         $signalementResponse->dateCreation = $signalement->getCreatedAt()->format(\DATE_ATOM);
-        $signalementResponse->statut = SignalementStatus::tryFrom($signalement->getStatut())->label();
+        $signalementResponse->statut = SignalementStatus::mapNewStatus($signalement->getStatut());
         $signalementResponse->dateValidation = $signalement->getValidatedAt()?->format(\DATE_ATOM);
         $signalementResponse->dateCloture = $signalement->getClosedAt()?->format(\DATE_ATOM);
         $signalementResponse->motifCloture = $signalement->getMotifCloture();