Migration modular monolith DDD (0.1 → 3.3) (#17)

## Migration modular monolith DDD — Lesstime (0.1 → 3.3)

Cette MR regroupe l'intégralité de la refonte en monolithe modulaire (strangler progressif, additif). Elle remplace les MR stackées de Phase 1 (#12–#16), désormais incluses ici.

**Ne pas merger avant validation fonctionnelle** : branche destinée à être testée telle quelle.

### Périmètre — 9 modules sous `src/Module/`
| Phase | Module | Contenu |
|------|--------|---------|
| 0.1 | (socle) | infrastructure modulaire, `ModuleInterface`, mapping Doctrine par module |
| 0.2 | (socle front) | auto-détection des layers Nuxt sous `frontend/modules/*` |
| 1.1 | **Core** | Identité (User/Auth), Notifications, Notifier |
| 1.2 | Core | RBAC fin (permissions `module.resource.action`, sidebar gated) |
| 1.3 | Core | Audit log (`#[Auditable]`, listener, provider DBAL) |
| 2.1 | **TimeTracking** | TimeEntry + MCP + export |
| 2.2 | **ProjectManagement** | cœur métier Projets/Tâches + 38 MCP tools |
| 2.3 | **Absence** | demandes, soldes, policies, justificatifs |
| 2.4 | **Directory** | Clients (migrés) + **Prospects** (nouveau, conversion → Client) |
| 2.5 | **Mail** | intégration IMAP OVH + liens tâches |
| 2.6 | **Integration** | Gitea / BookStack / Zimbra / Share |
| 3.1 | **Reporting** | rapports transverses (DBAL read-only, 0 import inter-module) |
| 3.2 | **ClientPortal** | portail client (ROLE_CLIENT cloisonné, tickets, notifications) |
| 3.3 | (finition) | nettoyage legacy — `src/Entity` vide, app 100% modulaire |

### Architecture
- Découplage inter-modules par **contrats** (`UserInterface`, `ProjectInterface`, `TaskInterface`, `TaskTagInterface`, `ClientInterface`, `ClientTicketInterface`, `LeaveProfileInterface`) + `resolve_target_entities` 100% modulaire (aucune cible legacy).
- Repositories : interface `Domain/Repository` + implémentation `Infrastructure/Doctrine`, bindées.
- Reporting en DBAL read-only pur (aucun import d'entité d'un autre module).
- Chaque migration de module : déplacement à comportement préservé (API publique et noms d'outils MCP inchangés), migrations **additives** uniquement (zéro destructif).

### Sécurité
- ROLE_CLIENT cloisonné : un utilisateur client n'accède qu'à `/portal` et à ses propres tickets (filtrés par `allowedProjects`), interdit sur toute l'API interne.
- Correctif : interdiction pour un client de créer un lien vers le partage SMB (upload uniquement).

### QA non-régression (branche reconstruite from scratch)
- Migrations from scratch + fixtures : OK.
- Compilation dev + prod : OK.
- **180 tests PHPUnit verts**, php-cs-fixer clean, ~96 routes, **66 outils MCP** tous sous `App\Module\*`.
- Smoke test runtime multi-rôles (admin / ROLE_USER / ROLE_CLIENT) : 44 vérifications HTTP, **0 écart**, cloisonnement client étanche.
- Build Nuxt OK, 9 layers, 0 import legacy résiduel.

### Points à arbitrer (hors périmètre de cette migration)
- Durcissement MCP/IDOR pré-existant (`userId` explicite sans scoping sur certains tools TimeTracking/Absence/TaskDocument) — ticket dédié recommandé.
- Validation fonctionnelle de **Prospect** et **ClientPortal** (conçus depuis les specs disque).
- **Harmonisation visuelle Malio finale** (3.3) — finition esthétique inter-modules laissée au PO.

---

## ⚠️ Déploiement / migration des données — à ne pas oublier

### 1. Resynchroniser les séquences PostgreSQL après tout import/restore de dump
Si la prod (ou tout environnement) est **montée depuis un dump** (`pg_restore` / `COPY`), les lignes sont chargées avec leurs `id` explicites **sans avancer les séquences** → au premier `INSERT` : `duplicate key value violates unique constraint "..._pkey"` (constaté en local sur `notification`, `task`, `time_entry`…).

À lancer **juste après chaque restore/import** :

```sql
DO $$
DECLARE r RECORD; maxid BIGINT; seq TEXT;
BEGIN
  FOR r IN SELECT table_name, column_name FROM information_schema.columns WHERE table_schema='public'
  LOOP
    seq := pg_get_serial_sequence(quote_ident(r.table_name), r.column_name);
    IF seq IS NOT NULL THEN
      EXECUTE format('SELECT COALESCE(MAX(%I),0) FROM %I', r.column_name, r.table_name) INTO maxid;
      PERFORM setval(seq, GREATEST(maxid,1), maxid > 0);
    END IF;
  END LOOP;
END $$;
```

> Ne concerne **pas** une prod qui tourne déjà (séquences avancées organiquement) — uniquement le cas restore/import. Idempotent, sans risque.

### 2. Fix dénormalisation des collections typées-contrat (code, inclus dans la branche)
Les relations **to-many** typées par une interface `Shared\Domain\Contract\*` (`TimeEntry::tags` → `TaskTagInterface`, `Task::collaborators` → `UserInterface`) étaient **indénormalisables par API Platform** (mono-valué OK via IRI, collection KO) → **tout POST/PATCH portant une telle collection renvoyait 400/500**. Corrigé par un dénormaliseur générique `ContractRelationDenormalizer` (réutilise `resolve_target_entities`, zéro couplage par-entité) + test fonctionnel de non-régression.

---------

Co-authored-by: Matthieu <contact@malio.fr>
Reviewed-on: #17

src/Command/AccrueLeaveCommand.php

@@ -1,151 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Command;
-
-use App\Enum\AbsenceType;
-use App\Repository\AbsenceBalanceRepository;
-use App\Repository\UserRepository;
-use App\Service\AbsenceBalanceService;
-use DateTimeImmutable;
-use Doctrine\ORM\EntityManagerInterface;
-use Exception;
-use Symfony\Component\Console\Attribute\AsCommand;
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Style\SymfonyStyle;
-
-use function preg_match;
-use function sprintf;
-
-/**
- * Monthly paid-leave accrual. For each active employee it credits one twelfth
- * of their yearly entitlement (prorated by work-time ratio) to the current
- * reference-period balance. Idempotent per month thanks to lastAccruedMonth,
- * and it seeds the initial balance when the period balance is first created.
- *
- * Intended to run on the 1st of each month (cron). Notifications are out of
- * scope for now.
- */
-#[AsCommand(
-    name: 'app:absences:accrue-leave',
-    description: 'Credit the monthly paid-leave accrual to every active employee',
-)]
-class AccrueLeaveCommand extends Command
-{
-    public function __construct(
-        private readonly UserRepository $userRepository,
-        private readonly AbsenceBalanceRepository $balanceRepository,
-        private readonly AbsenceBalanceService $balanceService,
-        private readonly EntityManagerInterface $entityManager,
-    ) {
-        parent::__construct();
-    }
-
-    protected function configure(): void
-    {
-        $this
-            ->addOption('month', null, InputOption::VALUE_REQUIRED, 'Target month (YYYY-MM), defaults to the current month')
-            ->addOption('dry-run', null, InputOption::VALUE_NONE, 'Compute and display without persisting')
-        ;
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output): int
-    {
-        $io = new SymfonyStyle($input, $output);
-
-        $monthOpt = $input->getOption('month');
-        $dryRun   = (bool) $input->getOption('dry-run');
-
-        try {
-            $firstDay = $monthOpt
-                ? new DateTimeImmutable($monthOpt.'-01')
-                : new DateTimeImmutable('first day of this month');
-        } catch (Exception) {
-            $io->error('Invalid --month, expected format YYYY-MM.');
-
-            return Command::FAILURE;
-        }
-
-        $firstDay = $firstDay->setTime(0, 0);
-        $lastDay  = $firstDay->modify('last day of this month');
-        $monthKey = $firstDay->format('Y-m');
-
-        $io->title(sprintf('Acquisition CP — %s%s', $monthKey, $dryRun ? ' (dry-run)' : ''));
-
-        $employees = $this->userRepository->findActiveEmployees($lastDay);
-        if ([] === $employees) {
-            $io->warning('Aucun salarié actif pour ce mois.');
-
-            return Command::SUCCESS;
-        }
-
-        $rows    = [];
-        $accrued = 0;
-        $skipped = 0;
-
-        foreach ($employees as $user) {
-            $rate   = ($user->getAnnualLeaveDays() / 12) * $user->getWorkTimeRatio();
-            $period = $this->balanceService->periodFor($user, AbsenceType::PaidLeave, $firstDay);
-
-            $balance = $this->balanceRepository->findOneForPeriod($user, AbsenceType::PaidLeave, $period);
-            $isNew   = null === $balance;
-
-            if ($isNew) {
-                $balance = $this->balanceService->getOrCreateBalance($user, AbsenceType::PaidLeave, $period);
-                // On a new period, the previous period's "en cours d'acquisition" (N)
-                // becomes this period's acquired (N-1). At roll-out (no prior balance)
-                // seed the configured initial balance instead.
-                $previousPeriod  = self::previousPeriod($period);
-                $previousBalance = null !== $previousPeriod
-                    ? $this->balanceRepository->findOneForPeriod($user, AbsenceType::PaidLeave, $previousPeriod)
-                    : null;
-                $balance->setAcquired(
-                    null !== $previousBalance ? $previousBalance->getAcquiring() : $user->getInitialLeaveBalance(),
-                );
-            }
-
-            if ($monthKey === $balance->getLastAccruedMonth()) {
-                ++$skipped;
-                $rows[] = [$user->getUsername(), $period, number_format($balance->getAcquired(), 2), number_format($balance->getAcquiring(), 2), 'déjà fait'];
-
-                continue;
-            }
-
-            $balance->setAcquiring($balance->getAcquiring() + $rate);
-            $balance->setLastAccruedMonth($monthKey);
-            ++$accrued;
-
-            $seeded = $isNew && (null !== self::previousPeriod($period) || $user->getInitialLeaveBalance() > 0);
-            $rows[] = [
-                $user->getUsername(),
-                $period,
-                number_format($balance->getAcquired(), 2),
-                number_format($balance->getAcquiring(), 2),
-                sprintf('+%s%s', number_format($rate, 2), $seeded && $balance->getAcquired() > 0 ? ' (N-1 reporté)' : ''),
-            ];
-        }
-
-        if (!$dryRun) {
-            $this->entityManager->flush();
-        }
-
-        $io->table(['Salarié', 'Période', 'Acquis (N-1)', 'En cours (N)', 'Action'], $rows);
-        $io->success(sprintf('%d crédité(s), %d ignoré(s)%s.', $accrued, $skipped, $dryRun ? ' (dry-run, rien enregistré)' : ''));
-
-        return Command::SUCCESS;
-    }
-
-    /** Previous reference period for a "YYYY-YYYY" paid-leave period, or null. */
-    private static function previousPeriod(string $period): ?string
-    {
-        if (1 !== preg_match('/^(\d{4})-(\d{4})$/', $period, $m)) {
-            return null;
-        }
-
-        return sprintf('%d-%d', (int) $m[1] - 1, (int) $m[2] - 1);
-    }
-}

