Saltar al contenido principal

Empezando

Esta guía rápida te ayuda a poner en marcha ValerIA y a comprender los primeros elementos clave antes de profundizar en flujos, filetypes y automatizaciones.

1. Instalación

Sigue las recomendaciones de la documentación de instalación. Resumen típico (alta‑nivel):

  1. Clonar repositorio.
  2. Configurar variables de entorno mínimas (API_URL, credenciales Mongo, claves JWT).
  3. Levantar servicios con docker-compose up -d.
  4. Verificar que API responde (/health o /info).
  5. Acceder al frontend y realizar primer login.

Sugerencia: en entornos locales puedes usar una base de datos Mongo desechable para iterar rápido y luego migrar a una persistente.

Ejemplo de estructura mínima de .env (simplificado)

API_PORT=5000
MONGO_URL=mongodb://mongo:27017/valeria
JWT_SECRET=pon_aqui_una_clave_segura
NODE_ENV=development

2. Primer Acceso y Usuarios

Usa el usuario por defecto para acceder y crear los usuarios iniciales. Luego elimina o desactiva esa cuenta. Consulta el tutorial detallado: Usuarios.

Checklist rápido:

  • Login con admin@localhost / admin.
  • Crear superadmin de emergencia.
  • Crear admin operativo.
  • Crear primeros usuarios user.
  • Eliminar o rotar contraseña de admin@localhost.

3. Crear Filetypes Base

Antes de cargar datos masivos define los filetypes núcleo: clientes, productos/servicios, proveedores. Ver guía: Filetypes.

Ejemplo simple de JSON para importar clientes:

[
{ "nombre": "Cliente Demo 1", "cif": "B11111111", "pais": "ES" },
{ "nombre": "Cliente Demo 2", "cif": "B22222222", "pais": "ES" }
]

Tras importar, ajusta tipos y añade campos estratégicos (segmento, rating, etc.).

4. Primer Flujo (Automatización)

Con Conductor puedes orquestar validaciones y notificaciones. Ejemplo de primer caso: al crear un dossier de tipo cliente, generar una tarea de verificación fiscal.

Pseudopasos:

  1. Nodo disparador: evento de creación dossier.
  2. Nodo condición: filetype == cliente.
  3. Nodo acción: crear tarea y enviar notificación.

5. Verificación de Logs y Seguridad

Revisa que los logs centralizados registren: autenticaciones, creación/edición de dossier, errores y eventos de flujo. Asegura que las variables sensibles no se imprimen.

6. Próximos Pasos

ObjetivoAcción sugeridaReferencia
Cargar datos históricosImportar JSON/CSVFiletypes
Afinar modelo de promptsCrear librería inicial(Próxima guía)
Medir actividadActivar dashboard básicoEventos
Añadir alertasConfigurar flujosConductor

Sigue ahora con: Usuarios y luego Filetypes para construir tu base operativa.