test: expand Admin v2 coverage matrix

Author: c15k0

docs/ui-development.md

@@ -40,6 +40,32 @@ docker compose --profile swoole --profile e2e run --rm --no-deps ui-e2e-static
 docker compose --profile swoole up -d --force-recreate php-swoole ui
 ```
 
+Para Admin 2.0 la matriz se ejecuta sin modificar `config/config.json`:
+
+```sh
+# Unitarios y cobertura de Angular (reporte V8).
+docker exec psfs-ui-1 npm run test:admin:coverage
+
+# Contratos PHP nuevos, incluida la resolución del WebSocket HMR.
+docker exec -e XDEBUG_MODE=coverage psfs-php-1 php vendor/bin/phpunit \
+  --testsuite default --filter 'AdminFrontend|UiDevelopmentProxyResolver|UiDevelopmentWebSocketBridge'
+
+# PHP-FPM + paquete estático: todos los flujos administrativos reales.
+docker compose --profile swoole --profile e2e run --rm --no-deps \
+  -e PSFS_E2E_BASE_URL=http://php:8080 ui-e2e \
+  sh -lc 'npm ci && npm run test:e2e:admin -- --reporter=line'
+
+# Swoole/watch: HMR del Admin a través del mismo origen PSFS.
+docker compose --profile swoole --profile e2e run --rm --no-deps ui-e2e \
+  sh -lc 'npm ci && npm run test:e2e:admin:hmr -- --reporter=line'
+
+# Swoole/build: deep-link SPA y assets con Node desconectado.
+ADMIN_UI_DEV_UPSTREAM= UI_DEV_UPSTREAM= docker compose --profile swoole up -d --force-recreate php-swoole
+docker compose --profile swoole --profile e2e run --rm --no-deps ui-e2e \
+  sh -lc 'npm ci && npx playwright test e2e/admin-v2-static.spec.mjs --reporter=line'
+docker compose --profile swoole up -d --force-recreate php-swoole
+```
+
 Con `ui.path=/ui` ya configurado, abrir
 `http://admin:admin@localhost:8011/ui/`. La URL debe conservar el puerto
 `8011` y renderizar `PSFS UI POC · HMR verificado`.

tests/controller/AdminFrontendRoutesControllerTest.php

@@ -3,16 +3,24 @@
 namespace PSFS\tests\controller;
 
 use PHPUnit\Framework\TestCase;
+use PSFS\base\Router;
 use PSFS\base\Security;
 use PSFS\base\exception\ApiException;
 use PSFS\controller\AdminFrontendRoutesController;
 
 class AdminFrontendRoutesControllerTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        Router::dropInstance();
+        Router::getInstance()->hydrateRouting();
+    }
+
     protected function tearDown(): void
     {
         Security::setTest(false);
         Security::dropInstance();
+        Router::dropInstance();
     }
 
     public function testRoutesEndpointReturnsTheRouterCatalogWithoutHtml(): void
@@ -26,21 +34,13 @@ public function testRoutesEndpointReturnsTheRouterCatalogWithoutHtml(): void
 
     public function testDocumentationIndexReturnsTheKnownDomainsAsAnEnvelope(): void
     {
-        $response = (new AdminFrontendRoutesControllerProbe())->documentation();
-
-        self::assertStringContainsString('"ok":true', $response);
-        self::assertStringContainsString('"domains"', $response);
-        self::assertStringContainsString('"documentPaths"', $response);
-        self::assertStringContainsString('/CLIENT/api/doc', $response);
-        self::assertStringNotContainsString('<html', strtolower($response));
-    }
-
-    public function testDocumentationDomainAcceptsTheDomainPublishedByTheIndex(): void
-    {
-        $response = (new AdminFrontendRoutesControllerProbe())->documentationDomain('client');
+        $response = json_decode((new AdminFrontendRoutesControllerProbe())->documentation(), true, 512, JSON_THROW_ON_ERROR);
 
-        self::assertStringContainsString('"ok":true', $response);
-        self::assertStringContainsString('"openapi"', $response);
+        self::assertTrue($response['ok']);
+        self::assertNotEmpty($response['data']['domains']);
+        foreach ($response['data']['domains'] as $domain) {
+            self::assertSame('/' . strtoupper($domain) . '/api/doc', $response['data']['documentPaths'][$domain]);
+        }
     }
 
     public function testDocumentationDomainReturnsTheV2EnvelopeForAnUnknownDomain(): void

