Trazza

Cómo montarlo

Camino probado: un proyecto de Supabase Cloud y docker compose --profile cloud up --build. El perfil self-hosted es experimental y no está cubierto por la misma verificación. Detalle en Self-hosting.

Qué necesitas

En local

git clone https://github.com/ernes-cloud/trazza.git
cd trazza
cp .env.example .env
npm ci
cd server && npm ci && cd ..
cd server && node index.js
VITE_VALIDATION_SERVER_URL=http://localhost:4000 npm run dev

La API escucha en el puerto 4000. El frontend de desarrollo, en el 3000. Express carga primero server/.env y después el .env de la raíz. Vite lee las variables VITE_* al arrancar.

Para ver la interfaz con datos de ejemplo, define VITE_DEMO_EMAIL y VITE_DEMO_PASSWORD. El botón de explorar la demo en el acceso no pide cuenta.

Con Docker y Supabase Cloud

  1. Crea el proyecto y anota la URL, la clave anónima y la service role.
  2. Copia .env.example a .env. Las variables VITE_* entran en el frontend en el momento de la construcción. SUPABASE_SERVICE_ROLE_KEY solo la usa el servidor.
  3. Pon en ALLOWED_ORIGINS, VITE_APP_URL y APP_URL el origen público, por ejemplo https://portfolio.example.com.
  4. Aplica supabase/baseline/schema.sql y después cada archivo de supabase/migrations/ en orden de nombre. No apliques una migración antigua suelta. Ver Base de datos.
  5. Arranca:
docker compose --profile cloud up --build

La interfaz queda en http://localhost:8080. La comprobación de salud es curl -f http://localhost:8080/health.

Primer administrador

Define ADMIN_EMAILS con los correos verificados, separados por comas. Si lo dejas vacío, el primer usuario confirmado queda como administrador.

Qué no hace falta

No hay columna de plan ni ruta de estadísticas globales. El correo (Resend o SMTP) y Groq son opcionales: sin configurarlos, esas rutas responden 503.