comandos.md

Comandos

Todos los comandos se corren desde web-app/.

Servidor de desarrollo

Para correr el servidor de desarrollo:

npm run dev

El comando npm run dev levanta la app en http://localhost:3000/.

Despliegue

Para compilar la aplicación:

npm run build

El comando npm run build genera la carpeta .next con el build de producción. Para servir ese build en local:

npm run start

Base de datos (Prisma)

El esquema está en prisma/schema.prisma y la configuración en prisma.config.ts (Prisma la carga sola).

Para explorar y editar los datos con una interfaz web:

npx prisma studio

El comando npx prisma studio abre un panel en http://localhost:5555/ para ver y modificar las filas de cada tabla.

Para regenerar el cliente de Prisma después de tocar el esquema (no modifica la base):

npx prisma generate

Para validar o dar formato al esquema:

npx prisma validate
npx prisma format

Para crear y aplicar una migración en desarrollo:

npx prisma migrate dev --name <nombre>

Para aplicar las migraciones pendientes (CI / producción):

npx prisma migrate deploy

Para cargar datos de ejemplo desde prisma/seed.ts:

npm run seed

Warning

prisma migrate, prisma db push, npm run seed y editar filas en Studio escriben sobre la base de datos real. Usalos solo contra una base local o de prueba.

Linting

Para correr el linter:

npm run lint

Note

ESLint se ejecuta automáticamente antes de realizar un commit.

Si se realizan cambios en la configuración de eslint, asi se puede verificar que no haya conflictos entre eslint y prettier:

npx eslint-config-prettier ./app/layout.tsx 

Formato (Prettier)

Para darle formato a todo el código:

npm run format 

Note

Prettier se ejecuta automáticamente antes de realizar un commit.

Si se realizan cambios en la configuración de Prettier, asi se puede verificar que no haya conflictos entre eslint y prettier:

npx eslint-config-prettier ./app/layout.tsx 

Pruebas

Para correr todas las pruebas unitarias por consola:

npm test

Para correr las pruebas unitarias en modo watch:

npm run test:watch

Para correr solo las pruebas de un archivo:

npm test addTask.test.ts

npm test src/features/tasks/useCase/addTask.test.ts

Warning

No olvide agregar la extension .test al escribir el nombre del archivo.

Para correr las pruebas unitarias con entorno gráfico:

npm run test-ui

El comando npm run test-ui creara un sitio local donde poder ver el estado de las pruebas en: http://localhost:51204/vitest/#/.

Para correr las pruebas end to end (Playwright, Chromium + Firefox):

npm run test:e2e

Tip

Workaround inmediato sin esperar: dejá npm run dev corriendo en otra terminal y después npm run test:e2e — con reuseExistingServer local, Playwright usa ese server ya caliente y arranca al toque.

Para correrlas con entorno gráfico:

npm run test:e2e-ui

Note

Las pruebas se ejecutan automáticamente antes de realizar un push.