Plan: App de Test Cases para QA

Propuesta de una nueva web app Angular dentro del monorepo de Syncc para gestión de casos de prueba, orientada al equipo de QA y personas no técnicas.

Contexto

El equipo cuenta con un QA oficial y colaboradores no técnicos.
Actualmente los test cases se gestionan en Notion.
Syncc corre en servidor propio — no depende de hosting externo.
Objetivo: migrar la gestión de QA a una herramienta integrada con el backend de Syncc.

Pros

Integración natural con el backend Ya existen los endpoints, DTOs y schema de Prisma. La app puede generar test cases pre-poblados con datos reales (rutas, conductores, vehículos) sin hardcodear fixtures.

Monorepo = reutilización inmediata Tipos TypeScript compartidos, mismo environment.ts, mismo pipeline de CI. Sin repo aparte ni configuración duplicada.

Automatización progresiva Se empieza escribiendo casos manualmente. Los mismos registros en DB se convierten en fuente de verdad para tests automatizados en una fase posterior.

Centraliza la cobertura Un panel que muestra qué features tienen test cases escritos y cuáles no es útil para un equipo que no puede cubrir todo a la vez.

Acceso para no técnicos Una interfaz web es más accesible que archivos YAML/JSON o un repo de GitHub para el perfil QA y colaboradores no técnicos.

Contras / Riesgos

Nueva app = nueva deuda de mantenimiento Sería la cuarta app Angular en el monorepo. Requiere deploy, actualizaciones y atención continua.

Acoplamiento con el backend Los test cases deberían poder consultarse incluso si el backend está en una versión distinta o caído. Hay que diseñar el acoplamiento con cuidado.

Integraciones externas son scope posterior SonarQube y herramientas similares están pensadas para análisis estático a escala empresarial. Integrarlas en v1 añade complejidad sin retorno inmediato.

Alcance recomendado — v1 (mes 1)

Feature	Descripción
CRUD de Test Cases	Título, descripción, pasos, resultado esperado
Vinculación con entidades	Asociar casos a líneas, conductores, vehículos, etc.
Estado de ejecución manual	Pasó / Falló / Bloqueado / Pendiente
Panel de cobertura	Vista por módulo: cuántos casos existen y cuál es su estado
Autenticación	Reutilizar el auth existente del backend (roles SUPER_ADMIN / QA)

Fuera de scope v1

Integración con SonarQube u otras herramientas externas → v2
Automatización de ejecución de tests → v3
Reportes exportables (PDF/Excel) → v2

Condición crítica

Este desarrollo no debe bloquear ni retrasar features activas del producto principal (conductores, pasajeros, admin). Debe ser trabajo paralelo con capacidad separada.

Próximos pasos

Confirmar disponibilidad de capacidad para el mes siguiente sin afectar roadmap principal.
Sesión de planificación técnica: definir rutas del backend necesarias, estructura de la app en el monorepo y modelo de datos.
Crear la app apps/qa-portal en el monorepo.
Implementar v1 en iteraciones de 1 semana.

Documento generado: 2026-07-07