siesa-agents 2.1.72-qa.2 → 2.1.72-qa.21

package/siesa-agents/resources/playwright-kit/.env.example

@@ -0,0 +1,42 @@
+# ============================================================
+#  Credenciales QA — Grabador v3 + Tests E2E
+#  Copia este archivo como .env y personaliza tus valores
+#  El .env es personal (gitignored), nunca se sube al repo
+# ============================================================
+
+# Credenciales de login (Modo 1: ERP SIESA)
+TEST_USER=Carlos1
+TEST_PASS=1234
+
+# URL base del ERP
+BASE_URL=https://erp-qa-beta.siesaerp.com
+
+# Base de datos a seleccionar en login (busca por texto en el combo)
+# Opciones tipicas: sqlserver, postgresql
+DB_ENGINE=sqlserver
+
+# Cultura/idioma (comentar para usar la predeterminada del ERP)
+# CULTURE=es-CO
+
+# Ruta inicial del modulo a verificar/grabar (opcional, ej: /BLSurveyDocument/)
+# Usada por seed-example.spec.ts (test de navegacion) y por el grabador.
+# START_URL=
+
+# Titulo de la suite en los reportes Allure/Monocart (opcional)
+# SUITE_TITLE=E2E — Pipeline Agentes IA
+
+# ── Modo Portal de Empleo (grabador: PORTAL_LOGIN=1) ───────────────
+# Sin defaults: deben definirse para usar el modo portal.
+# PORTAL_LOGIN=1
+# PORTAL_URL=https://portal.example.com/Login/?dat=...
+# PORTAL_USER=
+# PORTAL_PASS=
+
+# ── Ajustes de CI / timing (opcionales) ───────────────────────────
+# CI=1 lo define el runner automáticamente (headless, retries=2, junit, trace on-first-retry).
+# CI=1
+# Margen de asentamiento tras red-en-reposo + loader SDK (ms) en blazor-e2e-helpers.
+# BLAZOR_SETTLE_MS=1000
+# Timeouts de acción/navegación (ms) — subir en CI lento.
+# ACTION_TIMEOUT=30000
+# NAVIGATION_TIMEOUT=30000

package/siesa-agents/resources/playwright-kit/README.md

