feat(directory) : migrate Client into Directory module (back)

LST-58 (2.4), part 1/2 — Client move. Prospect + repertoire front are pending
the product spec and will be added on this branch afterward.

- Client entity moved to src/Module/Directory/Domain/Entity; repository split
  into Domain/Repository/ClientRepositoryInterface + Doctrine impl (bound in
  services.yaml). 5 client MCP tools moved to Infrastructure/Mcp/Tool, now
  injecting the interface.
- resolve_target_entities ClientInterface repointed to Directory\Client;
  Directory mapping added; DirectoryModule registered (id directory, 2 RBAC
  perms). Client.projects relation now uses ProjectInterface -> Directory no
  longer depends on ProjectManagement.
- ProjectManagement Create/UpdateProjectTool inject Directory's
  ClientRepositoryInterface; Serializer and fixtures repointed.
- Garde-fous: #[Auditable] + Timestampable/Blamable on Client (additive
  migration: created_at/updated_at + created_by/updated_by FK ON DELETE SET
  NULL + COMMENT).

161 tests green, mapping valid, no API route regression, cs-fixer clean.

src/DataFixtures/AppFixtures.php

@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\DataFixtures;
 
-use App\Entity\Client;
 use App\Entity\MailConfiguration;
 use App\Entity\ZimbraConfiguration;
 use App\Enum\ContractType;
@@ -15,6 +14,7 @@ use App\Module\Absence\Domain\Enum\AbsenceStatus;
 use App\Module\Absence\Domain\Enum\AbsenceType;
 use App\Module\Core\Application\Rbac\RbacSeeder;
 use App\Module\Core\Domain\Entity\User;
+use App\Module\Directory\Domain\Entity\Client;
 use App\Module\ProjectManagement\Domain\Entity\Project;
 use App\Module\ProjectManagement\Domain\Entity\Task;
 use App\Module\ProjectManagement\Domain\Entity\TaskEffort;

src/Mcp/Tool/Serializer.php

@@ -4,11 +4,11 @@ declare(strict_types=1);
 
 namespace App\Mcp\Tool;
 
-use App\Entity\Client;
 use App\Module\Absence\Domain\Entity\AbsenceBalance;
 use App\Module\Absence\Domain\Entity\AbsencePolicy;
 use App\Module\Absence\Domain\Entity\AbsenceRequest;
 use App\Module\Core\Domain\Entity\User;
+use App\Module\Directory\Domain\Entity\Client;
 use App\Module\ProjectManagement\Domain\Entity\Project;
 use App\Module\ProjectManagement\Domain\Entity\Task;
 use App\Module\ProjectManagement\Domain\Entity\TaskDocument;

src/Module/Directory/DirectoryModule.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Directory;
+
+use App\Shared\Domain\Module\ModuleInterface;
+
+final class DirectoryModule implements ModuleInterface
+{
+    public static function id(): string
+    {
+        return 'directory';
+    }
+
+    public static function label(): string
+    {
+        return 'Répertoire';
+    }
+
+    public static function isRequired(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Permissions RBAC fin du Module Directory.
+     *
+     * Additif : alimente le catalogue RBAC. La sécurité des opérations API
+     * reste en ROLE_USER/ROLE_ADMIN (non recâblée ici).
+     *
+     * @return list<array{code: string, label: string}>
+     */
+    public static function permissions(): array
+    {
+        return [
+            ['code' => 'directory.clients.view', 'label' => 'Voir les clients'],
+            ['code' => 'directory.clients.manage', 'label' => 'Gérer les clients'],
+        ];
+    }
+}

src/Module/Directory/Domain/Entity/Client.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Entity;
+namespace App\Module\Directory\Domain\Entity;
 
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Delete;
@@ -10,14 +10,19 @@ use ApiPlatform\Metadata\Get;
 use ApiPlatform\Metadata\GetCollection;
 use ApiPlatform\Metadata\Patch;
 use ApiPlatform\Metadata\Post;
-use App\Module\ProjectManagement\Domain\Entity\Project;
-use App\Repository\ClientRepository;
+use App\Module\Directory\Infrastructure\Doctrine\DoctrineClientRepository;
+use App\Shared\Domain\Attribute\Auditable;
+use App\Shared\Domain\Contract\BlamableInterface;
 use App\Shared\Domain\Contract\ClientInterface;
+use App\Shared\Domain\Contract\ProjectInterface;
+use App\Shared\Domain\Contract\TimestampableInterface;
+use App\Shared\Domain\Trait\TimestampableBlamableTrait;
 use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\Common\Collections\Collection;
 use Doctrine\ORM\Mapping as ORM;
 use Symfony\Component\Serializer\Attribute\Groups;
 
+#[Auditable]
 #[ApiResource(
     operations: [
         new GetCollection(paginationEnabled: false, security: "is_granted('ROLE_USER')"),
@@ -30,9 +35,11 @@ use Symfony\Component\Serializer\Attribute\Groups;
     denormalizationContext: ['groups' => ['client:write']],
     order: ['name' => 'ASC'],
 )]
