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
- Node.js 22 o superior, si lo arrancas sin Docker.
- Un proyecto de Supabase, en la nube o el perfil Docker experimental.
- La URL del proyecto, la clave anónima y la clave service role. Van en
.env, nunca en el repositorio.
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
- Crea el proyecto y anota la URL, la clave anónima y la service role.
- Copia
.env.examplea.env. Las variablesVITE_*entran en el frontend en el momento de la construcción.SUPABASE_SERVICE_ROLE_KEYsolo la usa el servidor. - Pon en
ALLOWED_ORIGINS,VITE_APP_URLyAPP_URLel origen público, por ejemplohttps://portfolio.example.com. - Aplica
supabase/baseline/schema.sqly después cada archivo desupabase/migrations/en orden de nombre. No apliques una migración antigua suelta. Ver Base de datos. - 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.