@@ -0,0 +1,228 @@
+# Kit Playwright + Agentes IA — Siesa
+
+## Qué es esto
+
+Kit portable para automatización E2E con agentes IA (Planner → Generator → Healer).
+Desarrollado por el equipo QA de I&D — Procesos y Calidad de Software.
+
+Validado en **9 réplicas**, 2 módulos (Encuestas + Capacitaciones), 271 tests,
+mejora de **160 min → 4 min**, 5 réplicas consecutivas sin Healer (R5-R9).
+
+## Estructura
+
+```
+playwright-agentes-ia-siesa/
+├── README.md                          ← Este archivo
+├── package.json                       ← Dependencias (npm install)
+├── playwright.config.ts               ← Configuración Playwright (Allure + Monocart)
+├── helpers/
+│   └── blazor-e2e-helpers.ts          ← 14 helpers E2E reutilizables
+├── tools/
+│   ├── locator-recorder.spec.ts            ← Grabador de Localizadores V3
+│   └── locator-overlay.js             ← UI del grabador (overlay)
+├── tests/
+│   └── seed-example.spec.ts           ← Seed: login + navegación
+├── specs/                             ← Insumos (.md generados por agente)
+├── proposed/                          ← Specs generados (pre-promoción)
+├── captured-locators/                 ← Localizadores capturados
+├── allure-results/                    ← Datos crudos Allure (auto-generados)
+├── allure-report/                     ← Reporte HTML Allure (auto-generado)
+└── monocart-report/                   ← Reporte HTML Monocart (auto-generado)
+```
+
+## Requisitos previos
+
+- Node.js 20+ (recomendado 22 LTS)
+- npm 10+
+- Git
+
+## Instalación (5 minutos)
+
+```bash
+# 1. Descomprimir y entrar
+cd playwright-agentes-ia-siesa
+
+# 2. Instalar dependencias
+npm install
+
+# 3. Instalar navegadores Playwright
+npx playwright install chromium
+
+# 4. Verificar con el seed
+TEST_USER=Carlos1 TEST_PASS=1234 npx playwright test tests/seed-example.spec.ts --headed
+```
+
+## Reportes de ejecución
+
+El kit incluye 3 reporters integrados que se generan automáticamente al ejecutar tests:
+
+| Reporter | Comando para ver | Qué muestra |
+|----------|-----------------|-------------|
+| **Allure** | `npm run report:allure` | Gráficas, timeline, steps por test, screenshots |
+| **Monocart** | `npm run report:monocart` | 348 steps detallados, logs, attachments |
+| **Playwright HTML** | `npm run report` | Reporte nativo con traces y video |
+
+Los reportes se generan automáticamente al terminar `npm test`. Para regenerar Allure:
+
+```bash
+npx allure generate allure-results -o allure-report --clean
+npx allure open allure-report
+```
+
+## Uso del Grabador de Localizadores V3
+
+El grabador permite capturar localizadores de cualquier página Blazor Server
+interactivamente, con soporte para 7 formatos de export.
+
+```bash
+# ERP principal
+npx playwright test tools/locator-recorder.spec.ts --headed --timeout 3600000
+
+# Portal de Empleo (pre-load + login automático)
+PORTAL_LOGIN=1 PORTAL_URL='https://...' npx playwright test tools/locator-recorder.spec.ts --headed --timeout 3600000
+
+# Sin login (páginas públicas)
+SKIP_LOGIN=1 START_URL='https://...' npx playwright test tools/locator-recorder.spec.ts --headed --timeout 3600000
+```
+
+### Funcionalidades del grabador
+
+| Acción | Resultado |
+|--------|-----------|
+| **Grabar** (botón) | Captura automática de clicks, fills, selects |
+| **Ctrl+Click** | Captura manual (modo inspección) |
+| **Shift+Click** | Captura elemento + hijos |
+| **Hover** | Ver localizadores del elemento en tooltip |
+| **Escape** | Minimizar/restaurar panel |
+
+### Formatos de export
+
+| Formato | Uso |
+|---------|-----|
+| **Playwright TS** | Tests Playwright ejecutables con objetos agrupados |
+| **Playwright PY** | Tests Python con sync API |
+| **Robot Framework** | SeleniumLibrary (.robot) |
+| **Cypress** | Tests Cypress (.cy.js) |
+| **Gherkin** | Escenarios BDD (.feature) |
+| **CSV** | Datos tabulares para análisis |
+| **JSON** | Datos crudos para procesamiento |
+
+## Pipeline Tri-Agente (Planner → Generator → Healer)
+
+### Flujo completo
+
+```
+1. SEED        → Login + navegación base (seed-example.spec.ts)
+2. DISCOVERY   → Grabador de Localizadores captura elementos
+3. INSUMO      → Agente convierte PDF/caso AgileTest en specs/insumo.md
+4. PLANNER     → Agente genera specs/test-plan.md
+5. GENERATOR   → Agente genera proposed/modulo-e2e.spec.ts
+6. HEALER      → Agente itera: ejecuta → analiza fallos → corrige
+7. PROMOCIÓN   → Spec validado se mueve a tests/
+```
+
+### Helpers disponibles (blazor-e2e-helpers.ts)
+
+| Helper | Descripción |
+|--------|-------------|
+| `createObsCollector()` | Observability: errores consola, HTTP 4xx/5xx, JS exceptions, dialogs |
+| `login()` | Login ERP con credenciales parametrizables |
+| `fillSDKText()` | Llenar campo DevExpress (input) |
+| `fillSDKTextArea()` | Llenar textarea |
+| `fillFechaRadzen()` | Llenar fecha Radzen (MM/DD/YYYY + Enter) |
+| `clickToolbar()` | Click toolbar (maneja botones duplicados por sidebar) |
+| `closeOverlays()` | Cerrar dialogs y notificaciones |
+| `clickActivo()` | Seleccionar estado "Activo" |
+| `waitForSave()` | Esperar loader SDK |
+| `selectEntityPopup()` | Popup lupa: dual-mode (formulario vs grid) |
+| `searchInGrid()` | Buscar en listado: dual-mode + Enter para filtro DevExpress |
+| `navigateTo()` | Navegar y esperar carga |
+| `waitForGrid()` | Esperar grid visible |
+| `getFechas()` | Generar fechas dinámicas (inicio + N días) |
+
+### Patrones Blazor Server
+
+- **Overlay `search_back_fade`**: Usar `force: true` o JS click
+- **Celda de filtro DevExpress**: Después de `.fill()` presionar `Enter` para activar binding
+- **Listados dual-mode**: Primera visita = formulario búsqueda, después = grid
+- **Toolbar duplicada**: Sidebar oculto duplica botones → usar `.last()`
+- **Entity popup dual**: Formulario (Código+Buscar) vs Grid directo (Celda de filtro)
+- **Descripción siempre textarea**: NO usar SDKCharField para descripción
+- **Pre-load SignalR**: Navegar a URL base primero para cargar recursos
+
+## Configuración por ambiente
+
+Ajustar `playwright.config.ts`:
+
+```typescript
+use: {
+  baseURL: process.env.BASE_URL || 'https://erp-qa-beta.siesaerp.com',
+}
+```
+
+Variables de entorno:
+
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `BASE_URL` | `https://erp-qa-beta.siesaerp.com` | URL base del ERP |
+| `TEST_USER` | `Carlos1` | Usuario ERP |
+| `TEST_PASS` | `1234` | Contraseña ERP |
+| `DB_ENGINE` | `sqlserver` | BD a seleccionar en el login (match por texto) |
+| `PORTAL_LOGIN` | - | `1` para login Portal de Empleo |
+| `PORTAL_URL` | - | URL del portal |
+| `PORTAL_USER` | - | Usuario del portal (sin default) |
+| `PORTAL_PASS` | - | Contraseña del portal (sin default) |
+| `SKIP_LOGIN` | - | `1` para páginas públicas |
+| `START_URL` | - | URL inicial del módulo a verificar/grabar |
+| `SUITE_TITLE` | `E2E — Pipeline Agentes IA` | Título de la suite en los reportes |
+| `CI` | - | Lo define el runner: activa headless, `retries:2`, reporter `junit` y `trace:on-first-retry` |
+| `BLAZOR_SETTLE_MS` | `1000` | Margen (ms) del helper `settle()` tras red-en-reposo + loader SDK |
+| `ACTION_TIMEOUT` | `30000` | Timeout de acción (ms) — subir en CI lento |
+| `NAVIGATION_TIMEOUT` | `30000` | Timeout de navegación (ms) — subir en CI lento |
+
+## Buenas prácticas (CI y mantenibilidad)
+
+- **Limpieza de datos de test** (H-F6-15): los specs que crean registros deben limpiarlos
+  en un hook `test.afterAll(...)` (o `afterEach`) propio del módulo —el kit no puede saber
+  qué entidades creaste—. Usa `closeOverlays(page)` para cerrar diálogos/notificaciones
+  pendientes antes de cerrar el contexto.
+- **Imports de helpers** (H-F6-16): impórtalos con ruta relativa correcta según dónde viva
+  el spec. Si dejas los specs en `tests/`, usa `../helpers/blazor-e2e-helpers`; si mueves el
+  spec a otra carpeta, ajusta la ruta. (No hay alias de path configurado en el kit.)
+- **Exit codes en CI** (H-F6-21): Playwright retorna código ≠0 si algún test falla y 0 si
+  todos pasan; tu pipeline debe usar ese exit code como gate. El `junit.xml` (activo con `CI=1`)
+  alimenta el reporte de resultados de GitHub Actions/Jenkins.
+- **Esperas** (H-F6-07): usa `settle(page)` (red-en-reposo + loader SDK + margen
+  `BLAZOR_SETTLE_MS`) en vez de `waitForTimeout()` incondicionales.
+
+## Resultados validados
+
+| Réplica | Módulo | Tests | Resultado | Tiempo Pipeline | Tiempo Ejecución |
+|---------|--------|-------|-----------|-----------------|------------------|
+| R1 | Encuestas | 20 | 20/20 PASS | ~160 min | ~8 min |
+| R3 | Encuestas | 21 | 20/21 PASS | ~40 min | 4.2 min |
+| R4 | Capacitaciones | 16 | 16/16 PASS | ~35 min | 5.2 min |
+| R5-R7 | Capacitaciones | 16 | 16/16 PASS | <15 min | ~5 min |
+| R8 | Capacitaciones | 16 | 16/16 PASS | 4 min | 4 min |
+| R9 | Capacitaciones | 16 | 16/16 PASS | 4 min | 4 min |
+
+## Equipo
+
+- **Líder QA**: Juan Manuel Reina Montoya
+- **QA HCM**: Carlos Felipe Diaz Lombana, Jose Alejandro Bravo Escobar
+- **I&D**: Equipo de Procesos y Calidad de Software, SIESA
+
+## Capacitación
+
+Si necesitas aprender o reforzar Playwright, el equipo QA mantiene un curso completo:
+
+**Playwright Academy — Siesa**
+https://playwright-training-siesa-academy.netlify.app/
+
+- 140 lecciones interactivas | 21 secciones | 55-60 horas
+- Desde fundamentos hasta CI/CD y patrones enterprise
+- Incluye secciones de Allure, Monocart, Visual Testing, API Testing
+- Contexto SIESA en ejemplos y mejores prácticas
+
+---
+*Generado automáticamente — Pipeline QA E2E v3.2 con Agentes IA*

