Compare commits
6 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 276f242b10 | |||
| 97301dcd6c | |||
| daeb8b3003 | |||
| 9c311cb58b | |||
| 5a33815584 | |||
| 052a39092b |
@@ -98,6 +98,24 @@ Format obligatoire : `module.resource[.subresource].action` en snake_case.
|
||||
- Audit ManyToMany : trace automatiquement `{fieldName: {added: [ids], removed: [ids]}}` — aucune action supplementaire
|
||||
- Spec complete : @doc/audit-log.md
|
||||
|
||||
### Libelle i18n du type d'entite (obligatoire avec `#[Auditable]`)
|
||||
|
||||
**Toute entite `#[Auditable]` doit avoir son libelle FR dans le bloc `audit.entity` de `frontend/i18n/locales/fr.json`.** C'est la contrepartie i18n de l'attribut : sans elle, le filtre « Type d'entite » de l'audit-log affiche le type technique brut (ex: `commercial.Client`) au lieu d'un libelle lisible.
|
||||
|
||||
Pourquoi : le filtre est dynamique (`GET /audit-log-entity-types` renvoie les `entity_type` distincts presents en base) ; des qu'un module audite une entite, son type y apparait. Le front (`formatEntityType`, `audit-log.vue`) construit la cle `audit.entity.<module>_<entity>` et, faute de traduction, **retombe silencieusement** sur le type brut.
|
||||
|
||||
Derivation de la cle (emplacement centralise + schema flat — decision ERP-99) :
|
||||
|
||||
| FQCN entite | `entity_type` (back) | Cle i18n (flat) |
|
||||
|---|---|---|
|
||||
| `App\Module\Commercial\Domain\Entity\Client` | `commercial.Client` | `commercial_client` |
|
||||
| `App\Module\Commercial\Domain\Entity\ClientAddress` | `commercial.ClientAddress` | `commercial_clientaddress` |
|
||||
| `App\Module\Catalog\Domain\Entity\Category` | `catalog.Category` | `catalog_category` |
|
||||
|
||||
Regle : `strtolower(module)` + `_` + `strtolower(Entity)`. Ajouter sa cle de libelle audit fait partie de la **definition de fini** d'une entite metier auditee.
|
||||
|
||||
**Garde-fou** : `tests/Architecture/AuditableEntitiesHaveI18nLabelTest` scanne les entites `#[Auditable]` et echoue si une seule n'a pas sa cle `audit.entity.*`. Conclusion : creer une entite `#[Auditable]` sans son libelle i18n casse `make test`.
|
||||
|
||||
## Timestampable + Blamable (obligatoire pour entites metier)
|
||||
|
||||
Toute **nouvelle** entite metier sous `src/Module/*/Domain/Entity/` doit porter les 4 colonnes `created_at` / `updated_at` / `created_by` / `updated_by`, remplies automatiquement. Trois lignes a ajouter a l'entite :
|
||||
|
||||
@@ -3,6 +3,14 @@ lexik_jwt_authentication:
|
||||
public_key: '%env(resolve:JWT_PUBLIC_KEY)%'
|
||||
pass_phrase: '%env(JWT_PASSPHRASE)%'
|
||||
token_ttl: '%env(int:JWT_TOKEN_TTL)%'
|
||||
# Tolerance d'horloge (en secondes) appliquee a la validation des claims
|
||||
# temporels iat / nbf / exp (LooseValidAt cote lcobucci). Sans cette marge
|
||||
# (defaut 0), un recul d'horloge entre la signature (/login_check) et la
|
||||
# requete suivante rend iat/nbf « dans le futur » -> « Invalid JWT Token »
|
||||
# (401). Observe en dev sous WSL2/Docker (horloge CLOCK_REALTIME non
|
||||
# monotone) : flakes intermittents de la suite PHPUnit (ERP-98). Benefice
|
||||
# aussi en prod si les noeuds derivent legerement entre eux.
|
||||
clock_skew: 15
|
||||
remove_token_from_body_when_cookies_used: true
|
||||
token_extractors:
|
||||
authorization_header:
|
||||
|
||||
+1
-1
@@ -1,2 +1,2 @@
|
||||
parameters:
|
||||
app.version: '0.1.67'
|
||||
app.version: '0.1.70'
|
||||
|
||||
@@ -222,10 +222,15 @@
|
||||
"delete": "Suppression"
|
||||
},
|
||||
"entity": {
|
||||
"core_user": "Utilisateur",
|
||||
"core_role": "Rôle",
|
||||
"core_permission": "Permission",
|
||||
"sites_site": "Site"
|
||||
"core_user": "Utilisateur",
|
||||
"core_role": "Rôle",
|
||||
"core_permission": "Permission",
|
||||
"sites_site": "Site",
|
||||
"catalog_category": "Catégorie",
|
||||
"commercial_client": "Client",
|
||||
"commercial_clientaddress": "Adresse client",
|
||||
"commercial_clientcontact": "Contact client",
|
||||
"commercial_clientrib": "RIB client"
|
||||
},
|
||||
"empty": "Aucune activité enregistrée",
|
||||
"no_results": "Aucun résultat pour ces filtres",
|
||||
|
||||
@@ -33,6 +33,12 @@ interface ClientRepositoryInterface
|
||||
* la liste paginee (ClientProvider) et l'export (ClientExportController)
|
||||
* partagent strictement la meme logique de selection.
|
||||
*
|
||||
* Contrat = SELECTION uniquement (filtres + tri). Aucun fetch-join to-many :
|
||||
* l'hydratation des collections affichees est une decision de l'appelant
|
||||
* (cf. {@see self::hydrateListCollections()}), pour ne pas imposer le cout
|
||||
* d'un produit cartesien a un consommateur qui ne filtrerait/compterait que
|
||||
* (ERP-100).
|
||||
*
|
||||
* @param list<string> $categoryCodes
|
||||
* @param list<int> $siteIds
|
||||
*/
|
||||
@@ -43,4 +49,19 @@ interface ClientRepositoryInterface
|
||||
array $siteIds = [],
|
||||
bool $archivedOnly = false,
|
||||
): QueryBuilder;
|
||||
|
||||
/**
|
||||
* Hydrate en lot les collections affichees par le repertoire (categories,
|
||||
* adresses et leurs sites) sur un jeu de clients DEJA charges, via l'identity
|
||||
* map Doctrine (memes instances). A appeler apres une selection bornee (page
|
||||
* courante ou jeu d'export) pour eviter le N+1 a la serialisation, sans
|
||||
* imposer de fetch-join au QueryBuilder de selection (ERP-100).
|
||||
*
|
||||
* Charge les categories et les adresses/sites en DEUX requetes distinctes
|
||||
* (et non un triple fetch-join) pour ne pas multiplier categories x adresses
|
||||
* x sites en un seul produit cartesien.
|
||||
*
|
||||
* @param list<Client> $clients
|
||||
*/
|
||||
public function hydrateListCollections(array $clients): void;
|
||||
}
|
||||
|
||||
@@ -83,8 +83,13 @@ final class ClientProvider implements ProviderInterface
|
||||
// Echappatoire ?pagination=false : collection complete sans Paginator
|
||||
// (cf. convention ERP-72 — utile pour un <select> cote front).
|
||||
if (!$this->pagination->isEnabled($operation, $context)) {
|
||||
// @var list<Client> $result
|
||||
return $qb->getQuery()->getResult();
|
||||
/** @var list<Client> $clients */
|
||||
$clients = $qb->getQuery()->getResult();
|
||||
// Hydratation batchee des collections affichees (cf. ERP-100) : evite
|
||||
// le N+1 si la serialisation touche categories/sites, sans cartesien.
|
||||
$this->repository->hydrateListCollections($clients);
|
||||
|
||||
return $clients;
|
||||
}
|
||||
|
||||
$limit = $this->pagination->getLimit($operation, $context);
|
||||
@@ -93,9 +98,13 @@ final class ClientProvider implements ProviderInterface
|
||||
|
||||
$qb->setFirstResult($offset)->setMaxResults($limit);
|
||||
|
||||
// fetchJoinCollection: true pour un COUNT correct des que des JOINs
|
||||
// to-many seront ajoutes (sous-collections embarquees en detail).
|
||||
return new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: true));
|
||||
// Le QB de selection ne porte plus de fetch-join to-many (ERP-100) : le
|
||||
// COUNT est simple, fetchJoinCollection inutile. On materialise la page
|
||||
// puis on hydrate ses collections en lot (memes entites managees).
|
||||
$paginator = new Paginator(new DoctrinePaginator($qb->getQuery(), fetchJoinCollection: false));
|
||||
$this->repository->hydrateListCollections(iterator_to_array($paginator));
|
||||
|
||||
return $paginator;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -69,6 +69,11 @@ final class ClientExportController
|
||||
->getResult()
|
||||
;
|
||||
|
||||
// Hydratation batchee des categories + adresses/sites (ERP-100) : le QB de
|
||||
// selection ne fetch-join plus, on remplit les collections en 2 requetes
|
||||
// IN bornees plutot que d'hydrater un produit cartesien sur tout le jeu.
|
||||
$this->repository->hydrateListCollections($clients);
|
||||
|
||||
$withSiren = $this->security->isGranted('commercial.clients.accounting.view');
|
||||
|
||||
$binary = $this->exporter->export(
|
||||
|
||||
@@ -38,16 +38,12 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
|
||||
array $siteIds = [],
|
||||
bool $archivedOnly = false,
|
||||
): QueryBuilder {
|
||||
// SELECTION uniquement (filtres + tri) : pas de fetch-join to-many ici.
|
||||
// L'hydratation des collections affichees (Catégories / Site(s)) est
|
||||
// deleguee a hydrateListCollections() une fois le jeu borne, pour ne pas
|
||||
// imposer un produit cartesien aux chemins non pagines (export,
|
||||
// ?pagination=false) — ERP-100.
|
||||
$qb = $this->createQueryBuilder('c')
|
||||
// Jointures + addSelect pour hydrater en une seule requete les
|
||||
// collections affichees par le Repertoire (colonnes Catégories /
|
||||
// Site(s)) : sans cela, la serialisation declenche un N+1 (une
|
||||
// requete par client, puis par adresse). Le Paginator ORM
|
||||
// (fetchJoinCollection: true, cf. ClientProvider) gere le COUNT
|
||||
// malgre ces jointures to-many.
|
||||
->leftJoin('c.categories', 'cat')->addSelect('cat')
|
||||
->leftJoin('c.addresses', 'addr')->addSelect('addr')
|
||||
->leftJoin('addr.sites', 'site')->addSelect('site')
|
||||
->andWhere('c.deletedAt IS NULL')
|
||||
->orderBy('c.companyName', 'ASC')
|
||||
;
|
||||
@@ -66,6 +62,46 @@ class DoctrineClientRepository extends ServiceEntityRepository implements Client
|
||||
return $qb;
|
||||
}
|
||||
|
||||
public function hydrateListCollections(array $clients): void
|
||||
{
|
||||
if ([] === $clients) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Ids des clients deja charges (entites managees). On rehydrate leurs
|
||||
// collections via l'identity map : les requetes ci-dessous renvoient les
|
||||
// MEMES instances Client, dont les collections sont alors remplies.
|
||||
$ids = [];
|
||||
foreach ($clients as $client) {
|
||||
$id = $client->getId();
|
||||
if (null !== $id) {
|
||||
$ids[] = $id;
|
||||
}
|
||||
}
|
||||
if ([] === $ids) {
|
||||
return;
|
||||
}
|
||||
|
||||
// 1re passe : categories (colonne « Catégories »). Produit c x cat seul.
|
||||
$this->createQueryBuilder('c')
|
||||
->leftJoin('c.categories', 'cat')->addSelect('cat')
|
||||
->where('c.id IN (:ids)')->setParameter('ids', $ids)
|
||||
->getQuery()
|
||||
->getResult()
|
||||
;
|
||||
|
||||
// 2e passe : adresses + sites (colonne « Site(s) », sites portes par les
|
||||
// adresses — RG-1.10). Le join addr -> site reste imbrique mais n'est
|
||||
// plus multiplie par les categories : le cartesien global est casse.
|
||||
$this->createQueryBuilder('c')
|
||||
->leftJoin('c.addresses', 'addr')->addSelect('addr')
|
||||
->leftJoin('addr.sites', 'site')->addSelect('site')
|
||||
->where('c.id IN (:ids)')->setParameter('ids', $ids)
|
||||
->getQuery()
|
||||
->getResult()
|
||||
;
|
||||
}
|
||||
|
||||
/**
|
||||
* Recherche fuzzy insensible a la casse sur companyName + lastName + email.
|
||||
* Les metacaracteres LIKE (%, _, \) saisis sont echappes pour rester
|
||||
|
||||
@@ -6,12 +6,12 @@ namespace App\Shared\Infrastructure\Doctrine;
|
||||
|
||||
use App\Shared\Domain\Contract\BlamableInterface;
|
||||
use App\Shared\Domain\Contract\TimestampableInterface;
|
||||
use DateTimeImmutable;
|
||||
use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
|
||||
use Doctrine\ORM\Event\PrePersistEventArgs;
|
||||
use Doctrine\ORM\Event\PreUpdateEventArgs;
|
||||
use Doctrine\ORM\Events;
|
||||
use Symfony\Bundle\SecurityBundle\Security;
|
||||
use Symfony\Component\Clock\ClockInterface;
|
||||
use Symfony\Component\Security\Core\User\UserInterface;
|
||||
|
||||
/**
|
||||
@@ -30,12 +30,19 @@ use Symfony\Component\Security\Core\User\UserInterface;
|
||||
#[AsDoctrineListener(event: Events::preUpdate)]
|
||||
final class TimestampableBlamableSubscriber
|
||||
{
|
||||
public function __construct(private readonly Security $security) {}
|
||||
// L'horloge est injectee (et non un `new DateTimeImmutable()` direct) pour
|
||||
// que les tests puissent figer/avancer le temps de facon deterministe via
|
||||
// ClockSensitiveTrait (cf. ERP-98). En prod, le service `clock` delegue a
|
||||
// l'horloge systeme reelle.
|
||||
public function __construct(
|
||||
private readonly Security $security,
|
||||
private readonly ClockInterface $clock,
|
||||
) {}
|
||||
|
||||
public function prePersist(PrePersistEventArgs $args): void
|
||||
{
|
||||
$entity = $args->getObject();
|
||||
$now = new DateTimeImmutable();
|
||||
$now = $this->clock->now();
|
||||
$user = $this->security->getUser();
|
||||
|
||||
if ($entity instanceof TimestampableInterface) {
|
||||
@@ -55,7 +62,7 @@ final class TimestampableBlamableSubscriber
|
||||
$user = $this->security->getUser();
|
||||
|
||||
if ($entity instanceof TimestampableInterface) {
|
||||
$entity->setUpdatedAt(new DateTimeImmutable());
|
||||
$entity->setUpdatedAt($this->clock->now());
|
||||
}
|
||||
|
||||
if ($entity instanceof BlamableInterface && $user instanceof UserInterface) {
|
||||
|
||||
@@ -0,0 +1,167 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App\Tests\Architecture;
|
||||
|
||||
use App\Shared\Domain\Attribute\Auditable;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
use ReflectionClass;
|
||||
use Symfony\Component\Finder\Finder;
|
||||
|
||||
use function is_string;
|
||||
use function sprintf;
|
||||
|
||||
use const JSON_THROW_ON_ERROR;
|
||||
|
||||
/**
|
||||
* Garde-fou architecture : toute entite `#[Auditable]` doit avoir son libelle
|
||||
* i18n dans le bloc `audit.entity` du `fr.json` du shell.
|
||||
*
|
||||
* Pourquoi : le filtre « Type d'entite » de l'audit-log est dynamique
|
||||
* (`GET /audit-log-entity-types` renvoie les `entity_type` distincts presents
|
||||
* en base). Des qu'un module audite une entite, un nouveau type apparait. Le
|
||||
* rendu front (`formatEntityType`, audit-log.vue) construit la cle
|
||||
* `audit.entity.<module>_<entity>` et, faute de traduction, retombe
|
||||
* SILENCIEUSEMENT sur le type technique brut (ex: `commercial.Client`). Le
|
||||
* manque passe donc inapercu jusqu'a observation dans l'UI.
|
||||
*
|
||||
* Ce test rend le manque BLOQUANT (meme esprit que ColumnsHaveSqlCommentTest) :
|
||||
* il scanne les entites `#[Auditable]` sous `src/Module/<m>/Domain/Entity/`,
|
||||
* derive la cle attendue comme le fait le front, et echoue si elle est absente
|
||||
* du `fr.json`.
|
||||
*
|
||||
* Derivation de la cle (miroir exact de AuditListener::formatEntityType + de
|
||||
* formatEntityType cote front) :
|
||||
* FQCN `App\Module\Commercial\Domain\Entity\ClientAddress`
|
||||
* -> entity_type `commercial.ClientAddress` (module en minuscules, Entity intacte)
|
||||
* -> cle i18n `commercial_clientaddress` (tout en minuscules, `.` -> `_`)
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
final class AuditableEntitiesHaveI18nLabelTest extends TestCase
|
||||
{
|
||||
/**
|
||||
* Chemin du fichier de traductions FR du shell. Source unique des libelles
|
||||
* d'entite audit (decision ERP-99 : emplacement centralise, schema flat).
|
||||
*/
|
||||
private const LOCALE_FILE = __DIR__.'/../../frontend/i18n/locales/fr.json';
|
||||
|
||||
public function testEveryAuditableEntityHasAnI18nLabel(): void
|
||||
{
|
||||
$labels = $this->loadAuditEntityLabels();
|
||||
|
||||
$finder = new Finder()
|
||||
->files()
|
||||
->in(__DIR__.'/../../src/Module')
|
||||
->path('Domain/Entity')
|
||||
->name('*.php')
|
||||
;
|
||||
|
||||
// Garde : si le scan ne trouve rien, le chemin est casse — le test
|
||||
// deviendrait un faux positif vert. On verifie qu'il a du grain a moudre.
|
||||
self::assertNotEmpty(iterator_to_array($finder), 'Aucune entite scannee : chemin src/Module invalide ?');
|
||||
|
||||
$checked = 0;
|
||||
foreach ($finder as $file) {
|
||||
$fqcn = $this->extractFqcn($file->getRealPath());
|
||||
if (null === $fqcn) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$reflection = new ReflectionClass($fqcn);
|
||||
// On ne s'interesse qu'aux entites reellement auditees.
|
||||
if ($reflection->isAbstract() || [] === $reflection->getAttributes(Auditable::class)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$key = $this->deriveI18nKey($fqcn);
|
||||
self::assertNotNull(
|
||||
$key,
|
||||
sprintf('Entite %s hors structure modulaire attendue (App\Module\<M>\Domain\Entity\<E>).', $fqcn),
|
||||
);
|
||||
|
||||
self::assertArrayHasKey(
|
||||
$key,
|
||||
$labels,
|
||||
sprintf(
|
||||
'L\'entite auditable %s n\'a pas de libelle i18n. Ajouter "%s" dans le bloc '
|
||||
.'`audit.entity` de frontend/i18n/locales/fr.json (sinon le filtre audit-log '
|
||||
.'affiche le type technique brut). Cf. ERP-99 + .claude/rules/backend.md § Audit.',
|
||||
$fqcn,
|
||||
$key,
|
||||
),
|
||||
);
|
||||
self::assertNotSame('', trim($labels[$key]), sprintf('Le libelle audit "%s" est vide.', $key));
|
||||
|
||||
++$checked;
|
||||
}
|
||||
|
||||
// Garde : au moins une entite auditable doit avoir ete verifiee, sinon
|
||||
// la detection de l'attribut est cassee (faux positif vert).
|
||||
self::assertGreaterThan(0, $checked, 'Aucune entite #[Auditable] detectee : detection d\'attribut cassee ?');
|
||||
}
|
||||
|
||||
/**
|
||||
* Charge le bloc `audit.entity` du fr.json sous forme de map cle -> libelle.
|
||||
*
|
||||
* @return array<string, string>
|
||||
*/
|
||||
private function loadAuditEntityLabels(): array
|
||||
{
|
||||
$raw = file_get_contents(self::LOCALE_FILE);
|
||||
self::assertIsString($raw, sprintf('Fichier de locale introuvable : %s', self::LOCALE_FILE));
|
||||
|
||||
/** @var array<string, mixed> $json */
|
||||
$json = json_decode($raw, true, flags: JSON_THROW_ON_ERROR);
|
||||
|
||||
$entity = $json['audit']['entity'] ?? null;
|
||||
self::assertIsArray($entity, 'Bloc `audit.entity` absent ou invalide dans fr.json.');
|
||||
|
||||
$labels = [];
|
||||
foreach ($entity as $key => $value) {
|
||||
if (is_string($key) && is_string($value)) {
|
||||
$labels[$key] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $labels;
|
||||
}
|
||||
|
||||
/**
|
||||
* Derive la cle i18n `<module>_<entity>` depuis le FQCN, en miroir de
|
||||
* AuditListener::formatEntityType (module en minuscules) suivi de
|
||||
* l'aplatissement front (tout en minuscules, `.` -> `_`).
|
||||
*
|
||||
* Retourne null si le FQCN ne respecte pas la structure modulaire.
|
||||
*/
|
||||
private function deriveI18nKey(string $fqcn): ?string
|
||||
{
|
||||
if (1 !== preg_match('#^App\\\Module\\\(?<module>[^\\\]+)\\\.+\\\(?<entity>[^\\\]+)$#', $fqcn, $m)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return strtolower($m['module']).'_'.strtolower($m['entity']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Extrait le FQCN (namespace + classe) d'un fichier PHP par lecture du
|
||||
* source, sans charger le fichier.
|
||||
*/
|
||||
private function extractFqcn(string $path): ?string
|
||||
{
|
||||
$source = file_get_contents($path);
|
||||
if (false === $source) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if (
|
||||
1 !== preg_match('/^namespace\s+([^;]+);/m', $source, $nsMatch)
|
||||
|| 1 !== preg_match('/^(?:final\s+|abstract\s+|readonly\s+)*class\s+(\w+)/m', $source, $classMatch)
|
||||
) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return trim($nsMatch[1]).'\\'.$classMatch[1];
|
||||
}
|
||||
}
|
||||
@@ -7,6 +7,8 @@ namespace App\Tests\Module\Catalog\Api;
|
||||
use App\Module\Catalog\Domain\Entity\Category;
|
||||
use App\Module\Core\Domain\Entity\User;
|
||||
use DateTimeImmutable;
|
||||
use Symfony\Component\Clock\ClockInterface;
|
||||
use Symfony\Component\Clock\Test\ClockSensitiveTrait;
|
||||
|
||||
/**
|
||||
* Tests RG-1.15 / RG-1.16 : le TimestampableBlamableSubscriber doit remplir
|
||||
@@ -20,12 +22,39 @@ use DateTimeImmutable;
|
||||
* - DELETE : deletedAt rempli ET updatedAt + updatedBy mis a jour (UPDATE
|
||||
* Doctrine declenche le subscriber)
|
||||
*
|
||||
* ERP-98 : ces tests pilotent une horloge mockee (ClockSensitiveTrait) plutot
|
||||
* que de dependre d'un `sleep(1)` reel. Le subscriber lit le service `clock`,
|
||||
* que `self::mockTime()` remplace par un MockClock fige au niveau du process —
|
||||
* ce qui survit aux reboots de kernel entre requetes (POST admin / PATCH bob)
|
||||
* et reste insensible a la derive d'horloge WSL2 a l'origine des flakes.
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
{
|
||||
use ClockSensitiveTrait;
|
||||
|
||||
/**
|
||||
* Fige l'horloge globale sur l'instant courant DANS LE FUSEAU PHP par
|
||||
* defaut, et la retourne pour la piloter (`sleep()`).
|
||||
*
|
||||
* Subtilite : `self::mockTime()` cree par defaut un MockClock en UTC, or
|
||||
* les colonnes `TIMESTAMP WITHOUT TIME ZONE` round-trippent via le fuseau
|
||||
* PHP (Europe/Paris). Un MockClock UTC decalerait createdAt de l'offset
|
||||
* (2h) au rechargement. On seede donc avec `new DateTimeImmutable()`
|
||||
* (fuseau par defaut), exactement comme le NativeClock en prod.
|
||||
*/
|
||||
private function freezeClock(): ClockInterface
|
||||
{
|
||||
return self::mockTime(new DateTimeImmutable());
|
||||
}
|
||||
|
||||
public function testCreatedByAdminOnPost(): void
|
||||
{
|
||||
// Horloge figee : le subscriber posera createdAt/updatedAt sur cet
|
||||
// instant exact, insensible a tout decalage d'horloge reel.
|
||||
$clock = $this->freezeClock();
|
||||
|
||||
$type = $this->createCategoryType();
|
||||
|
||||
/** @var User $admin */
|
||||
@@ -33,9 +62,7 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
self::assertNotNull($admin);
|
||||
$adminId = $admin->getId();
|
||||
|
||||
$before = new DateTimeImmutable();
|
||||
// Petit decalage pour absorber les arrondis a la seconde de Postgres.
|
||||
sleep(1);
|
||||
$before = $clock->now();
|
||||
|
||||
$client = $this->createAdminClient();
|
||||
$response = $client->request('POST', '/api/categories', [
|
||||
@@ -103,6 +130,8 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
|
||||
public function testPatchUpdatesUpdatedFieldsOnly(): void
|
||||
{
|
||||
$clock = $this->freezeClock();
|
||||
|
||||
// Etape 1 : creation par admin pour figer createdBy=admin.
|
||||
$type = $this->createCategoryType();
|
||||
$adminClient = $this->createAdminClient();
|
||||
@@ -127,9 +156,9 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
$initialUpdatedAt = $initial->getUpdatedAt();
|
||||
$initialCreatedById = $initial->getCreatedBy()->getId();
|
||||
|
||||
// Decalage temporel suffisant pour que la precision PG (seconde)
|
||||
// capte un updatedAt different.
|
||||
sleep(1);
|
||||
// Avance deterministe de l'horloge mockee : garantit un updatedAt
|
||||
// strictement superieur cote PG (precision seconde) sans sleep reel.
|
||||
$clock->sleep(1);
|
||||
|
||||
// Etape 2 : PATCH par un autre user (manager non-admin) — simule "bob".
|
||||
$manage = $this->createManageClient();
|
||||
@@ -180,6 +209,8 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
|
||||
public function testSoftDeleteAlsoUpdatesUpdatedFields(): void
|
||||
{
|
||||
$clock = $this->freezeClock();
|
||||
|
||||
// RG-1.16 : le soft delete est un UPDATE Doctrine, donc le subscriber
|
||||
// doit aussi avancer updatedAt et updatedBy en plus de poser deletedAt.
|
||||
$type = $this->createCategoryType();
|
||||
@@ -202,7 +233,8 @@ final class CategoryTimestampableBlamableTest extends AbstractCatalogApiTestCase
|
||||
$initial = $em->getRepository(Category::class)->find($createdId);
|
||||
$initialUpdatedAt = $initial->getUpdatedAt();
|
||||
|
||||
sleep(1);
|
||||
// Avance deterministe de l'horloge mockee (cf. testPatch).
|
||||
$clock->sleep(1);
|
||||
|
||||
// Soft delete par un manager non-admin.
|
||||
$manage = $this->createManageClient();
|
||||
|
||||
@@ -4,6 +4,8 @@ declare(strict_types=1);
|
||||
|
||||
namespace App\Tests\Module\Commercial\Api;
|
||||
|
||||
use App\Module\Commercial\Domain\Entity\ClientAddress;
|
||||
use App\Module\Sites\Domain\Entity\Site;
|
||||
use PhpOffice\PhpSpreadsheet\IOFactory;
|
||||
|
||||
/**
|
||||
@@ -88,6 +90,39 @@ final class ClientExportControllerTest extends AbstractCommercialApiTestCase
|
||||
self::assertNotContains('SECTEUR CO', $names);
|
||||
}
|
||||
|
||||
/**
|
||||
* ERP-100 : depuis le decouplage hydratation/selection, le QueryBuilder de
|
||||
* liste ne fetch-join plus les collections — l'export les recharge en lot via
|
||||
* hydrateListCollections(). Ce test garde que les colonnes « Catégories » et
|
||||
* « Site(s) » restent peuplees (un oubli d'hydratation les rendrait vides
|
||||
* sans erreur).
|
||||
*/
|
||||
public function testExportPopulatesCategoryAndSiteColumns(): void
|
||||
{
|
||||
$client = $this->createAdminClient();
|
||||
$seed = $this->seedClient('Hydrate Co', false, 'DISTRIBUTEUR');
|
||||
|
||||
$em = $this->getEm();
|
||||
$site = $em->getRepository(Site::class)->findOneBy([]);
|
||||
self::assertNotNull($site, 'Aucun site seede : impossible de tester la colonne Site(s).');
|
||||
|
||||
$address = new ClientAddress();
|
||||
$address->setClient($seed);
|
||||
$address->setPostalCode('86100');
|
||||
$address->setCity('Châtellerault');
|
||||
$address->setStreet('1 rue du Test');
|
||||
$address->addSite($site);
|
||||
$em->persist($address);
|
||||
$em->flush();
|
||||
|
||||
$flat = $this->flatten($this->gridFromResponse($client->request('GET', self::EXPORT_URL)->getContent()));
|
||||
|
||||
// Colonne « Catégories » : libelle de la categorie du client (getName()).
|
||||
self::assertStringContainsString('test_cli_cat_distributeur', $flat);
|
||||
// Colonne « Site(s) » : site agrege depuis l'adresse (RG-1.10).
|
||||
self::assertStringContainsString((string) $site->getName(), $flat);
|
||||
}
|
||||
|
||||
public function testSirenColumnPresentWithAccountingView(): void
|
||||
{
|
||||
// L'admin bypass le RBAC : il a donc accounting.view -> colonne SIREN.
|
||||
|
||||
@@ -14,6 +14,7 @@ use Doctrine\ORM\Event\PrePersistEventArgs;
|
||||
use Doctrine\ORM\Event\PreUpdateEventArgs;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
use Symfony\Bundle\SecurityBundle\Security;
|
||||
use Symfony\Component\Clock\MockClock;
|
||||
use Symfony\Component\Security\Core\User\UserInterface;
|
||||
|
||||
/**
|
||||
@@ -30,7 +31,7 @@ final class TimestampableBlamableSubscriberTest extends TestCase
|
||||
public function testPrePersistWithUser(): void
|
||||
{
|
||||
$user = $this->createStub(UserInterface::class);
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning($user));
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning($user), new MockClock());
|
||||
$entity = new FullAuditableFixture();
|
||||
|
||||
$subscriber->prePersist($this->prePersistArgs($entity));
|
||||
@@ -45,7 +46,7 @@ final class TimestampableBlamableSubscriberTest extends TestCase
|
||||
|
||||
public function testPrePersistWithoutUser(): void
|
||||
{
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning(null));
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning(null), new MockClock());
|
||||
$entity = new FullAuditableFixture();
|
||||
|
||||
$subscriber->prePersist($this->prePersistArgs($entity));
|
||||
@@ -59,8 +60,13 @@ final class TimestampableBlamableSubscriberTest extends TestCase
|
||||
|
||||
public function testPreUpdate(): void
|
||||
{
|
||||
$user = $this->createStub(UserInterface::class);
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning($user));
|
||||
$user = $this->createStub(UserInterface::class);
|
||||
// Horloge figee 1s apres le createdAt simule : updatedAt doit avancer
|
||||
// de facon deterministe, sans dependre de l'heure reelle.
|
||||
$subscriber = new TimestampableBlamableSubscriber(
|
||||
$this->securityReturning($user),
|
||||
new MockClock(new DateTimeImmutable('2020-01-01 10:00:01')),
|
||||
);
|
||||
|
||||
// On simule une entite deja persistee : createdAt fige dans le passe,
|
||||
// createdBy positionne par une creation anterieure.
|
||||
@@ -80,7 +86,7 @@ final class TimestampableBlamableSubscriberTest extends TestCase
|
||||
public function testPartialEntityTimestampableOnly(): void
|
||||
{
|
||||
$user = $this->createStub(UserInterface::class);
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning($user));
|
||||
$subscriber = new TimestampableBlamableSubscriber($this->securityReturning($user), new MockClock());
|
||||
$entity = new TimestampableOnlyFixture();
|
||||
|
||||
// Entite Timestampable mais NON Blamable : seules les dates sont posees,
|
||||
|
||||
Reference in New Issue
Block a user