automation-arqc es la suite de automatización E2E oficial del Sistema de Gestión Tributaria Pasto. Construida sobre Playwright 1.59, cubre el módulo Reteica en su totalidad: Terceros, Contribuyentes, Establecimientos, Conceptos y Declaraciones. Cada prueba está escrita con sintaxis BDD usando gherkin-lite, sigue el patrón Page Object Model (POM) para máxima reutilización, genera reportes visuales con Allure Reports y se ejecuta automáticamente desde un pipeline Jenkins parametrizado que tarda menos de 45 minutos de extremo a extremo.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.
Objetivos
La suite está diseñada para garantizar tres niveles de cobertura sobre el sistema tributario:- Flujos E2E completos — Simulan el recorrido real de un usuario a través de varias pantallas; por ejemplo, crear un contribuyente, asignarle un establecimiento y registrar su primera declaración de Reteica en un único flujo encadenado.
- Operaciones CRUD — Verifican que cada módulo permite crear, leer, actualizar y eliminar registros correctamente, incluyendo los mensajes de confirmación y los estados visibles en tabla.
- Validación de reglas de negocio — Comprueban que el sistema aplica correctamente restricciones tributarias: campos obligatorios, formatos de NIT, vigencias de periodos, cálculo de tasas y límites en conceptos de Reteica.
Stack tecnológico
Playwright
Framework de automatización E2E. Versión ^1.59.1. Proporciona el runner, las assertions, los fixtures nativos y las herramientas de depuración (trace viewer, UI mode).
gherkin-lite
Librería que añade sintaxis BDD (
Given / When / Then) sobre Playwright sin necesidad de Cucumber. Versión ^1.1.0. Permite escribir specs legibles por negocio manteniendo el ecosistema nativo de Playwright.Allure Reports
Reporte principal de la suite.
allure-playwright ^3.7.1 escribe resultados en allure-results/; la CLI 2.x los convierte en un portal HTML interactivo con historial, categorías y pasos detallados.Jenkins CI/CD
Pipeline declarativo (
Jenkinsfile) que corre en el agente automatico_196 con Node 20. Admite cuatro modos de ejecución (auto, smoke, regression, all) y publica el reporte Allure como artefacto del build.Módulos cubiertos
Los specs se ubican ensuites/Reteica/ y cada módulo tiene su propio Page Object en pages/modulos/reteica/.
Terceros — CRUD + validaciones
Terceros — CRUD + validaciones
Cubre la pantalla de administración de terceros del módulo Reteica. Los tests verifican el ciclo completo de alta, búsqueda, edición y eliminación, así como las validaciones de formato sobre el NIT/documento y los campos obligatorios del formulario.
- Spec:
suites/Reteica/terceros.spec.js - Page Object:
pages/modulos/reteica/archivos/terceros.page.js - Plan:
specs/terceros-plan.md - Tag:
@componente
Contribuyentes — CRUD + establecimientos
Contribuyentes — CRUD + establecimientos
Valida el formulario principal de contribuyentes y el subformulario de establecimientos asociados. Los fixtures de Reteica (
fixtures/reteica/contribuyente.fixture.js) pre-crean un contribuyente para que los tests de establecimientos puedan arrancar con datos conocidos.- Specs:
suites/Reteica/contribuyentes.spec.js,suites/Reteica/establecimientos.spec.js - Page Objects:
contribuyentes.page.js,establecimientos.page.js - Planes:
specs/contribuyentes-plan.md,specs/establecimientos-contribuyentes-plan.md - Tag:
@componente
Declaraciones — flujo E2E completo
Declaraciones — flujo E2E completo
Flujo de extremo a extremo que recorre la creación de un contribuyente, la asignación de un establecimiento y la presentación de una declaración de Reteica. Utiliza el page object
presentar-declaracion.page.js y reutiliza los POMs de las pantallas anteriores sin duplicar código.- Spec:
suites/Reteica/e2e/flujo-declaracion-contribuyente.spec.js - Page Object:
pages/modulos/reteica/contribuyentes/menu-procesos-contribuyentes/presentar-declaracion.page.js - Tag:
@e2e
Conceptos — CRUD y configuración de tasas
Conceptos — CRUD y configuración de tasas
Tests de la pantalla de conceptos de Reteica. Verifican que se pueden crear y editar los conceptos tributarios que luego se referencian en las declaraciones, incluyendo la validación de rangos de tasa mínima y máxima.
- Spec:
suites/Reteica/conceptos.spec.js - Page Object:
pages/modulos/reteica/archivos/conceptos.page.js - Plan:
specs/conceptos-plan.md - Tag:
@componente
Convención de etiquetas
Cada test lleva al menos una etiqueta que determina en qué modo de pipeline se ejecuta:| Etiqueta | Uso |
|---|---|
@smoke | Sanity check rápido — corre en cada push a cualquier rama |
@regression | Suite completa — corre en merge a main / develop |
@e2e | Flujos que cruzan varias pantallas (directorio suites/Reteica/e2e/) |
@componente | Tests de una sola pantalla (CRUD básico en suites/Reteica/) |
--grep de Playwright, por ejemplo: npx playwright test --grep "@regression".
Empezar en 5 pasos →
¿Listo para ejecutar tu primer test? Sigue la guía de Quickstart para clonar el repositorio, configurar credenciales y lanzar la suite en menos de 10 minutos.