Entire Base

Sitio corporativo y plataforma base para captacion de leads de Entire Base.

Incluye:

• Frontend en Nuxt 4 para las paginas publicas.
• Backend en Node.js + Express para recibir formularios de contacto.
• Persistencia en MongoDB.
• Notificaciones por email usando Resend.

Arquitectura

entire-base/
	backend/               # API Express (contacto, health, validaciones)
	frontend/              # Web principal en Nuxt 4
	frontend-spa-backup/   # Version SPA anterior (respaldo)

Tecnologias

Frontend

• Nuxt 4
• Vue 3
• Tailwind CSS v4

Backend

• Node.js
• Express 5
• MongoDB (Mongoose)
• Zod (validacion)
• Resend (email)
• Pino (logging)

Requisitos

• Node.js 20+
• npm 10+
• MongoDB accesible (local o remoto)
• Cuenta/API Key de Resend para notificaciones

Instalacion

Instala dependencias por separado en frontend y backend:

cd backend
npm install

cd ../frontend
npm install

Variables de entorno

Backend

El backend requiere estas variables para iniciar. Crea backend/.env tomando como referencia backend/.env.example:

PORT=4000
NODE_ENV=development

# URL del frontend permitido por CORS
FRONTEND_URL=http://localhost:3000

# MongoDB
MONGODB_URI=mongodb+srv://<user>:<password>@<cluster>.mongodb.net/<dbname>?retryWrites=true&w=majority

# Resend
RESEND_API_KEY=re_xxxxxxxxxxxxxxxxx
NOTIFICATION_EMAIL=tu-correo@dominio.com
FROM_EMAIL=onboarding@resend.dev

Frontend

Crea frontend/.env tomando como referencia frontend/.env.example:

NUXT_PUBLIC_API_URL=http://localhost:4000

Notas:

• Si falta cualquiera de las variables obligatorias, el backend no arranca.
• FRONTEND_URL debe coincidir con el origen real desde donde corre Nuxt.

Ejecutar en desarrollo

Abre dos terminales.

1) Backend

cd backend
npm run dev

Backend por defecto en:

• http://localhost:4000

2) Frontend

cd frontend
npm run dev

Frontend por defecto en:

• http://localhost:3000

Scripts disponibles

Backend (backend/package.json)

• npm run dev: inicia con nodemon.
• npm start: inicia en modo normal.

Frontend (frontend/package.json)

• npm run dev: servidor de desarrollo Nuxt.
• npm run build: build de produccion.
• npm run preview: previsualiza el build.
• npm run generate: genera version estatica.

API

Health check

GET /api/health

Respuesta esperada:

{
	"ok": true,
	"message": "Backend de Entire Adviser funcionando correctamente"
}

Enviar formulario de contacto

POST /api/contact

Body JSON:

{
	"name": "Juan Perez",
	"email": "juan@empresa.com",
	"company": "Empresa SL",
	"message": "Hola, me interesa una propuesta para redisenar nuestra web corporativa."
}

Respuesta exitosa (201):

{
	"ok": true,
	"message": "Mensaje recibido. Nos pondremos en contacto contigo en la mayor brevedad posible.",
	"data": {
		"id": "...",
		"name": "Juan Perez",
		"email": "juan@empresa.com",
		"company": "Empresa SL",
		"message": "Hola, me interesa una propuesta para redisenar nuestra web corporativa.",
		"createdAt": "2026-03-21T12:34:56.000Z"
	}
}

Respuesta de error (ejemplo):

{
	"ok": false,
	"message": "Debes introducir un email valido."
}

Reglas de validacion del formulario

• name: minimo 2, maximo 100 caracteres.
• email: formato valido, maximo 150 caracteres.
• company: opcional, maximo 150 caracteres.
• message: minimo 10, maximo 2000 caracteres.

Rate limiting

El endpoint de contacto limita las solicitudes a:

• 5 requests por IP cada 15 minutos.

Si se supera el limite, devuelve un error con ok: false.

Flujo funcional de contacto

1. El usuario envia el formulario desde la pagina /contact.
2. El backend valida el payload con Zod.
3. Se guarda el lead en MongoDB.
4. Se intenta enviar email de notificacion via Resend.
5. El API responde 201 aunque falle el envio de email (el lead ya queda guardado).

Despliegue

El proyecto esta configurado para desplegarse en Vercel con el backend y el frontend como proyectos independientes.

Backend

1. Importa el repo en Vercel y establece el Root Directory en backend.
2. Configura las variables de entorno del backend en el panel de Vercel.
3. Vercel usara vercel.json y api/index.js como punto de entrada.

Frontend

1. Importa el mismo repo y establece el Root Directory en frontend.
2. Configura NUXT_PUBLIC_API_URL apuntando a la URL del backend desplegado.

MongoDB Atlas

• En Network Access permite 0.0.0.0/0 para que Vercel pueda conectar (IPs dinamicas).
• Usa un cluster activo; el plan gratuito M0 se pausa tras 60 dias sin actividad.

Importante:

• Actualmente la pagina de contacto usa una URL fija para el backend: http://localhost:4000/api/contact.
• Para despliegue, actualiza esa URL o migra a una configuracion por entorno/runtime.

Proyecto legado

La carpeta frontend-spa-backup/ contiene una version anterior en Vue + Vite. No es la version principal activa, pero se conserva como referencia.