src/Command/GenerateApiTokenCommand.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Command;
 
-use App\Repository\UserRepository;
+use App\Module\Core\Infrastructure\Doctrine\DoctrineUserRepository;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
@@ -22,7 +22,7 @@ use function sprintf;
 class GenerateApiTokenCommand extends Command
 {
     public function __construct(
-        private readonly UserRepository $userRepository,
+        private readonly DoctrineUserRepository $userRepository,
         private readonly EntityManagerInterface $entityManager,
     ) {
         parent::__construct();

src/Command/MailRedecodeHeadersCommand.php

@@ -1,84 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Command;
-
-use App\Mail\MimeHeaderDecoder;
-use App\Repository\MailMessageRepository;
-use Doctrine\ORM\EntityManagerInterface;
-use Symfony\Component\Console\Attribute\AsCommand;
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Style\SymfonyStyle;
-
-#[AsCommand(
-    name: 'app:mail:redecode-headers',
-    description: 'Re-décode les sujets et noms d\'expéditeur encodés en MIME (RFC 2047) déjà stockés en base',
-)]
-final class MailRedecodeHeadersCommand extends Command
-{
-    public function __construct(
-        private readonly MailMessageRepository $messageRepository,
-        private readonly EntityManagerInterface $entityManager,
-    ) {
-        parent::__construct();
-    }
-
-    protected function configure(): void
-    {
-        $this->addOption(
-            'dry-run',
-            null,
-            InputOption::VALUE_NONE,
-            'Affiche les changements sans écrire en base',
-        );
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output): int
-    {
-        $io       = new SymfonyStyle($input, $output);
-        $isDryRun = (bool) $input->getOption('dry-run');
-
-        $messages = $this->messageRepository->findAll();
-        $io->text(sprintf('%d message(s) à examiner...', count($messages)));
-
-        $changed = 0;
-
-        foreach ($messages as $message) {
-            $newSubject  = MimeHeaderDecoder::decode($message->getSubject());
-            $newFromName = MimeHeaderDecoder::decode($message->getFromName());
-
-            $hasChange = $newSubject !== $message->getSubject() || $newFromName !== $message->getFromName();
-
-            if (!$hasChange) {
-                continue;
-            }
-
-            if ($io->isVerbose()) {
-                $io->text(sprintf(' - #%d : "%s" → "%s"', $message->getId(), (string) $message->getSubject(), (string) $newSubject));
-            }
-
-            if (!$isDryRun) {
-                $message->setSubject($newSubject);
-                $message->setFromName($newFromName);
-            }
-
-            ++$changed;
-        }
-
-        if (!$isDryRun) {
-            $this->entityManager->flush();
-        }
-
-        $io->success(sprintf(
-            '%s%d en-tête(s) re-décodé(s).',
-            $isDryRun ? '[dry-run] ' : '',
-            $changed,
-        ));
-
-        return Command::SUCCESS;
-    }
-}

