Variables de entorno

Dónde están los ajustes

Crea el archivo de cada aplicación a partir del .env.example que tiene al lado, que documenta cada variable: cp .env.example .env. Los ejemplos sirven tal cual para una ejecución local, y el inicio con Docker Compose no necesita ningún archivo.

Dónde están los ajustes

Un solo archivo, .env en la carpeta del sitio web, que se lee cuando se construye el sitio web. Todos sus valores son públicos, así que nunca contiene un secreto. Créalo a partir de .env.example, que apunta a una API en http://localhost:8000: cp .env.example .env. Con Docker, pasa los mismos valores como --build-arg.

Dónde están los ajustes

Un solo archivo, .env en la carpeta del panel, que se lee cuando se construye el panel. Todos sus valores son públicos, así que nunca contiene un secreto: las claves de los proveedores están en el .env de la API. Créalo a partir de .env.example, que apunta a una API en http://localhost:8000: cp .env.example .env. Con Docker, pasa los mismos valores como --build-arg.

Dónde están los ajustes

Un solo archivo, .env en la carpeta de la API, que lee la API con yarn dev y un contenedor cuando añades --env-file .env -e NODE_ENV=production a su docker run. Contiene secretos: nunca lo incluyas en un commit. Créalo a partir de .env.example, que documenta cada variable y sirve tal cual para una ejecución local: cp .env.example .env.

La imagen de Docker define sus propios valores por defecto, así que docker run funciona sin archivo: SQLite en /data/database.sqlite, subidas en /data/uploads, CORS_ORIGIN para los dos frontends locales, FRONTEND_URL=http://localhost:3031, PUBLIC_MEDIA_URL=http://localhost:8000/media y SEED_DEMO_DATA=false. Sustituye cualquiera de ellos con -e.

Lo esencial de la API

La API comprueba JWT_SECRET y, en producción, CORS_ORIGIN antes de iniciarse. Si falta alguno o no se puede usar, se detiene con una línea que dice qué corregir.

Genera tu propio JWT_SECRET con:

node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"

Cada función opcional de abajo está desactivada mientras sus líneas en .env.example sigan comentadas.

Usa MySQL en lugar de SQLite

Crea una base de datos vacía y luego configura el controlador y la conexión en el .env de la API:

DB_TYPE=mysql
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=velra

Luego ejecuta yarn seed para la agencia de demostración, o yarn db:sync para las tablas sin datos. La API en marcha solo crea y actualiza las tablas por sí misma cuando NODE_ENV=development, así que con NODE_ENV=production uno de esos comandos se ejecuta antes del primer inicio (yarn seed:prod o yarn db:sync:prod después de yarn build).

Fotos y subidas

La API sirve ella misma las fotos de la carga inicial, desde public/media/velra, en /media/velra/…. Las subidas desde el panel (fotos de propiedades, fotos de estancias para el estudio, vistas previas amuebladas, fotos de perfil) se guardan en el disco de la API bajo MEDIA_UPLOAD_DIR y se sirven en /media/uploads/…, salvo que se defina un bucket.

PUBLIC_MEDIA_URL=http://localhost:8000/media
MEDIA_UPLOAD_DIR=./public/media/uploads

PUBLIC_MEDIA_URL es la dirección en la que un navegador llega a /media. Cada dirección de foto se construye a partir de ella, y la API traslada a ella las guardadas cuando inicia, así que mover la API conserva todas las fotos. En un servidor, apunta MEDIA_UPLOAD_DIR a almacenamiento persistente; con Docker está en el volumen de datos.

Para enviar las subidas a Cloudflare R2, o a cualquier bucket compatible con S3, define las cinco variables. Da a ambos frontends el host público del bucket mediante NEXT_PUBLIC_MEDIA_HOSTNAME (con Docker Compose, MEDIA_HOSTNAME) para que Next.js redimensione esas fotos.

R2_ACCESS_KEY_ID=your-r2-access-key-id
R2_SECRET_ACCESS_KEY=your-r2-secret-access-key
R2_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com
R2_BUCKET_NAME=your-bucket-name
R2_PUBLIC_URL=https://your-public-url.r2.dev

Las fotos se recodifican al subirlas, con un ancho máximo de 1920 píxeles, y con una copia más pequeña para las tarjetas de propiedad. Los vídeos se aceptan como MP4, WebM, MOV o M4V, hasta 150 MB.

Sitio web público y panel de la agencia

Cada valor NEXT_PUBLIC_* se compila en el JavaScript que carga el navegador, y cualquiera que abra la página puede leerlo. Nunca pongas un secreto en estos archivos, y reconstruye después de cambiar uno.

Las etiquetas de marketing del sitio web también son valores NEXT_PUBLIC_*: Google Tag Manager, GA4, Meta, TikTok, Snapchat y Pinterest, cada una activada con un solo id.

• Etiquetas de analítica y seguimiento

Opciones de Docker Compose

No hay que configurar nada para una ejecución local. Para cambiar algo, ponlo en un archivo .env junto a docker-compose.yml y vuelve a ejecutar docker compose up --build: los frontends incorporan estos valores al construirse.

Cambia un puerto cuando otro programa ya lo usa, como ADMIN_PORT=3041. El CORS_ORIGIN, el FRONTEND_URL y el PUBLIC_MEDIA_URL de la API, y las direcciones de la API y del sitio web de los frontends, se construyen todos a partir de los puertos y las tres direcciones, así que los siguen por sí solos.

La API en contenedor también lee back-end/.env cuando existe, así que las claves opcionales se definen en un solo lugar para yarn dev y para Docker. El archivo compose gana en los valores que difieren dentro de un contenedor: la ruta de la base de datos, la carpeta de subidas, el puerto, NODE_ENV=production y las direcciones anteriores. La base de datos y las subidas están en el volumen velra-data.

Funciones de IA

El servidor MCP

Modo demostración