refactor(backend) : extract CuidEntityTrait, abstract audit subscriber, merge history controllers

- Extract shared ID generation + timestamps into CuidEntityTrait used by all entities
- Create AbstractAuditSubscriber to deduplicate audit logic across 7 subscribers
- Merge per-entity history controllers into single EntityHistoryController
- Delete redundant ComposantHistory/MachineHistory/PieceHistory/ProductHistoryController
- Add OpenApiDecorator for API documentation customization
- Disable failOnDeprecation in PHPUnit (vendor API Platform deprecation)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/EventSubscriber/ConstructeurAuditSubscriber.php

@@ -4,165 +4,30 @@ declare(strict_types=1);
 
 namespace App\EventSubscriber;
 
-use App\Entity\AuditLog;
 use App\Entity\Constructeur;
-use App\Entity\Profile;
-use DateTimeInterface;
 use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-use Doctrine\Common\EventSubscriber;
-use Doctrine\ORM\EntityManagerInterface;
-use Doctrine\ORM\Event\OnFlushEventArgs;
 use Doctrine\ORM\Events;
-use Symfony\Bundle\SecurityBundle\Security;
-use Symfony\Component\HttpFoundation\RequestStack;
-use Symfony\Component\HttpFoundation\Session\SessionInterface;
-use Throwable;
-
-use function is_scalar;
 
 #[AsDoctrineListener(event: Events::onFlush)]
-final class ConstructeurAuditSubscriber implements EventSubscriber
+final class ConstructeurAuditSubscriber extends AbstractAuditSubscriber
 {
-    public function __construct(
-        private readonly RequestStack $requestStack,
-        private readonly Security $security,
-    ) {}
+    protected function supports(object $entity): bool
+    {
+        return $entity instanceof Constructeur;
+    }
 
-    public function getSubscribedEvents(): array
+    protected function entityType(): string
+    {
+        return 'constructeur';
+    }
+
+    protected function snapshotEntity(object $entity): array
     {
         return [
-            Events::onFlush,
+            'id'    => $entity->getId(),
+            'name'  => $this->safeGet($entity, 'getName'),
+            'email' => $this->safeGet($entity, 'getEmail'),
+            'phone' => $this->safeGet($entity, 'getPhone'),
         ];
     }
-
-    public function onFlush(OnFlushEventArgs $args): void
-    {
-        $em = $args->getObjectManager();
-        if (!$em instanceof EntityManagerInterface) {
-            return;
-        }
-
-        $uow            = $em->getUnitOfWork();
-        $actorProfileId = $this->resolveActorProfileId();
-
-        foreach ($uow->getScheduledEntityInsertions() as $entity) {
-            if (!$entity instanceof Constructeur) {
-                continue;
-            }
-
-            $diff     = $this->buildDiffFromChangeSet($uow->getEntityChangeSet($entity));
-            $snapshot = $this->snapshotConstructeur($entity);
-            $this->persistAuditLog($em, new AuditLog('constructeur', (string) $entity->getId(), 'create', $diff, $snapshot, $actorProfileId));
-        }
-
-        foreach ($uow->getScheduledEntityUpdates() as $entity) {
-            if (!$entity instanceof Constructeur) {
-                continue;
-            }
-
-            $id = (string) $entity->getId();
-            if ('' === $id) {
-                continue;
-            }
-
-            $diff = $this->buildDiffFromChangeSet($uow->getEntityChangeSet($entity));
-            if ([] !== $diff) {
-                $snapshot = $this->snapshotConstructeur($entity);
-                $this->persistAuditLog($em, new AuditLog('constructeur', $id, 'update', $diff, $snapshot, $actorProfileId));
-            }
-        }
-
-        foreach ($uow->getScheduledEntityDeletions() as $entity) {
-            if (!$entity instanceof Constructeur) {
-                continue;
-            }
-
-            $snapshot = $this->snapshotConstructeur($entity);
-            $this->persistAuditLog($em, new AuditLog('constructeur', (string) $entity->getId(), 'delete', null, $snapshot, $actorProfileId));
-        }
-    }
-
-    private function persistAuditLog(EntityManagerInterface $em, AuditLog $log): void
-    {
-        $uow = $em->getUnitOfWork();
-        $log->initializeAuditLog();
-        $em->persist($log);
-
-        $meta = $em->getClassMetadata(AuditLog::class);
-        $uow->computeChangeSet($meta, $log);
-    }
-
-    /**
-     * @param array<string, array{0:mixed, 1:mixed}> $changeSet
-     *
-     * @return array<string, array{from:mixed, to:mixed}>
-     */
-    private function buildDiffFromChangeSet(array $changeSet): array
-    {
-        $diff = [];
-        foreach ($changeSet as $field => [$oldValue, $newValue]) {
-            if ('updatedAt' === $field || 'createdAt' === $field) {
-                continue;
-            }
-
-            $normalizedOld = $this->normalizeValue($oldValue);
-            $normalizedNew = $this->normalizeValue($newValue);
-
-            if ($normalizedOld === $normalizedNew) {
-                continue;
-            }
-
-            $diff[$field] = [
-                'from' => $normalizedOld,
-                'to'   => $normalizedNew,
-            ];
-        }
-
-        return $diff;
-    }
-
-    private function snapshotConstructeur(Constructeur $constructeur): array
-    {
-        return [
-            'id'    => $constructeur->getId(),
-            'name'  => $constructeur->getName(),
-            'email' => $constructeur->getEmail(),
-            'phone' => $constructeur->getPhone(),
-        ];
-    }
-
-    private function normalizeValue(mixed $value): mixed
-    {
-        if (null === $value || is_scalar($value)) {
-            return $value;
-        }
-
-        if ($value instanceof DateTimeInterface) {
-            return $value->format(DateTimeInterface::ATOM);
-        }
-
-        return (string) $value;
-    }
-
-    private function resolveActorProfileId(): ?string
-    {
-        try {
-            $session = $this->requestStack->getSession();
-            if ($session instanceof SessionInterface) {
-                $profileId = $session->get('profileId');
-                if ($profileId) {
-                    return (string) $profileId;
-                }
-            }
-        } catch (Throwable) {
-            // No session available (CLI context, etc.)
-        }
-
-        $user = $this->security->getUser();
-        if ($user instanceof Profile) {
-            return $user->getId();
-        }
-
-        return null;
-    }
 }