feat: Permettre l'import d'enseignants via fichier CSV ou XLSX

L'établissement a besoin d'importer en masse ses enseignants depuis les
exports des logiciels de vie scolaire (Pronote, EDT, etc.), comme c'est
déjà possible pour les élèves. Le wizard en 4 étapes (upload → mapping
→ aperçu → import) réutilise l'architecture de l'import élèves tout en
ajoutant la gestion des matières et des classes enseignées.

Corrections de la review #2 intégrées :
- La commande ImportTeachersCommand est routée en async via Messenger
  pour ne pas bloquer la requête HTTP sur les gros fichiers.
- Le handler est protégé par un try/catch Throwable pour marquer le
  batch en échec si une erreur inattendue survient, évitant qu'il
  reste bloqué en statut "processing".
- Les domain events (UtilisateurInvite) sont dispatchés sur l'event
  bus après chaque création d'utilisateur, déclenchant l'envoi des
  emails d'invitation.
- L'option "mettre à jour les enseignants existants" (AC5) permet de
  choisir entre ignorer ou mettre à jour nom/prénom et ajouter les
  affectations manquantes pour les doublons détectés par email.
This commit is contained in:
2026-02-27 01:49:01 +01:00
parent f2f57bb999
commit de5880e25e
52 changed files with 7462 additions and 47 deletions

View File

@@ -0,0 +1,129 @@
<?php
declare(strict_types=1);
namespace App\Tests\Unit\Administration\Domain\Model\Import;
use App\Administration\Domain\Exception\MappingIncompletException;
use App\Administration\Domain\Model\Import\KnownImportFormat;
use App\Administration\Domain\Model\Import\TeacherColumnMapping;
use App\Administration\Domain\Model\Import\TeacherImportField;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class TeacherColumnMappingTest extends TestCase
{
#[Test]
public function creerWithAllRequiredFieldsSucceeds(): void
{
$mapping = TeacherColumnMapping::creer(
[
'Nom' => TeacherImportField::LAST_NAME,
'Prénom' => TeacherImportField::FIRST_NAME,
'Email' => TeacherImportField::EMAIL,
],
KnownImportFormat::CUSTOM,
);
self::assertCount(3, $mapping->colonnesSources());
self::assertSame(KnownImportFormat::CUSTOM, $mapping->format);
}
#[Test]
public function creerWithOptionalFieldsSucceeds(): void
{
$mapping = TeacherColumnMapping::creer(
[
'Nom' => TeacherImportField::LAST_NAME,
'Prénom' => TeacherImportField::FIRST_NAME,
'Email' => TeacherImportField::EMAIL,
'Matières' => TeacherImportField::SUBJECTS,
'Classes' => TeacherImportField::CLASSES,
],
KnownImportFormat::CUSTOM,
);
self::assertCount(5, $mapping->colonnesSources());
}
#[Test]
public function creerSansNomLeveException(): void
{
$this->expectException(MappingIncompletException::class);
TeacherColumnMapping::creer(
[
'Prénom' => TeacherImportField::FIRST_NAME,
'Email' => TeacherImportField::EMAIL,
],
KnownImportFormat::CUSTOM,
);
}
#[Test]
public function creerSansPrenomLeveException(): void
{
$this->expectException(MappingIncompletException::class);
TeacherColumnMapping::creer(
[
'Nom' => TeacherImportField::LAST_NAME,
'Email' => TeacherImportField::EMAIL,
],
KnownImportFormat::CUSTOM,
);
}
#[Test]
public function creerSansEmailLeveException(): void
{
$this->expectException(MappingIncompletException::class);
TeacherColumnMapping::creer(
[
'Nom' => TeacherImportField::LAST_NAME,
'Prénom' => TeacherImportField::FIRST_NAME,
],
KnownImportFormat::CUSTOM,
);
}
#[Test]
public function champPourReturnsMappedField(): void
{
$mapping = TeacherColumnMapping::creer(
[
'Nom' => TeacherImportField::LAST_NAME,
'Prénom' => TeacherImportField::FIRST_NAME,
'Email' => TeacherImportField::EMAIL,
],
KnownImportFormat::CUSTOM,
);
self::assertSame(TeacherImportField::LAST_NAME, $mapping->champPour('Nom'));
self::assertSame(TeacherImportField::FIRST_NAME, $mapping->champPour('Prénom'));
self::assertNull($mapping->champPour('Inconnu'));
}
#[Test]
public function equalsComparesCorrectly(): void
{
$mapping1 = TeacherColumnMapping::creer(
['Nom' => TeacherImportField::LAST_NAME, 'Prénom' => TeacherImportField::FIRST_NAME, 'Email' => TeacherImportField::EMAIL],
KnownImportFormat::CUSTOM,
);
$mapping2 = TeacherColumnMapping::creer(
['Nom' => TeacherImportField::LAST_NAME, 'Prénom' => TeacherImportField::FIRST_NAME, 'Email' => TeacherImportField::EMAIL],
KnownImportFormat::CUSTOM,
);
$mapping3 = TeacherColumnMapping::creer(
['Nom' => TeacherImportField::LAST_NAME, 'Prénom' => TeacherImportField::FIRST_NAME, 'Email' => TeacherImportField::EMAIL],
KnownImportFormat::PRONOTE,
);
self::assertTrue($mapping1->equals($mapping2));
self::assertFalse($mapping1->equals($mapping3));
}
}