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. Los valores NEXT_PUBLIC_* que contiene se leen cuando se construye el sitio web y son públicos, así que nunca guardan un secreto. REVALIDATE_SECRET y API_INTERNAL_URL los lee el propio servidor del sitio web al ejecutarse y nunca llegan al navegador. Créalo a partir de .env.example, que apunta a una API en http://localhost:8000: cp .env.example .env. Con Docker, pasa los valores NEXT_PUBLIC_* como --build-arg y los otros dos con -e.

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, exportaciones CSV en /data/exports, CORS_ORIGIN para los dos frontends locales, FRONTEND_URL=http://localhost:3031, STOREFRONT_URL=http://localhost:3030, PUBLIC_API_URL=http://localhost:8000, PUBLIC_MEDIA_URL=http://localhost:8000/media y SEED_DEMO_DATA=false. Cambia 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.

Tu propio espacio de trabajo y propietario

Se lee solo en una base de datos sin cuenta de personal ni espacio de trabajo (las tablas de yarn db:sync, o un volumen de Docker iniciado con SEED_DEMO_DATA=false). El primer inicio de la API crea entonces, a partir de ellas, los roles, los ajustes del sitio, las categorías de eventos, un espacio de trabajo y su propietario, una sola vez. En cuanto existe cualquier cuenta de personal, se ignoran.

OWNER_EMAIL=you@your-domain.com
OWNER_PASSWORD=a-long-password-of-your-own
OWNER_NAME=Your Name
WORKSPACE_NAME=Your organisation

En el Docker Compose de la pila completa pueden ir en el .env junto a docker-compose.yml, con SEED_DEMO_DATA=false: Compose pasa ese archivo primero a la API y luego back-end/.env, cuyo valor gana donde ambos definen uno. Sin las variables, la API arranca e indica cuáles definir.

• Puesta en marcha con tu propio espacio de trabajo

Pagos

El pago envía al comprador a la página propia de Stripe o PayPal, así que los datos de la tarjeta nunca se escriben en tu sitio. Cada proveedor se ofrece en cuanto se definen sus claves. Usa primero claves de prueba: no mueven dinero.

STRIPE_SECRET_KEY=sk_test_your_key
STRIPE_WEBHOOK_SECRET=whsec_your_secret
PAYPAL_CLIENT_ID=your-client-id
PAYPAL_CLIENT_SECRET=your-client-secret
PAYPAL_WEBHOOK_ID=your-webhook-id
PAYPAL_ENV=sandbox

Las entradas gratuitas no necesitan nada de esto: un pedido sin nada que pagar se confirma al pagar, con o sin claves. Ticketory no cobra impuestos por sí mismo, así que configura los impuestos de tu país antes de aceptar pagos reales.

• Pedidos, pagos y reembolsos

Correo electrónico

Las entradas, los códigos de registro, los restablecimientos de contraseña, las novedades de reembolso y los recordatorios de eventos se envían a través de Resend en cuanto se definen las dos variables. Hasta entonces, cada correo se escribe en el registro de la API, que es donde se lee un código de registro en una instalación nueva (con Docker: docker compose logs api).

RESEND_API_KEY=re_your_key
MAIL_FROM=Ticketory <tickets@your-domain.com>
EVENT_REMINDER_HOURS=24

EVENT_REMINDER_HOURS es cuánto antes de un evento sale su recordatorio: 24 si no se define, como máximo 168 (una semana), y 0 desactiva los recordatorios. Todo correo sobre un pedido (entradas, reembolsos, el aviso de cancelación y el recordatorio) se escribe en el idioma en que se hizo el pedido.

• Entradas, pases y correos

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

Luego ejecuta yarn seed para los datos de ejemplo, 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). La imagen de Docker lo hace sola solo en SQLite: en MySQL, ejecútalo tú una vez.

Imágenes y subidas

La API sirve ella misma las imágenes de ejemplo, desde public/media/ticketory (los símbolos de categoría, las marcas, el emblema del asistente y las fotos de ejemplo del estudio), en /media/ticketory/…. Las subidas desde el panel (las fotos de recintos vacíos para el estudio, las fotos adjuntas a una pregunta del asistente) y los conceptos terminados del estudio 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 el navegador llega a /media. Cada dirección de imagen se construye a partir de ella, y la API traslada a ella las ya guardadas cuando arranca, así que mover la API conserva todas las imágenes. 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 imágenes.

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 imágenes se recodifican como JPEG al subirlas, con un máximo de 1920 píxeles de ancho. Los vídeos se aceptan como MP4, WebM, MOV o M4V, de hasta 150 MB.

Sitio web y panel del organizador

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 uno, y vuelve a construir (o reinicia yarn dev) después de cambiar uno.

Las etiquetas de marketing del sitio web también son valores NEXT_PUBLIC_*: Google Tag Manager (NEXT_PUBLIC_GTM_ID), GA4 (NEXT_PUBLIC_GA4_MEASUREMENT_ID), Meta, TikTok, Snapchat y Pinterest, cada una activada con un solo id; un id en blanco no carga ningún script. NEXT_PUBLIC_ANALYTICS_CURRENCY (USD por defecto) es la moneda que se envía con los precios de las entradas, y NEXT_PUBLIC_ANALYTICS_DEBUG=true registra cada evento rastreado en la consola del navegador.

• El sitio web

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, por ejemplo ADMIN_PORT=3041. CORS_ORIGIN, FRONTEND_URL, STOREFRONT_URL, PUBLIC_API_URL y PUBLIC_MEDIA_URL de la API, y las direcciones de la API, el sitio web y el panel de los frontends, se construyen todos a partir de los puertos y las tres direcciones, así que siguen solos.

• Un puerto ya está en uso

El contenedor de la API lee primero este .env y luego back-end/.env cuando existe, cuyo valor gana donde ambos definen uno, 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, las carpetas de subidas y exportaciones, el puerto, NODE_ENV=production y las direcciones de arriba. La base de datos, las subidas y las exportaciones CSV viven en el volumen ticketory-data.

Funciones de IA

El servidor MCP

Modo demostración