Primeros pasos

Primeros pasos

🇬🇧 English

Esta guía ejecuta Goliat en local con el login demo y un inventario ficticio. No necesitas una cuenta de Azure.

Requisitos

• Node.js 24 (mínimo 22.12) y npm.
• Una base de datos PostgreSQL vacía cuyo usuario pueda crear tablas. Un PostgreSQL 17 local funciona bien.

Instala las dependencias en el sistema operativo donde se ejecutará Next.js: Tailwind usa binarios nativos distintos en Windows y Linux.

1. Instalar y configurar

git clone https://github.com/danieljsaldana/goliat-cloud-inventory.git
cd goliat-cloud-inventory
npm ci
cp .env.example .env

Edita .env:

DB_HOST=127.0.0.1
DB_NAME=cloud_inventory
DB_USER=cloud_inventory
DB_PASSWORD=<tu contraseña>
DB_SSL=false               # servidor local sin TLS

DASHBOARD_AUTH_MODE=demo
DASHBOARD_USERNAME=<elige un usuario>
DASHBOARD_PASSWORD=<elige una contraseña>
AUTH_SECRET=<al menos 32 bytes aleatorios>

Puedes generar el secreto con, por ejemplo, openssl rand -base64 32. .env está ignorado por Git y nunca debe subirse.

2. Crear el esquema y cargar datos de ejemplo

npm run db:init   # crea el esquema desde server/schema/initial.sql; se puede repetir
npm run db:seed   # opcional: 5 suscripciones y 214 recursos ficticios

db:seed se niega a ejecutarse con NODE_ENV=production y no necesita credenciales de la nube.

3. Arrancar el panel

npm run dev

Abre http://127.0.0.1:4000 e inicia sesión con las credenciales demo. PORT en .env controla tanto dev como start; si lo cambias, actualiza también AUTH_URL y SITE_URL.

Siguientes pasos

• Explora las Vistas del inventario y la búsqueda global (Ctrl+K / ⌘K).
• Importa un inventario real: consulta Colector de inventario.
• Usa el login de Microsoft Entra ID: consulta Autenticación y roles.
• Despliega en Azure: consulta Despliegue en Azure.

Scripts útiles

Comando	Uso
npm run dev / npm start	Servidor de desarrollo / producción (carga .env antes).
npm run build	Compilación de producción (salida standalone).
npm run db:init	Crea el esquema en una base vacía; se puede repetir.
npm run db:seed	Carga el inventario de demostración.
npm run db:migrate / db:status / db:check	Aplica, lista y verifica migraciones.
npm run collect:azure	Importa azure/latest.json de Blob Storage a PostgreSQL.
npm test	Pruebas unitarias; integración con PostgreSQL con RUN_DB_TESTS=1.
npm run test:e2e	Pruebas de navegador con Playwright.