Add dama/doctrine-test-bundle for faster Behat test isolation

Replaces per-scenario schema drop/create with DAMA's transaction-rollback
approach. EnableForeignKeys middleware registered at priority 101 (above
DAMA's 100) so PRAGMA foreign_keys=ON fires before the outer BEGIN
TRANSACTION, keeping SQLite ON DELETE SET NULL cascades functional.

Author: silverbackdan

CLAUDE.md

@@ -26,15 +26,15 @@ Companion project: **CWA Nuxt Module** (`@cwa/nuxt`) — the frontend that consu
 
 ```bash
 # Unit tests
-bin/phpunit
+php -d memory_limit=256M vendor/bin/phpunit
 
 # Integration tests (Behat)
-bin/behat
+php -d memory_limit=256M vendor/bin/behat
 
 # Database setup for tests
-bin/console -e test doctrine:database:create
-bin/console -e test doctrine:migrations:migrate --no-interaction
-bin/console -e test doctrine:schema:validate
+php tests/Functional/app/bin/console -e test doctrine:database:create
+php tests/Functional/app/bin/console -e test doctrine:migrations:migrate --no-interaction
+php tests/Functional/app/bin/console -e test doctrine:schema:validate
 ```
 
 Behat features live in `features/`. PHPUnit tests in `tests/`. Behat coverage is more extensive than unit — prefer adding Behat scenarios for new API behaviour, unit tests for pure logic.
@@ -164,6 +164,14 @@ This means:
 5. **`/_/resource_manifest/{id}` unified endpoint** — `ResourceManifest` DTO (`src/ApiResource/ResourceManifest.php`) with `ResourceManifestStateProvider` resolving route paths (starts with `/`) or UUIDs (Page then AbstractPageData). `ResourceManifestVoter` delegates access control to `RouteVoter` or `AbstractRoutableVoter`. `ResourceManifestNormalizer` produces `{ "resource_iris": string[][] }` using the shared `ManifestDepthGroupTrait`.
 6. **`ManifestDepthGroupTrait`** (`src/Serializer/Normalizer/Trait/ManifestDepthGroupTrait.php`) — `buildDepthGroups`, `collectCurrentDepth`, `shouldSkipIri` extracted and shared between `RouteNormalizer` and `ResourceManifestNormalizer`
 
+### Outstanding — `parentPage` in standard Page read group
+
+**Requirement (discovered 2026-06-15):** The Nuxt module's admin parent-page picker must filter out descendants of the current page to prevent circular parent chains (e.g. A → B → A). The picker is populated from `GET /_/pages` (via `useParentPageLoader`). To detect descendants client-side, each page in that collection response must include its own `parentPage` IRI.
+
+Currently `parentPage` is only in `Route:manifest:read`. It needs to be added to whatever serialization group drives the `/_/pages` collection read (e.g. `Page:read` or a shared `AbstractPage:read` group). This satisfies the principle of least exposure — there is a concrete consumer (the admin picker descendant-filter).
+
+A Behat test should cover: `GET /_/pages` response includes `parentPage` for a page that has one set.
+
 ### Design decisions
 
 - **No `$nested` boolean** — parent = nested, full stop. The presence of `$parentPage`/`$parentPageData` is the complete signal.

composer.json

@@ -65,6 +65,7 @@
         "behat/behat": "^3.13",
         "behat/mink": "*",
         "behatch/contexts": "dev-master",
+        "dama/doctrine-test-bundle": "^8.6",
         "doctrine/doctrine-fixtures-bundle": "^4.3",
         "friends-of-behat/mink-browserkit-driver": "^1.6",
         "friends-of-behat/mink-extension": "^2.7",

features/bootstrap/DoctrineContext.php

@@ -19,7 +19,7 @@
 use Behat\Mink\Exception\ExpectationException;
 use Behat\MinkExtension\Context\MinkContext;
 use Behatch\Context\RestContext as BehatchRestContext;
-use Doctrine\ORM\Tools\SchemaTool;
+use DAMA\DoctrineTestBundle\Doctrine\DBAL\StaticDriver;
 use Doctrine\Persistence\ManagerRegistry;
 use Doctrine\Persistence\ObjectManager;
 use Lexik\Bundle\JWTAuthenticationBundle\Encoder\JWTEncoderInterface;
@@ -67,9 +67,7 @@ final class DoctrineContext implements Context
     private IriConverterInterface $iriConverter;
     private TimestampedDataPersister $timestampedHelper;
     private ObjectManager $manager;
-    private SchemaTool $schemaTool;
     private UserPasswordHasherInterface $passwordHasher;
-    private array $classes;
     private JWTEncoderInterface $jwtEncoder;
     private JsonContext $jsonContext;
 
@@ -87,18 +85,19 @@ public function __construct(ManagerRegistry $doctrine, JWTTokenManagerInterface
         $this->iriConverter = $iriConverter;
         $this->timestampedHelper = $timestampedHelper;
         $this->manager = $doctrine->getManager();
-        $this->schemaTool = new SchemaTool($this->manager);
-        $this->classes = $this->manager->getMetadataFactory()->getAllMetadata();
         $this->passwordHasher = $passwordHasher;
         $this->jwtEncoder = $jwtEncoder;
     }
 
     /**
      * @BeforeSuite
      */
-    public static function clearAppCache(): void
+    public static function prepareTestSuite(): void
     {
         exec('php tests/Functional/app/bin/console cache:clear --env=test --no-warmup');
+        exec('php tests/Functional/app/bin/console doctrine:database:drop --force --env=test 2>/dev/null; true');
+        exec('php tests/Functional/app/bin/console doctrine:database:create --env=test');
+        exec('php tests/Functional/app/bin/console doctrine:schema:create --env=test');
     }
 
     /**
@@ -115,11 +114,20 @@ public function gatherContexts(BeforeScenarioScope $scope): void
     /**
      * @BeforeScenario
      */
-    public function createDatabase(): void
+    public function setupDatabase(): void
     {
-        $this->schemaTool->dropSchema($this->classes);
-        $this->doctrine->getManager()->clear();
-        $this->schemaTool->createSchema($this->classes);
+        StaticDriver::setKeepStaticConnections(true);
+        StaticDriver::beginTransaction();
+        $this->manager->clear();
+    }
+
+    /**
+     * @AfterScenario
+     */
+    public function rollbackDatabase(): void
+    {
+        StaticDriver::rollBack();
+        $this->manager->clear();
     }
 
     private function login(array $roles = [], $useAuthHeader = false): void

tests/Functional/app/config/bundles.php

@@ -25,6 +25,7 @@
     Silverback\ApiComponentsBundle\SilverbackApiComponentsBundle::class => ['all' => true],
     Nelmio\CorsBundle\NelmioCorsBundle::class => ['all' => true],
     Cocur\Slugify\Bridge\Symfony\CocurSlugifyBundle::class => ['all' => true],
+    DAMA\DoctrineTestBundle\DAMADoctrineTestBundle::class => ['test' => true],
     FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle::class => ['test' => true],
     Silverback\ApiComponentsBundle\Tests\Functional\TestBundle\TestBundle::class => ['test' => true],
     Symfony\Bundle\MercureBundle\MercureBundle::class => ['all' => true],

tests/Functional/app/config/packages/doctrine.yaml

@@ -2,7 +2,7 @@ doctrine:
     dbal:
         driver: 'pdo_sqlite'
         path: '%kernel.cache_dir%/../../db.sqlite'
-        charset:  'UTF8'
+        charset: 'UTF8'
     orm:
         naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
         auto_mapping: false

tests/Functional/app/config/services_test.yaml

@@ -3,6 +3,10 @@ services:
         autowire: true
         autoconfigure: true
 
+    Doctrine\DBAL\Driver\AbstractSQLiteDriver\Middleware\EnableForeignKeys:
+        tags:
+            - { name: doctrine.middleware, priority: 101 }
+
     Silverback\ApiComponentsBundle\Features\Bootstrap\:
         resource: '../../../../features/bootstrap/*'