-#[ORM\Entity(repositoryClass: ClientRepository::class)]
-class Client implements ClientInterface
+#[ORM\Entity(repositoryClass: DoctrineClientRepository::class)]
+class Client implements ClientInterface, TimestampableInterface, BlamableInterface
 {
+    use TimestampableBlamableTrait;
+
     #[ORM\Id]
     #[ORM\GeneratedValue]
     #[ORM\Column]
@@ -63,8 +70,8 @@ class Client implements ClientInterface
     #[Groups(['client:read', 'client:write'])]
     private ?string $postalCode = null;
 
-    /** @var Collection<int, Project> */
-    #[ORM\OneToMany(targetEntity: Project::class, mappedBy: 'client')]
+    /** @var Collection<int, ProjectInterface> */
+    #[ORM\OneToMany(targetEntity: ProjectInterface::class, mappedBy: 'client')]
     private Collection $projects;
 
     public function __construct()
@@ -149,7 +156,7 @@ class Client implements ClientInterface
         return $this;
     }
 
-    /** @return Collection<int, Project> */
+    /** @return Collection<int, ProjectInterface> */
     public function getProjects(): Collection
     {
         return $this->projects;

src/Module/Directory/Domain/Repository/ClientRepositoryInterface.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Directory\Domain\Repository;
+
+use App\Module\Directory\Domain\Entity\Client;
+
+interface ClientRepositoryInterface
+{
+    public function findById(int $id): ?Client;
+
+    /**
+     * @param array<string, mixed>       $criteria
+     * @param null|array<string, string> $orderBy
+     *
+     * @return Client[]
+     */
+    public function findBy(array $criteria, ?array $orderBy = null, ?int $limit = null, ?int $offset = null): array;
+}

src/Module/Directory/Infrastructure/Doctrine/DoctrineClientRepository.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Directory\Infrastructure\Doctrine;
+
+use App\Module\Directory\Domain\Entity\Client;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+/**
+ * @extends ServiceEntityRepository<Client>
+ */
+final class DoctrineClientRepository extends ServiceEntityRepository implements ClientRepositoryInterface
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, Client::class);
+    }
+
+    public function findById(int $id): ?Client
+    {
+        return $this->find($id);
+    }
+}

src/Module/Directory/Infrastructure/Mcp/Tool/CreateClientTool.php

@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Mcp\Tool\Reference;
+namespace App\Module\Directory\Infrastructure\Mcp\Tool;
 
-use App\Entity\Client;
 use App\Mcp\Tool\Serializer;
+use App\Module\Directory\Domain\Entity\Client;
 use Doctrine\ORM\EntityManagerInterface;
 use Mcp\Capability\Attribute\McpTool;
 use Symfony\Bundle\SecurityBundle\Security;

src/Module/Directory/Infrastructure/Mcp/Tool/DeleteClientTool.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace App\Mcp\Tool\Reference;
+namespace App\Module\Directory\Infrastructure\Mcp\Tool;
 
-use App\Repository\ClientRepository;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use Doctrine\ORM\EntityManagerInterface;
 use InvalidArgumentException;
 use Mcp\Capability\Attribute\McpTool;
@@ -17,7 +17,7 @@ use function sprintf;
 class DeleteClientTool
 {
     public function __construct(
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly EntityManagerInterface $entityManager,
         private readonly Security $security,
     ) {}
@@ -28,7 +28,7 @@ class DeleteClientTool
             throw new AccessDeniedException('Access denied: ROLE_ADMIN required.');
         }
 
-        $client = $this->clientRepository->find($id);
+        $client = $this->clientRepository->findById($id);
         if (null === $client) {
             throw new InvalidArgumentException(sprintf('Client with ID %d not found.', $id));
         }

src/Module/Directory/Infrastructure/Mcp/Tool/GetClientTool.php

@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Mcp\Tool\Reference;
+namespace App\Module\Directory\Infrastructure\Mcp\Tool;
 
 use App\Mcp\Tool\Serializer;
-use App\Repository\ClientRepository;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use InvalidArgumentException;
 use Mcp\Capability\Attribute\McpTool;
 use Symfony\Bundle\SecurityBundle\Security;
@@ -17,7 +17,7 @@ use function sprintf;
 class GetClientTool
 {
     public function __construct(
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly Security $security,
     ) {}
 
@@ -27,7 +27,7 @@ class GetClientTool
             throw new AccessDeniedException('Access denied: ROLE_ADMIN required.');
         }
 
