TQ-Slator/bin/tqs
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

71 lines
2.3 KiB
PHP
Executable file

#!/usr/bin/env php
<?php
declare(strict_types=1);
use App\Cli\CliException;
use App\Cli\Command\InitCommand;
use App\Cli\Command\PullCommand;
use App\Cli\Command\PushCommand;
use App\Cli\Command\StatusCommand;
use Symfony\Component\Console\Application;
use Symfony\Component\Console\Output\ConsoleOutput;
use Symfony\Component\Console\Output\OutputInterface;
/*
* Point d'entrée du CLI.
*
* Volontairement INDÉPENDANT du kernel Symfony : ni conteneur, ni Doctrine, ni
* base de données. Ce binaire tourne sur la machine d'un développeur d'une
* application cliente, pas sur le serveur — il n'a rien à savoir de
* l'infrastructure de TQ-Slator, seulement parler HTTP.
*
* Bénéfice concret : démarrage en quelques millisecondes, et aucune raison
* d'échouer parce qu'une variable d'environnement du serveur manque.
*/
// Dans le PHAR, le stub a déjà chargé l'autoloader dédié — le test porte sur le
// contexte d'exécution, pas sur une classe : à ce stade rien n'est encore
// chargé, seul un autoloader est enregistré.
if ('' === Phar::running(false)) {
foreach ([__DIR__.'/../vendor/autoload.php', __DIR__.'/../../../autoload.php'] as $autoload) {
if (is_file($autoload)) {
require $autoload;
break;
}
}
}
$application = new Application('tqs', '1.0.0');
$application->setCatchExceptions(false);
$application->addCommands([
new InitCommand(),
new PushCommand(),
new PullCommand(),
new StatusCommand(),
]);
$output = new ConsoleOutput();
try {
exit($application->run(null, $output));
} catch (CliException $exception) {
// Erreur attendue : le message a été rédigé pour être lu. Pas de trace —
// une pile d'appels devant « exportez TQS_API_KEY » n'aide personne.
$output->getErrorOutput()->writeln(['', '<error> Erreur </error>', '', $exception->getMessage(), '']);
exit(1);
} catch (Throwable $exception) {
$errors = $output->getErrorOutput();
$errors->writeln(['', '<error> Erreur inattendue </error>', '', $exception->getMessage(), '']);
if ($errors->getVerbosity() >= OutputInterface::VERBOSITY_VERBOSE) {
$errors->writeln($exception->getTraceAsString());
} else {
$errors->writeln('<comment>Relancez avec -v pour la trace complète.</comment>');
$errors->writeln('');
}
exit(1);
}