Documentación de Iridum

Pasos rápidos para instalar Iridum como plugin en una instalación WordPress:

1. Sube la carpeta del plugin a wp-content/plugins/.
2. Activa el plugin desde el panel de administración en Plugins → Instalar.
3. En la primera activación el plugin intentará crear las tablas necesarias; revisa WP_DEBUG si hay errores.
4. Configura ajustes en Iridum → Settings (API keys, slug, repositorio, sociales).

Recomendaciones de despliegue:

• Usa HTTPS y un usuario con permisos reducidos para las llamadas API.
• Programa backups de la base de datos antes de activaciones en entornos productivos.

Un proyecto (lienzo) agrupa nodos, entidades y relaciones. Pasos:

1. En el Dashboard haz click en "Nuevo proyecto".
2. Completa nombre, descripción y permisos si aplica.
3. Importa datos (CSV/JSON) o crea nodos manualmente.

Buenas prácticas:

• Define un esquema de nombres para entidades (p. ej. PERSON_1234).
• Usa resoluciones para normalizar datos de fuentes heterogéneas.

Las resoluciones son módulos PHP que procesan texto o extraen metadatos (URLs, entidades, fechas, geolocalización).

Registrar una resolución

// ejemplo mínimo
class MyResolution implements \Iridum\Domain\Services\ResolutionInterface {
  public function run(array $input): array {
    // procesar y devolver array con 'nodes' y 'edges'
    return [];
  }
}

Invocar resoluciones

Desde el panel o via REST: usa el endpoint /iridum/v1/resolutions con payload JSON que contenga la entrada.

Endpoints principales:

• GET /projects — lista proyectos.
• POST /projects — crea proyecto (requiere autenticación).
• POST /resolutions — ejecutar una resolución.
• GET /graph/{projectId} — obtiene grafo del proyecto.

Ejemplo: obtener proyectos (fetch)

fetch('/wp-json/iridum/v1/projects', {headers:{'X-WP-Nonce': Iridum.nonce}})
  .then(r=>r.json()).then(console.log);

Importar desde CSV

Usa el importador CSV desde el Dashboard o la API para añadir nodos en lote. El archivo debe tener columnas: id, label, type.

Generar informe

Desde el panel puedes generar una vista previa del informe; si jsPDF no está disponible el plugin hará fallback a HTML descargable.

Nodo

Entidad individual en el grafo (persona, organización, URL).

Edge

Relación entre dos nodos.

Resolución

Módulo que transforma o extrae información.