ui/e2e/admin-v2-config.spec.mjs

@@ -5,13 +5,13 @@ test('carga la configuración segura, conserva el secreto vacío y bloquea un re
   await page.goto('/admin-v2/config');
   await config;
 
-  await expect(page.getByRole('heading', { name: 'Configuración general' })).toBeVisible();
+  await expect(page.getByRole('heading', { name: /^(Configuración general|General configuration)$/ })).toBeVisible();
   await expect(page.locator('iframe')).toHaveCount(0);
   await expect(page.locator('input[type="password"]')).toHaveCount(1);
   await expect(page.locator('input[type="password"]')).toHaveValue('');
-  await page.getByRole('button', { name: 'Añadir parámetro' }).click();
+  await page.getByRole('button', { name: /^(Añadir parámetro|Add parameter)$/ }).click();
   const extraKey = page.locator('input[list="config-suggestions"]');
-  const extraValue = page.getByLabel('Valor del parámetro');
+  const extraValue = page.getByLabel(/^(Valor del parámetro|Parameter value)$/);
   await expect(extraKey).toBeVisible();
   await extraKey.fill('custom.runtime.flag');
   await expect(extraKey).toHaveValue('custom.runtime.flag');
@@ -20,6 +20,6 @@ test('carga la configuración segura, conserva el secreto vacío y bloquea un re
   await expect(extraValue).toBeFocused();
 
   await page.locator('input#db\\.host').fill('');
-  await page.getByRole('button', { name: 'Guardar configuración' }).click();
+  await page.locator('form.dynamic-form .button--primary').click();
   await expect(page.locator('input#db\\.host')).toHaveClass(/ng-invalid/);
 });

ui/e2e/admin-v2-modules.spec.mjs

@@ -24,5 +24,5 @@ test('carga el generador nativo y rechaza una generación inválida sin escribir
   });
   await page.locator('a[href="/admin-v2/config"]').click();
   await config;
-  await expect(page.getByRole('heading', { name: 'Configuración general' })).toBeVisible();
+  await expect(page.getByRole('heading', { name: /^(Configuración general|General configuration)$/ })).toBeVisible();
 });

ui/e2e/admin-v2.spec.mjs

@@ -57,7 +57,7 @@ test('regenera rutas desde Admin 2.0 sin responder con error de servidor', async
   const response = await regenerated;
 
   expect(response.status()).toBe(200);
-  await expect(page.locator('.notice--success')).toContainText('Rutas regeneradas.');
+  await expect(page.locator('.notice--success')).toContainText(/^(Rutas regeneradas\.|Routes generated successfully)$/);
 });
 
 test('mantiene una configuración usable y estilizada en móvil', async ({ page }) => {
@@ -66,13 +66,13 @@ test('mantiene una configuración usable y estilizada en móvil', async ({ page
   await page.goto('/admin-v2/config');
   await config;
 
-  const navigationToggle = page.getByRole('button', { name: 'Abrir navegación' });
+  const navigationToggle = page.getByRole('button', { name: /^(Abrir navegación|Open navigation)$/ });
   await expect(navigationToggle).toBeVisible();
   await navigationToggle.click();
-  await expect(page.getByRole('button', { name: 'Cerrar navegación' })).toHaveAttribute('aria-expanded', 'true');
+  await expect(page.getByRole('button', { name: /^(Cerrar navegación|Close navigation)$/ })).toHaveAttribute('aria-expanded', 'true');
   await expect(page.locator('.admin-sidebar')).toHaveClass(/admin-sidebar--open/);
-  await page.getByRole('button', { name: 'Cerrar navegación' }).click();
-  await expect(page.getByRole('button', { name: 'Abrir navegación' })).toHaveAttribute('aria-expanded', 'false');
+  await page.getByRole('button', { name: /^(Cerrar navegación|Close navigation)$/ }).click();
+  await expect(page.getByRole('button', { name: /^(Abrir navegación|Open navigation)$/ })).toHaveAttribute('aria-expanded', 'false');
 
   await expect(page.locator('.page')).toBeVisible();
   await expect(page.locator('.page-header')).toBeVisible();