TQ-Slator/tests/Entity/PlatformArchivingTest.php
Stephan Morand 9025c64c0b Socle complet de TQ-Slator : éditeur, API, CLI, administration
Système de gestion de traductions pensé en CMS headless : un back-office
pour ceux qui traduisent, une API pour ce qui consomme.

Architecture
- Symfony 7.4 / API Platform 4.3 / MariaDB 11.4, SPA React 19 servie en
  même origine — ce qui rend viable le cookie de session plutôt qu'un
  jeton en localStorage.
- Deux APIs séparées : Management (session ou clé) et Delivery
  (stateless, clé seule). Les fusionner ferait porter à chaque lecture de
  bundle le coût de la session.
- Stockage canonique en ICU MessageFormat, sérialisation par plateforme.
  Le format d'une plateforme ne contamine pas la base.
- Publication par releases immuables ; le déploiement est un déplacement
  de pointeur, donc le rollback aussi.
- Isolation multi-organisation par filtre Doctrine, avec un test
  d'architecture qui casse la CI si une entité échappe à l'invariant.

Éditeur, deux vues
- Par langue : source et cible, jamais douze colonnes. Grille virtualisée,
  saisie sans bouton « Enregistrer », panneau de contexte permanent.
- Par clé : une clé, toutes ses langues empilées et repliées. Répond à
  « ce libellé est-il prêt partout ? ».
- Mode Focus dans les deux : une file à vider, ⌘↵ pour enchaîner.
- Le traducteur ne voit jamais d'ICU : pastilles de variables, un champ
  par catégorie CLDR de la langue cible.

Administration
- Deux niveaux : projet (membres, clés API, plateformes) et organisation
  (annuaire des comptes, création de projets).
- Invitations par e-mail, jeton 256 bits stocké haché.
- Désactiver un compte coupe les sessions en cours, pas seulement les
  connexions suivantes.
- Les plateformes s'archivent ; ni elles ni les environnements ne se
  suppriment — la trace explique pourquoi telle clé existe.

CLI tqs
- PHAR autonome de 3 Mo, autoloader généré : le dépôt client ne dépend
  ni de Composer ni de la disponibilité de TQ-Slator.
- init / push / pull / status ; le sync est non destructif par défaut et
  son prune est scopé plateforme.

126 tests, PHPStan niveau 8.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-21 08:16:05 +02:00

95 lines
3.2 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Tests\Entity;
use App\Entity\Locale;
use App\Entity\Organization;
use App\Entity\Platform;
use App\Entity\Project;
use App\Enum\MessageFormat;
use App\Enum\PlatformKind;
use App\Enum\TextDirection;
use PHPUnit\Framework\TestCase;
/**
* Archiver une plateforme doit la faire disparaître de tout ce qui PRODUIT.
*
* L'invariant tient à une seule chose : que chaque appelant passe par
* `getActivePlatforms()` et non par `getPlatforms()`. Rien dans le code
* n'empêche d'écrire le second — et l'oubli ne se verrait pas : le bundle
* serait construit, la publication réussirait, et une plateforme retirée
* continuerait d'être livrée sans que personne ne s'en aperçoive.
*
* Ces tests posent la frontière entre les deux accesseurs.
*/
final class PlatformArchivingTest extends TestCase
{
private Project $project;
private Platform $web;
private Platform $ios;
protected function setUp(): void
{
$organization = new Organization('Test', 'test');
$french = new Locale('fr-FR', 'French', 'Français', TextDirection::Ltr, ['one', 'many', 'other']);
$this->project = new Project($organization, 'Test', 'test', $french);
$this->web = new Platform($this->project, 'Web', 'web', PlatformKind::Web, MessageFormat::I18next);
$this->ios = new Platform($this->project, 'iOS', 'ios', PlatformKind::Ios, MessageFormat::Icu);
}
public function testArchivedPlatformLeavesTheActiveList(): void
{
self::assertCount(2, $this->project->getActivePlatforms());
$this->ios->archive();
self::assertSame([$this->web], $this->project->getActivePlatforms());
// …mais reste dans la liste complète : c'est ce qui permet de la
// rétablir, et de comprendre pourquoi des clés lui sont rattachées.
self::assertCount(2, $this->project->getPlatforms());
}
public function testRestoringBringsThePlatformBack(): void
{
$this->ios->archive();
$this->ios->restore();
self::assertCount(2, $this->project->getActivePlatforms());
self::assertFalse($this->ios->isArchived());
self::assertNull($this->ios->getArchivedAt());
}
public function testArchivingIsIdempotent(): void
{
$this->ios->archive();
$first = $this->ios->getArchivedAt();
$this->ios->archive();
// La date ne bouge pas : c'est celle du retrait, pas celle du dernier
// clic. La réécrire ferait mentir la ligne « archivée le … ».
self::assertSame($first, $this->ios->getArchivedAt());
}
public function testArchivedPlatformRefusesPush(): void
{
self::assertTrue($this->web->canAcceptPush());
$this->web->archive();
// Accepter un `sync` sur une plateforme sortie de scène recréerait
// silencieusement des clés que plus personne ne livrera.
self::assertFalse($this->web->canAcceptPush());
}
public function testFormatWithoutParserNeverAcceptsPush(): void
{
$backend = new Platform($this->project, 'API', 'api', PlatformKind::Backend, MessageFormat::Symfony);
self::assertFalse($backend->canAcceptPush());
}
}