Skip to main content

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.

automation-arqc es la suite de automatización end-to-end del Sistema de Gestión Tributaria municipal. Cubre los módulos de Reteica (Terceros, Contribuyentes, Establecimientos, Conceptos y Declaraciones) mediante Playwright, con arquitectura Page Object Model, fixtures con ciclo de vida completo, sintaxis BDD con gherkin-lite y un pipeline Jenkins parametrizado para entornos de CI/CD.

Introducción

Conoce la arquitectura del proyecto, sus objetivos y cómo está organizado.

Quickstart

Clona el repositorio, instala dependencias y ejecuta tu primer test en minutos.

Configuración

Variables de entorno, credenciales y parámetros de Playwright.

Guía de Ejecución

Todos los comandos npm disponibles y cómo filtrar tests por tag o módulo.

Lo que encontrarás en esta documentación

Arquitectura

Estructura de carpetas, Page Objects, fixtures y suites de prueba.

Escritura de Tests

Convenciones BDD, etiquetado y cómo crear nuevos specs.

Autenticación

Caché de sesión con sessionStorage y global setup/teardown.

Reportes

Allure, HTML de Playwright, trazas, capturas y videos en fallo.

Pipeline Jenkins

Etapas, modos Libre y Despliegue, y detección inteligente de cambios.

Referencia de API

Documentación de todos los Page Objects y fixtures reutilizables.

Inicio rápido

1

Instalar dependencias

git clone http://172.16.1.225/sysman-automation/proyecto-automatizacion/automation-arqc.git
cd automation-arqc
npm ci
npx playwright install chromium
2

Configurar credenciales

Copia .env.example a .env y rellena BASE_URL, USER_ADMIN y PASS_ADMIN.
cp .env.example .env
3

Generar sesión de autenticación

node playwright/global-setup.js
Esto crea playwright/.auth/user.json con la sesión cacheada y válida por 8 horas.
4

Ejecutar los tests

npm run test
Al finalizar, genera el reporte Allure con npm run report:generate.
En CI (Jenkins), el global-setup se ejecuta automáticamente como parte del pipeline. No es necesario generarlo manualmente en entornos de integración continua.

Build docs developers (and LLMs) love