package/siesa-agents/resources/playwright-kit/allure/categories.json

@@ -0,0 +1,26 @@
+[
+  {
+    "name": "Defecto de producto",
+    "description": "Fallo causado por un bug real en la aplicacion bajo prueba",
+    "matchedStatuses": ["failed"],
+    "messageRegex": ".*expected.*to(Be|Have|Contain|Match).*"
+  },
+  {
+    "name": "Infraestructura / Red",
+    "description": "Fallo por timeout, conexion o servidor no disponible",
+    "matchedStatuses": ["broken"],
+    "messageRegex": ".*(timeout|ECONNREFUSED|ERR_CONNECTION|net::ERR_|Navigation|502|503|504).*"
+  },
+  {
+    "name": "Selector no encontrado",
+    "description": "Elemento no visible o localizador incorrecto",
+    "matchedStatuses": ["broken"],
+    "messageRegex": ".*(waiting for (locator|selector)|strict mode violation|no element found).*"
+  },
+  {
+    "name": "Error de datos / Estado",
+    "description": "Datos de prueba incorrectos o estado inesperado de la aplicacion",
+    "matchedStatuses": ["failed"],
+    "messageRegex": ".*(already exists|duplicate|unique constraint|validation error).*"
+  }
+]

package/siesa-agents/resources/playwright-kit/global-setup.ts

