POS Restaurante

Sistema POS multi-tenant. Pedidos en tiempo real, pagos, cocina (KDS), menú público y dashboard.

Stack

Contrato /api

Un solo contrato para todo el backend. El cliente del navegador siempre habla con el mismo origen del frontend:

• Dev: Next.js rewrites /api/* y /static/* → INTERNAL_API_URL (Nest interno).
• Prod: Dokploy/Traefik rutea /api/* y /static/* → servicio api, resto → servicio web. No hay Nginx en el compose.
• Server-side (RSC): un único helper getApiBase() (en apps/web/lib/api-base.ts) elige entre /api (browser) y INTERNAL_API_URL + /api (server). Sin URLs hardcoded.

Desarrollo local

Requisitos

• Node.js ≥ 20
• PNPM ≥ 9 — npm i -g pnpm@9
• Docker (para PostgreSQL)

Primera vez

pnpm install
cp .env.example .env                # ajusta secretos si quieres
pnpm db:up                          # tú decides cuándo levantar la DB
pnpm --filter @repo/db db:migrate:dev   # nombra la primera migración "init"
pnpm db:seed

El seed crea organización demo, usuario admin y datos de prueba.

Día a día

pnpm db:up                          # si la DB no está corriendo
pnpm dev                            # Next.js + NestJS en paralelo

El navegador siempre va por /api (mismo origen, cookies same-origin). El acceso directo a :3001 existe solo para debug.

Comandos útiles

pnpm --filter api dev               # solo API
pnpm --filter web dev               # solo Next
pnpm build                          # build de todo
pnpm start                          # corre el build (web + api)
pnpm check-types                    # tsc --noEmit en todos
pnpm lint
pnpm --filter api test

Producción (Dokploy)

Arquitectura

Internet → Dokploy/Traefik (TLS, dominio)
             ├── /api/*      → api    (NestJS :3001)
             ├── /static/*   → api    (NestJS :3001)
             └── /*          → web    (Next.js :3000)
                                       └── SSR/RSC → http://api:3001 (red interna)

Setup

1. Crear el VPS con Dokploy. Conecta este repo de GitHub.

2. Crear Compose Application apuntando a infra/docker-compose.prod.yml.

3. Variables de entorno en Dokploy (no commiteadas):

   # Conexion a tu DB externa (Dokploy service de Postgres, RDS, Supabase, etc.)
   DATABASE_URL=postgresql://USER:PASS@HOST:5432/DBNAME
    
   NODE_ENV=production
   PORT=3001
   BETTER_AUTH_SECRET=<openssl rand -base64 32>
   BETTER_AUTH_URL=https://tudominio.com
   CORS_ORIGINS=https://tudominio.com
   UPLOADS_DIR=/var/app/uploads
   PUBLIC_STATIC_URL=https://tudominio.com/static
   LOG_LEVEL=info

   El compose no levanta Postgres. Apunta DATABASE_URL a la DB que prefieras (otro servicio en Dokploy, RDS, Neon, Supabase, etc.).

4. Configurar dominios en Dokploy (Traefik labels o UI):

   • web recibe el dominio raíz /.
   • api recibe los path-prefixes /api y /static del mismo dominio.

5. Migraciones (manual la primera vez):

   docker compose -f infra/docker-compose.prod.yml --profile tools run --rm migrate
   docker compose -f infra/docker-compose.prod.yml --profile tools run --rm seed   # opcional

6. Deploys — push a main → Dokploy webhook → rebuild automático.

Build / start manual (sin Dokploy)

pnpm build
pnpm start

O via Docker:

docker compose -f infra/docker-compose.prod.yml up -d --build

Sin reverse proxy externo, el navegador necesita llegar a web y este rewritea /api → api por la red interna de Docker. Expón el puerto del servicio web en el host si vas a probar así.

Estructura del monorepo

restaurant-system/
├── apps/
│   ├── api/        # NestJS — modules en src/modules/
│   └── web/        # Next.js 16 App Router
├── packages/
│   ├── db/         # Prisma schema + migrations + seed
│   ├── shared/     # Zod schemas compartidos
│   ├── auth/       # Better Auth config compartida
│   ├── ui/         # shadcn/ui primitivos
│   └── typescript-config/
└── infra/
    └── docker-compose.{yml,prod.yml}

Roles

Solución de problemas