src/Command/MailSyncCommand.php

@@ -1,110 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Command;
-
-use App\Repository\MailConfigurationRepository;
-use App\Repository\MailFolderRepository;
-use App\Service\MailSyncService;
-use Symfony\Component\Console\Attribute\AsCommand;
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Style\SymfonyStyle;
-
-#[AsCommand(
-    name: 'app:mail:sync',
-    description: 'Synchronise la boîte mail partagée OVH (IMAP) vers la base locale',
-)]
-final class MailSyncCommand extends Command
-{
-    public function __construct(
-        private readonly MailSyncService $mailSyncService,
-        private readonly MailConfigurationRepository $configRepository,
-        private readonly MailFolderRepository $folderRepository,
-    ) {
-        parent::__construct();
-    }
-
-    protected function configure(): void
-    {
-        $this
-            ->addOption(
-                'folder',
-                null,
-                InputOption::VALUE_OPTIONAL,
-                'Synchronise uniquement le dossier spécifié (ex: INBOX)',
-            )
-            ->addOption(
-                'dry-run',
-                null,
-                InputOption::VALUE_NONE,
-                'Simule la synchronisation sans écrire en base (lecture IMAP uniquement)',
-            )
-        ;
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output): int
-    {
-        $io = new SymfonyStyle($input, $output);
-
-        $config = $this->configRepository->findSingleton();
-
-        if (null === $config || !$config->isEnabled()) {
-            $io->info('Mail config disabled, skipping.');
-
-            return Command::SUCCESS;
-        }
-
-        $isDryRun   = (bool) $input->getOption('dry-run');
-        $folderPath = $input->getOption('folder');
-
-        if ($isDryRun) {
-            $io->note('Mode --dry-run activé : aucune écriture en base.');
-            $io->success('Dry-run terminé — config IMAP active, aucune sync exécutée.');
-
-            return Command::SUCCESS;
-        }
-
-        $io->text('Démarrage de la synchronisation mail...');
-        $startTime = microtime(true);
-
-        if (null !== $folderPath) {
-            $folder = $this->folderRepository->findByPath((string) $folderPath);
-
-            if (null === $folder) {
-                $io->error(sprintf('Dossier "%s" introuvable en base — lance une sync complète au moins une fois.', $folderPath));
-
-                return Command::FAILURE;
-            }
-
-            $io->text(sprintf('Synchronisation du dossier : %s', $folderPath));
-            $report = $this->mailSyncService->syncFolder($folder);
-        } else {
-            $report = $this->mailSyncService->syncAll();
-        }
-
-        $elapsed = round(microtime(true) - $startTime, 2);
-
-        $io->success(sprintf(
-            'Sync terminée en %.1fs : %d créés, %d mis à jour, %d supprimés, %d dossiers scannés.',
-            $elapsed,
-            $report->createdCount,
-            $report->updatedCount,
-            $report->deletedCount,
-            $report->foldersScanned,
-        ));
-
-        if ([] !== $report->errors) {
-            $io->warning(sprintf('%d erreur(s) :', count($report->errors)));
-
-            foreach ($report->errors as $error) {
-                $io->text(' - '.$error);
-            }
-        }
-
-        return [] === $report->errors ? Command::SUCCESS : Command::FAILURE;
-    }
-}