Testing

Backend — Tests de integración

60+ specs de tests de integración en api/test/integration/, agrupados por área funcional. Inventario completo y motivación de cada suite en internal/tests-backend.md. Categorías principales:

Área	Cobertura
Entidades CRUD	accounts, dossiers, tasks, documents, account-types, dossier-types, document-types, tenants, users, scheduled-reports
Seguridad	guards, permisos, JWT, ACL fino, audit chain
Integraciones	/credentials, /endpoints, /external-systems, ejecuciones, import cURL / Swagger, SOAP inbound (WSDL + WS-Security)
Configuración	parámetros, bootstrap idempotente, env-check, KC realm + roles
Flujos	dossier-flow + doc-flow Layer 2 + nodos (incluyendo ai_assistant_review) + flow-timeout
Bandeja y tareas	inbox saved views, task counts, task activity timeline
Shares	CRUD, provisioning, ConnectionInfo, WebDAV / SFTP / Samba / S3 SigV4
MIME y procesamiento	mime-handlers, mime-indexer tiered, specialized-processors, indexation-tasks
AI y RAG	/ai/chat (SSE), conversaciones, settings, /rag/query, reindex, LLM Router con budget
Reportes y bulk	scheduled-reports, bulk-import CSV/XLSX, data-export tenant
Dashboards	CRUD, visibilidad por rol, reverse proxy a Grafana con auth-proxy
Observabilidad	bootstrap del SDK OTel, métricas manuales, stock metrics, health checks
Admin	reset-database, queue admin, tenant reseed
Filters	column filters tipados sobre todas las entidades

Comando: cd api && pnpm test:e2e (requiere Docker services corriendo)

Frontend — Playwright E2E

44 specs end-to-end en tests/frontend/flows/, cubriendo el flujo de usuario completo en cada área del producto. Inventario completo en internal/tests-frontend.md. Cobertura por área:

• Login y auth (login 2-step, SSO, refresh)
• Bandeja de tareas (vistas guardadas, filtros, scope mine/team/all/due/overdue)
• Explorador de expedientes y documentos (visores inline)
• Doc-flow Layer 2 con nodos extract_with_processor, manual_review_extracted_fields, ai_assistant_review
• Editor visual de flujos
• Tipos de expediente / documento / cuenta + metadata schemas
• Shares (creación, instrucciones de conexión por protocolo)
• Asistente AI conversacional + RAG
• Administración de roles, permisos, parámetros
• Dashboards embebidos

Comando: cd tests/frontend && pnpm test

Política de testing

• Todo cambio DEBE incluir test nuevo o actualización en el mismo commit.
• Tests nuevos nunca se marcan como .skip.
• Si un test falla, se arregla antes de commitear.
• Fuente de verdad: internal/tests-backend.md y internal/tests-frontend.md.