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 los valores NEXT_PUBLIC_* que contiene son públicos, así que nunca guarda 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 guarda un secreto: las claves de pagos y de IA viven 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, SITE_URL=http://localhost:3030, 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.

Pagos

Sin ninguno de estos, el simulador incluido acepta todas las reservas con tarjeta y PayPal, así que todo el proceso de pago funciona sin cuenta de comercio, y el registro de inicio de la API dice Payment simulator active mientras tanto. Confirma esas reservas sin cobrar nada, así que define Stripe, PayPal o ambos antes de recibir reservas reales: entonces el simulador se apaga, el pago ofrece solo los métodos configurados más el pago a la llegada, y se rechaza un método sin procesador. La pestaña Pagos de los ajustes del panel muestra qué procesadores están configurados, si sus claves son de prueba o reales y si se usa el simulador, nunca las claves en sí.

STRIPE_SECRET_KEY=your-stripe-secret-key
STRIPE_WEBHOOK_SECRET=your-stripe-webhook-signing-secret
PAYPAL_CLIENT_ID=your-paypal-client-id
PAYPAL_CLIENT_SECRET=your-paypal-client-secret
PAYPAL_WEBHOOK_ID=your-paypal-webhook-id
PAYPAL_ENV=sandbox

El pago a la llegada no necesita ninguna clave: es el interruptor allow_pay_on_arrival en la pestaña Pagos del panel, activado en la carga inicial.

• Reservas y pagos

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=hollina

Luego ejecuta yarn seed para la empresa de demostración, o yarn db:sync para las tablas sin datos. La API en ejecución 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).

Fotografías y subidas

La API sirve ella misma las fotografías de la carga inicial, desde public/media/hollina, en /media/hollina/…. Las subidas desde el panel (fotografías de alojamientos, portadas de destinos, fotos de perfil) se guardan en el disco de la API bajo MEDIA_UPLOAD_DIR y se sirven en /media/uploads/…, salvo que se configure un bucket.

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

PUBLIC_MEDIA_URL es la dirección a la que se llega a /media desde un navegador. Cada dirección de fotografía se construye a partir de ella, y la API traslada las guardadas a ella al iniciarse, así que mover la API conserva todas las fotografías. En un servidor, apunta MEDIA_UPLOAD_DIR a un 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 fotografías.

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 fotografías se recodifican al subirlas como JPEG, de 1920 píxeles de ancho como máximo, con una copia más pequeña para las tarjetas de alojamientos. Los vídeos se aceptan como MP4, WebM, MOV o M4V, hasta 150 MB.

Sitio web de alojamientos y panel de reservas

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 use, como ADMIN_PORT=3041. CORS_ORIGIN, FRONTEND_URL, SITE_URL y PUBLIC_MEDIA_URL de la API, y las direcciones de la API y del sitio web de los frontends, se construyen todas a partir de los puertos y las tres direcciones, así que se ajustan solas.

El contenedor de la API también lee back-end/.env cuando existe, así que las claves de pagos, IA, R2 y MCP se definen en un solo lugar tanto para yarn dev como para Docker. El archivo compose prevalece 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 viven en el volumen hollina-data.

El asistente de IA

El servidor MCP

Modo demostración