> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Estrategia de pruebas

Comprende qué establecen las comprobaciones deterministas, de navegador, de base de datos y de proveedores.

## Configuración y ajustes

Antes de cualquier paso, lea [Antes de comenzar](https://supastack.dev/es/docs/web/before-you-start.md) y [Conceptos básicos del terminal](https://supastack.dev/es/docs/web/terminal-basics.md). Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.

1. Abra el paquete raíz del repositorio.json para ver los comandos de verificación.

2. Desde esa carpeta raíz, ejecute corepack pnpm test para pruebas unitarias automatizadas, luego corepack pnpm --filter @supastack/web typecheck para verificaciones de Web TypeScript.

3. Para conocer el comportamiento del navegador, inicie la aplicación web y ejecute corepack pnpm test:e2e. Esperado: cada comando informa su propio resultado; una prueba unitaria no prueba que una base de datos, un proveedor de pagos, un servicio de correo electrónico o un teléfono real funcionen.

La suite de pruebas predeterminada usa adaptadores fake/local deterministas. Las pruebas de navegador cubren interacciones de usuario; la aceptación de base de datos y las pruebas rápidas de proveedores externos son comprobaciones separadas. Ejecuta las pertinentes para el comportamiento modificado antes de ampliar el alcance.

```
corepack pnpm test
corepack pnpm check
corepack pnpm build
corepack pnpm test:e2e
corepack pnpm test:e2e:production
```


## Comandos para copiar

Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.

```
corepack pnpm test
corepack pnpm --filter @supastack/web typecheck
corepack pnpm test:e2e
```


## Flujo de implementación

Para cambios de comportamiento, primero escribe una prueba de aceptación que falle. Combina un acceso correcto con solicitudes anónimas y entre espacios de trabajo denegadas. En los flujos de formulario y tarea, verifica la carga, los errores y la recuperación, además del caso satisfactorio.

Una respuesta de navegador interceptada demuestra que la interfaz responde a ese dato de prueba. No demuestra persistencia de autenticación, procesamiento de pagos, entrega de proveedores ni callback desde un dispositivo físico.


## Verificación y solución de problemas

Si una prueba de base de datos dice que se omitió, configure su base de datos de prueba aislada antes de informar la cobertura de la base de datos. Si una pestaña web está en el puerto 3001, es el servidor apps/docs independiente; la aplicación web del kit se inicia en el puerto 3000. Si Playwright falla en su primera ejecución de Windows, deje que finalice la instalación del navegador y vuelva a ejecutar el comando que falla; nunca desactive la seguridad de todo el sistema para solucionarlo.

Si se omite una prueba que requiere base de datos, configura su base de datos aislada antes de afirmar que esa comprobación pasó. Si el ejecutor de navegador muestra aserciones correctas, pero se bloquea durante la limpieza, informa de ambos hechos: un proceso atascado no equivale a un comando completado correctamente.

En Windows, la ejecución inicial del navegador puede agotar el tiempo de espera mientras Defender analiza las dependencias o navegadores Playwright recién instalados. Deje que finalice la instalación, vuelva a ejecutar la suite fallida con corepack pnpm test:e2e o corepack pnpm test:e2e:production e inspeccione su seguimiento y el historial de protección de Defender si vuelve a fallar. Deje habilitada la protección de todo el sistema.

El conjunto de navegadores locales posee el puerto 3100 y se niega a reutilizar un proceso que ya escucha allí. Configure PLAYWRIGHT_PORT en un puerto libre antes de corepack pnpm test:e2e si otra aplicación posee 3100; esto evita que las pruebas se dirijan silenciosamente a otro proyecto.


## Siguiente

[Lista de comprobación de despliegue](https://supastack.dev/es/docs/web/deployment.md)