-        $client = $this->clientRepository->find($id);
+        $client = $this->clientRepository->findById($id);
         if (null === $client) {
             throw new InvalidArgumentException(sprintf('Client with ID %d not found.', $id));
         }

src/Module/Directory/Infrastructure/Mcp/Tool/ListClientsTool.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace App\Mcp\Tool\Reference;
+namespace App\Module\Directory\Infrastructure\Mcp\Tool;
 
-use App\Repository\ClientRepository;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use Mcp\Capability\Attribute\McpTool;
 use Symfony\Bundle\SecurityBundle\Security;
 use Symfony\Component\Security\Core\Exception\AccessDeniedException;
@@ -13,7 +13,7 @@ use Symfony\Component\Security\Core\Exception\AccessDeniedException;
 class ListClientsTool
 {
     public function __construct(
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly Security $security,
     ) {}
 

src/Module/Directory/Infrastructure/Mcp/Tool/UpdateClientTool.php

@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Mcp\Tool\Reference;
+namespace App\Module\Directory\Infrastructure\Mcp\Tool;
 
 use App\Mcp\Tool\Serializer;
-use App\Repository\ClientRepository;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use Doctrine\ORM\EntityManagerInterface;
 use InvalidArgumentException;
 use Mcp\Capability\Attribute\McpTool;
@@ -18,7 +18,7 @@ use function sprintf;
 class UpdateClientTool
 {
     public function __construct(
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly EntityManagerInterface $entityManager,
         private readonly Security $security,
     ) {}
@@ -36,7 +36,7 @@ class UpdateClientTool
             throw new AccessDeniedException('Access denied: ROLE_ADMIN required.');
         }
 
-        $client = $this->clientRepository->find($id);
+        $client = $this->clientRepository->findById($id);
         if (null === $client) {
             throw new InvalidArgumentException(sprintf('Client with ID %d not found.', $id));
         }

src/Module/ProjectManagement/Infrastructure/Mcp/Tool/Project/CreateProjectTool.php

@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Module\ProjectManagement\Infrastructure\Mcp\Tool\Project;
 
 use App\Mcp\Tool\Serializer;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use App\Module\ProjectManagement\Domain\Entity\Project;
-use App\Repository\ClientRepository;
 use Doctrine\ORM\EntityManagerInterface;
 use InvalidArgumentException;
 use Mcp\Capability\Attribute\McpTool;
@@ -20,7 +20,7 @@ class CreateProjectTool
 {
     public function __construct(
         private readonly EntityManagerInterface $entityManager,
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly Security $security,
     ) {}
 
@@ -46,7 +46,7 @@ class CreateProjectTool
             $project->setColor($color);
         }
         if (null !== $clientId) {
-            $client = $this->clientRepository->find($clientId);
+            $client = $this->clientRepository->findById($clientId);
             if (null === $client) {
                 throw new InvalidArgumentException(sprintf('Client with ID %d not found.', $clientId));
             }

src/Module/ProjectManagement/Infrastructure/Mcp/Tool/Project/UpdateProjectTool.php

@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Module\ProjectManagement\Infrastructure\Mcp\Tool\Project;
 
 use App\Mcp\Tool\Serializer;
+use App\Module\Directory\Domain\Repository\ClientRepositoryInterface;
 use App\Module\ProjectManagement\Domain\Repository\ProjectRepositoryInterface;
-use App\Repository\ClientRepository;
 use Doctrine\ORM\EntityManagerInterface;
 use InvalidArgumentException;
 use Mcp\Capability\Attribute\McpTool;
@@ -20,7 +20,7 @@ class UpdateProjectTool
 {
     public function __construct(
         private readonly ProjectRepositoryInterface $projectRepository,
-        private readonly ClientRepository $clientRepository,
+        private readonly ClientRepositoryInterface $clientRepository,
         private readonly EntityManagerInterface $entityManager,
         private readonly Security $security,
     ) {}
@@ -57,7 +57,7 @@ class UpdateProjectTool
             $project->setColor($color);
         }
         if (null !== $clientId) {
-            $client = $this->clientRepository->find($clientId);
+            $client = $this->clientRepository->findById($clientId);
             if (null === $client) {
                 throw new InvalidArgumentException(sprintf('Client with ID %d not found.', $clientId));
             }

src/Repository/ClientRepository.php

@@ -1,17 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Repository;
-
-use App\Entity\Client;
-use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
-use Doctrine\Persistence\ManagerRegistry;
-
-class ClientRepository extends ServiceEntityRepository
-{
-    public function __construct(ManagerRegistry $registry)
-    {
-        parent::__construct($registry, Client::class);
-    }
-}