Al finalizar esta guía tendrás automation-arqc instalado y corriendo contra el Sistema de Gestión Tributaria Pasto. Verás los resultados en la consola en tiempo real y, en menos de 10 minutos, podrás abrir el reporte Allure con el estado de cada prueba del módulo Reteica.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Giofelix/Proyecto-automatizacion-Empresa/llms.txt
Use this file to discover all available pages before exploring further.
Prerrequisitos
Asegúrate de tener las siguientes herramientas instaladas antes de continuar:| Herramienta | Versión mínima | Cómo instalar |
|---|---|---|
| Node.js | 20 LTS | nodejs.org — descarga el instalador LTS |
| Git | cualquiera | git-scm.com |
| Allure CLI | 2.x | npm install -g allure-commandline |
Instalación
Clonar el repositorio
Clona el repositorio desde el GitLab interno y entra al directorio del proyecto:
El repositorio está alojado en el GitLab corporativo. Necesitas estar conectado a la red interna o a la VPN para poder clonarlo.
Instalar dependencias y navegador
Instala todos los paquetes npm con el lock-file exacto, y luego descarga el binario de Chromium gestionado por Playwright:
npm ci (en lugar de npm install) garantiza que las versiones instaladas coinciden exactamente con package-lock.json, lo que evita diferencias entre entornos. El paso playwright install chromium descarga el navegador en la caché local de Playwright (~/.cache/ms-playwright) — en CI esta caché se reutiliza entre builds.Configurar credenciales en .env
Copia la plantilla de variables de entorno y rellena los valores reales:Abre
.env en tu editor y completa las siguientes variables:| Variable | Obligatoria | Descripción | Ejemplo |
|---|---|---|---|
BASE_URL | ✅ Sí | URL base de la aplicación, sin barra al final | http://172.17.1.214:9080/pasto/ |
USER_ADMIN | ✅ Sí | Usuario administrador para autenticación | admin |
PASS_ADMIN | ✅ Sí | Contraseña del usuario administrador | s3cr3t |
TIMEOUT | ⬜ No | Tiempo de espera en ms (por defecto: 30000) | 30000 |
ENV | ⬜ No | Entorno destino (por defecto: desarrollo) | desarrollo |
Generar la sesión de autenticación
Ejecuta el script de configuración global para que Playwright haga login una sola vez y guarde la sesión:Este comando realiza el flujo de autenticación Angular en dos pasos y escribe el estado de
sessionStorage en playwright/.auth/user.json. Todos los tests que arrrancan desde paginaAutenticada reutilizan ese archivo en lugar de hacer login por separado.- En local: la sesión se reutiliza si tiene menos de 8 horas de antigüedad, acelerando las ejecuciones repetidas del mismo día.
- En CI:
global-setup.jsse invoca automáticamente antes de cada build (está declarado enplaywright.config.js), por lo que siempre parte de una sesión fresca.
En el pipeline de Jenkins no necesitas ejecutar este comando manualmente. El runner lo llama como parte de la etapa “Ejecución de Pruebas”.
Ejecutar los tests y abrir el reporte
Lanza la suite completa y genera el reporte Allure con dos comandos:El primer comando invoca
npx playwright test, que lee la configuración de playwright.config.js y ejecuta todos los specs de suites/. El segundo genera el portal HTML de Allure a partir de allure-results/ y lo abre automáticamente.Otros comandos útiles para el día a día:Configuración avanzada
Referencia completa de variables de entorno y todos los parámetros de
playwright.config.js: timeouts, workers, artefactos en fallo y diferencias entre local y CI.Ejecutar y filtrar tests
Aprende a usar tags, filtros
--grep, modos de ejecución y a interpretar los resultados de Allure y el trace viewer de Playwright.