PDV/README.md

Monorepo con npm workspaces que combina un backend NestJS y un frontend Next.js.

Estructura

apps/
  api/   NestJS — servidor HTTP real del proyecto
  web/   Next.js (App Router) — frontend

En desarrollo y producción se levanta un único servidor: apps/api (Nest) arranca, monta sus controladores bajo el prefijo /api, y luego delega cualquier otra ruta al request handler programático de Next.js (apps/web). No hay dos puertos ni dos procesos — Nest "sirve" a Next.

Ver apps/api/src/main.ts para el detalle de la integración.

Empezar

Instala las dependencias una sola vez desde la raíz (los workspaces se resuelven juntos):

npm install

Desarrollo

npm run dev

Levanta Nest en modo watch (nest start --watch), que a su vez prepara Next en modo desarrollo. Todo queda disponible en http://localhost:3000 (API bajo /api/*).

Build y producción

npm run build   # compila apps/web (next build) y luego apps/api (nest build)
npm run start   # node apps/api/dist/main.js

Solo frontend (aislado)

Si necesitas iterar en apps/web sin levantar Nest:

npm run dev --workspace=@pdv/web

Ten en cuenta que en ese modo las rutas /api/* de Nest no estarán disponibles.

Notas de configuración

• El custom server de Next (next({ dev, dir })) no es compatible con output: "standalone" — no lo actives en apps/web/next.config.ts mientras Nest siga sirviendo el build.
• apps/api usa TypeScript 6.x (distinto de apps/web, que usa TypeScript 5.x) porque @nestjs/cli/nest build aún no soportan la API programática del compilador de TypeScript 7.