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/Module/Absence/Infrastructure/Command/AccrueLeaveCommand.php

@@ -0,0 +1,159 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Module\Absence\Infrastructure\Command;
+
+use App\Module\Absence\Application\Service\AbsenceBalanceService;
+use App\Module\Absence\Domain\Enum\AbsenceType;
+use App\Module\Absence\Domain\Repository\AbsenceBalanceRepositoryInterface;
+use App\Module\Core\Domain\Repository\UserRepositoryInterface;
+use App\Shared\Domain\Contract\LeaveProfileInterface;
+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 UserRepositoryInterface $userRepository,
+        private readonly AbsenceBalanceRepositoryInterface $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) {
+            // RH leave profile fields are read through the contract to keep the
+            // Absence module decoupled from the concrete Core User entity.
+            $profile = $user instanceof LeaveProfileInterface ? $user : null;
+            if (null === $profile) {
+                continue;
+            }
+
+            $rate   = ($profile->getAnnualLeaveDays() / 12) * $profile->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() : $profile->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) || $profile->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);
+    }
+}