@@ -0,0 +1,34 @@
+/**
+ * Global setup — genera allure/environment.properties antes de los tests.
+ * Se ejecuta una sola vez al inicio de la suite.
+ */
+import { FullConfig } from '@playwright/test';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+async function globalSetup(config: FullConfig) {
+  const dir = 'allure-results';
+  fs.mkdirSync(dir, { recursive: true });
+
+  const props = [
+    `Browser=Chromium`,
+    `Framework=Playwright ${require('@playwright/test/package.json').version}`,
+    `Node=${process.version}`,
+    `OS=${os.type()} ${os.release()}`,
+    `Base.URL=${config.projects[0]?.use?.baseURL || 'N/A'}`,
+    `Suite=${process.env.SUITE_TITLE || 'E2E — Pipeline Agentes IA'}`,
+    `Team=QA I&D — Procesos y Calidad de Software, SIESA`,
+  ].join('\n');
+
+  fs.writeFileSync(path.join(dir, 'environment.properties'), props);
+
+  // Copiar categories.json si existe
+  const catSrc = path.join(__dirname, 'allure', 'categories.json');
+  const catDst = path.join(dir, 'categories.json');
+  if (fs.existsSync(catSrc)) {
+    fs.copyFileSync(catSrc, catDst);
+  }
+}
+
+export default globalSetup;