SysRevAI, paso a paso

Primeros pasos

SysRevAI es una plataforma que se instala en el servidor de tu institución para hacer revisiones sistemáticas y de alcance con ayuda de IA. Este capítulo te lleva de cero a tener el programa descargado y la licencia en la mano.

Qué es SysRevAI

Cubre todo el flujo de una revisión: protocolo, importación y desduplicación de referencias, cribado por título y resumen, texto completo, extracción de datos, riesgo de sesgo, síntesis con GRADE y exportaciones (diagrama PRISMA 2020, Word, Excel, RIS). La IA está como ayudante: prioriza, sugiere y resume, pero cada decisión la toma una persona y queda registrada.

Los datos nunca salen de tu servidor. Las llamadas a la IA se hacen con tu propia clave y pueden desactivarse revisión por revisión.

Probarlo sin instalar

Si quieres ver cómo funciona antes de instalar nada, crea una cuenta de prueba de 30 días en sysrevai.com/prova. Puedes invitar hasta 5 personas y hacer una revisión real (hasta 3 revisiones, 500 MB de PDF y un pequeño presupuesto de IA por equipo). El día 20 recibirás un aviso; el día 30 la cuenta se bloquea y solo puedes exportar los datos, y 7 días después se borra. Antes, exporta todo desde Perfil → Mis datos e impórtalo en tu instalación.

Qué necesitas

El número de licencia

Tiene el formato SRAI-XXXXX-XXXXX-XXXXX-XXXXX. Es gratuito, identifica tu instalación para recibir actualizaciones y es válido para un dominio y hasta 10 usuarios activos. El instalador lo pide en el paso 7 y es obligatorio: siempre se valida con sysrevai.com y no se puede omitir.

Sin clave de IA también funciona

No hace falta ninguna clave de inteligencia artificial para instalar ni para hacer la revisión. Las funciones asistidas (propuestas de cribado y de resolución de conflictos, priorización, preextracción, resúmenes, chat con el artículo) se activan cuando añades una clave de la API de Claude en Admin → Claude (IA). Lo veremos en el capítulo 3.

Enlace a este capítulo →

Instalación en el servidor

El asistente web hace todo el trabajo en nueve pantallas. No hace falta línea de comandos: solo subir archivos, crear la base de datos y seguir los pasos.

Subir los archivos

1. Descomprime el ZIP. Dentro hay una sola carpeta, sysrevai/.
2. Súbela entera al servidor (SFTP, el gestor de archivos del hosting o scp).
3. Configura el sitio web para que el directorio público (document root) sea sysrevai/public. Con CloudPanel, Plesk o cPanel es una opción del sitio; con Nginx o Apache, una línea en la configuración del vhost.
4. Asegúrate de que PHP puede escribir en storage/ y en public/uploads/.

El asistente, paso a paso

Después de instalar

• El cron, imprescindible. Añade un cron que ejecute cada minuto php /ruta/sysrevai/bin/worker.php como usuario del sitio web. Sin él no se hacen las copias automáticas, la búsqueda y descarga de artículos, las búsquedas programadas, los trabajos largos de IA ni la comprobación de actualizaciones. El instalador te da la línea exacta al final y, mientras no funcione, los administradores ven una barra naranja en todas las páginas con el botón «Cómo configurar el cron», que lleva a Admin → Mantenimiento → Tareas programadas (cron): la línea para copiar, los pasos por SSH o con un panel (CloudPanel, Plesk, cPanel) y el estado. Cuando el cron ya corre, la tarjeta dice «Funciona» y la barra desaparece.
• Instalador sellado. Una vez terminado, /install/ ya no se abre. Puedes borrar la carpeta public/install/ si lo prefieres.
• Copias. Una vez funciona el cron, la plataforma hace sola una copia completa cada 2 horas (capítulo 15).

* * * * * php /ruta/sysrevai/bin/worker.php >> /ruta/sysrevai/storage/logs/worker.log 2>&1

Problemas habituales

Enlace a este capítulo →

Configuración inicial (Admin)

Una vez dentro, el panel de administración (menú superior → Configuración) centraliza todo lo que afecta a la instalación: IA, correo, usuarios, seguridad y valores por defecto de las revisiones.

Orden recomendado

Todas las secciones

Roles de la plataforma

• Propietario: todo. Siempre debe haber al menos uno y no puede eliminarse a sí mismo.
• Administrador: configuración y usuarios, pero no puede degradar al propietario.
• Usuario: crea y participa en revisiones. Los permisos dentro de cada revisión los fija su coordinador (capítulo 11).

Páginas legales

Admin → Páginas legales genera la política de privacidad y las condiciones de uso a partir de plantillas con el nombre de la institución, el correo de contacto y la fecha. Revísalas antes de abrir el registro: los usuarios las aceptan al crear la cuenta.

Enlace a este capítulo →

Crear una revisión y el protocolo

Una revisión es el espacio de trabajo de un equipo: el protocolo, las referencias, las decisiones y las exportaciones. Todo empieza definiendo la pregunta.

Crear la revisión

1. En el tablero, pulsa Nueva revisión.
2. Indica el título, el tipo (sistemática o de alcance) y el marco de la pregunta: PICO para intervenciones o PCC (población, concepto, contexto) para revisiones de alcance.
3. Elige el modo de cribado: un solo revisor, doble ciego, doble ciego con tercer revisor o piloto. Se puede cambiar más adelante mientras no haya decisiones.
4. Guarda. Ya puedes invitar al equipo (capítulo 11) o seguir con el protocolo.

El protocolo

La pestaña Protocolo recoge la pregunta, los criterios de inclusión y exclusión, los motivos de exclusión que se usarán en el cribado, la estrategia de búsqueda por base de datos y las notas metodológicas. Los criterios alimentan el resaltado de palabras clave durante el cribado.

Motivos de exclusión

Defínelos antes de empezar a cribar: cada exclusión a texto completo necesita uno, y son los que aparecen en el diagrama PRISMA. Los valores por defecto se pueden cambiar en Admin → Revisiones.

El tablero de la revisión

La página principal de cada revisión muestra el estado de cada fase (referencias, cribado, texto completo, extracción, riesgo de sesgo, exportaciones) con contadores, quién tiene trabajo pendiente y la actividad reciente. La barra de fases de arriba es el camino: cada paso se ilumina cuando está terminado.

Enlace a este capítulo →

Importar referencias y duplicados

Las referencias entran por archivo, por búsqueda directa o pegando texto. Después, la desduplicación deja una sola copia de cada estudio.

Formatos aceptados

Importar paso a paso

1. Dentro de la revisión, ve a Referencias → Importar.
2. Elige el formato, sube el archivo (o pega el texto) e indica la fuente (la base de datos de la que proviene). La fuente es la que sale en el diagrama PRISMA.
3. Revisa la previsualización: cada referencia tiene una casilla y una marca verde si tiene DOI o PMID. Desmarca las que no quieras.
4. Confirma. Las referencias quedan en la fase de cribado por título y resumen.

Búsqueda directa

Desde Buscar (menú superior) puedes consultar PubMed, CrossRef, OpenAlex y Europe PMC a la vez, ver la relevancia de cada resultado y enviarlos a la revisión sin pasar por ningún archivo. Las búsquedas se pueden guardar y repetir (capítulo 14).

Desduplicación

Referencias → Duplicados busca coincidencias en tres pasadas: identificadores exactos (DOI, PMID), título normalizado y similitud (algoritmo Jaro-Winkler con autores y año). Cada pareja propuesta se confirma o se descarta; se conserva la referencia con más metadatos y la otra queda marcada como duplicado, fuera del cribado pero contada en PRISMA.

Etiquetas y búsqueda local

En la lista de referencias puedes filtrar por fase, decisión, fuente, etiqueta o texto, y aplicar acciones masivas (etiquetar, mover de fase, exportar). Las etiquetas son libres y sirven para cualquier clasificación propia: «dudoso», «pedir a biblioteca», «subestudio A».

Enlace a este capítulo →

Cribado de título y resumen

La fase en la que el equipo decide, referencia a referencia, qué pasa a texto completo. Dos revisores trabajan a ciegas, los desacuerdos los resuelve un tercero y la IA puede proponer un orden de lectura.

La pantalla de cribado

A la izquierda, la referencia (título, autores, año, revista, resumen) con las palabras clave del protocolo resaltadas. A la derecha, los criterios de inclusión y exclusión. Debajo, los botones de decisión. Las referencias llegan en el orden de importación o, si el coordinador lo ha activado, en el orden que propone la IA.

Tomar una decisión

1. Lee el título y el resumen.
2. Pulsa Incluir, Excluir o Quizás. Con el teclado: I, E, M.
3. Si excluyes, elige el motivo (opcional en esta fase; obligatorio en texto completo).
4. Pasa a la siguiente con →. Puedes volver atrás y cambiar una decisión mientras la fase esté abierta.

Lista de pendientes y marcas

• Lista de pendientes: el botón junto a Anterior y Siguiente abre las referencias que aún tienes que cribar, en el orden de la cola, con un filtro por título, autor o año. Haz clic en una para abrirla directamente.
• Marcar: el botón junto al título pone una marca en la referencia con un motivo (Esperando el PDF, Consultar con el equipo, Revisar más tarde u Otros) y una nota. La ve todo el equipo y no cambia ninguna decisión ni el orden de la cola. «Editar» la cambia y «Quitar la marca» la elimina.
• Marcadas: en la Lista de pendientes, el filtro «Marcadas» muestra solo las referencias pendientes marcadas, con el motivo y la nota. El número del botón indica cuántas tienes.

Modos y cegamiento

Mientras la fase está abierta, ningún revisor ve las decisiones de los demás. El coordinador sí: en la vista de coordinador ve el progreso de cada uno, las referencias pendientes y puede repartir el trabajo.

Conflictos y tercer revisor

Cuando dos revisores no coinciden, la referencia aparece en Conflictos. Quien resuelve ve las dos decisiones con los motivos y comentarios, decide y puede dejar una nota de resolución. «Duda» contra «Incluir» no es conflicto: pasa a texto completo. Con el botón Propuesta IA, la IA analiza el artículo con cada criterio de inclusión y exclusión del protocolo y, dentro de la misma tarjeta, recomienda incluir o excluir con un porcentaje de confianza, el motivo y por qué cree que los revisores han discrepado. «Copiar a la nota» la lleva a la nota de resolución, y el registro de actividad guarda la propuesta junto a la decisión final.

Sugerencias de la IA

Durante el cribado, el botón Sugerir con IA abre en la columna de valoración el mismo análisis que la resolución de conflictos: la IA revisa el artículo con el protocolo y propone incluir, excluir o duda. El coordinador también puede pedir una priorización de toda la cola (las referencias más probables salen primero) y un cribado automático de las que tienen una puntuación muy baja, siempre con un umbral de confianza y revisable. Todo queda en la declaración de uso de IA (capítulo 13).

• Recomendación: incluir, excluir o duda.
• Confianza en porcentaje, con una barra verde (alta, desde el 80 %), amarilla (media, desde el 60 %) o roja (baja).
• Motivo en dos a cuatro frases.
• Criterios del protocolo uno por uno: se cumple, no se cumple o no consta, con una nota breve.
• Botones «Copiar a la nota» y «Volver a generar». La decisión siempre la tomas tú.

Acuerdo entre revisores

El panel Equipo muestra el kappa de Cohen (dos revisores) o de Fleiss (más de dos) calculado sobre las referencias que todos han cribado, y cuántas le quedan a cada uno.

Enlace a este capítulo →

Texto completo

Las referencias incluidas pasan a leerse enteras. SysRevAI intenta conseguir el PDF automáticamente y te deja decidir junto al documento.

Conseguir los PDF

El módulo de recuperación automática consulta, en orden, fuentes legales de acceso abierto: PubMed Central, Europe PMC, Unpaywall, OpenAlex, Semantic Scholar, bioRxiv/medRxiv, arXiv, CrossRef y DOAJ. De cada fuente prueba todas las copias abiertas que conoce (la de la editorial y las de los repositorios), y si un enlace lleva a una página web en lugar del PDF, sigue su enlace al documento. Solo usa API oficiales y nunca salta ningún muro de pago ni ninguna verificación «no soy un robot». El worker de cron procesa la cola en segundo plano. Los PDF de PubMed Central los descarga de su depósito de datos abiertos (el canal oficial de la NLM para descargas automáticas), porque los enlaces «PDF» de las páginas de PMC piden una verificación del navegador.

• Buscar artículo completo: en la pantalla de cribado a texto completo, cuando un artículo todavía no tiene texto, el botón lo busca en ese momento en todas las fuentes abiertas. Si encuentra el texto pero no el PDF, lo muestra en un lector y sigue buscando un PDF. Si lo encuentra pero la fuente no permite la descarga automática, te lo dice («Hemos encontrado el artículo en…, pero hay que descargarlo manualmente») con el enlace para abrirlo. Si no lo encuentra en ninguna parte, te lo dice, te da el enlace a la editorial (DOI) y te pide que lo subas.
• Artículos de PubMed Central con restricción de la editorial: algunos artículos se pueden leer gratis en PMC pero la editorial no deja que ningún programa descargue el texto ni el PDF. En estos casos la plataforma te lo explica: abre el enlace, haz clic en «PDF», guarda el archivo y súbelo. Después de subirlo, sigues en la misma referencia.
• Cola: Texto completo → Cola muestra qué se ha encontrado, qué falta y por qué.
• Subida manual: para los artículos sin acceso abierto, sube el PDF que tengas por tu licencia institucional. Se puede subir uno a uno o en lote (ZIP con el DOI o el PMID en el nombre del archivo).
• Cobertura: Admin → Informes muestra el porcentaje de referencias con texto completo por revisión.

Cribar con el documento al lado

La pantalla muestra el PDF a la izquierda (o el texto extraído, si el PDF no se ha podido abrir) y los criterios y botones a la derecha. Aquí la exclusión siempre pide un motivo: es el que cuenta PRISMA.

Sin PDF

Si no hay manera de conseguir el documento, marca la referencia como «no recuperable». Queda contada en PRISMA como informe no recuperado, separada de las exclusiones por motivo.

Enlace a este capítulo →

Extracción de datos

De los estudios incluidos, el equipo extrae los datos con una plantilla propia de la revisión. Se puede hacer por duplicado y comparar.

Diseñar la plantilla

1. Extracción → Plantilla. Añade los campos que necesites: texto, número, fecha, lista de opciones, sí/no o texto largo.
2. Agrúpalos por secciones (características del estudio, participantes, intervención, resultados).
3. Marca los obligatorios. Guarda. La plantilla se puede ampliar más adelante sin perder datos.

Extraer

Cada estudio incluido tiene un formulario con la plantilla. El PDF (o el resumen) se muestra al lado para que no tengas que cambiar de ventana. Guarda a menudo: el formulario recuerda los cambios.

Pre-extracción con IA

Con una clave de IA, el botón Rellenar con IA propone un valor para cada campo vacío a partir del texto completo, con el fragmento de donde lo ha sacado. Tú verificas, corriges y guardas. Los campos que ya tienen valor no se tocan.

Doble extracción

Si dos revisores extraen el mismo estudio, la vista Comparar pone los dos formularios lado a lado y marca las diferencias. El coordinador aprueba la versión definitiva, que es la que se exporta.

Exportar los datos

Desde Exportar: CSV o Excel con una fila por estudio y una columna por campo, y un CSV en formato largo (estudio × campo × revisor) preparado para metafor, Stata o RevMan Web.

Enlace a este capítulo →

Riesgo de sesgo

Cada estudio incluido se evalúa con la herramienta adecuada a su diseño. Los juicios por dominio quedan justificados y se exportan para la tabla del informe.

Herramientas disponibles

Evaluar un estudio

1. Riesgo de sesgo → elige el estudio y la herramienta.
2. Para cada dominio, responde las preguntas guía, elige el juicio (bajo, algunas preocupaciones, alto) y escribe la justificación citando el texto.
3. El juicio global se calcula según el algoritmo de la herramienta; puedes sobrescribirlo con un motivo.
4. Guarda. Un segundo revisor puede hacer su evaluación y compararla.

Exportar

Exportar → Riesgo de sesgo genera un CSV con una fila por estudio, revisor y herramienta, y una columna por dominio con el juicio y la justificación. Sirve para hacer el gráfico de semáforos con robvis o directamente en el informe.

Enlace a este capítulo →

Síntesis, GRADE y exportaciones

El trabajo termina en documentos: el diagrama PRISMA 2020, la tabla de resumen de hallazgos con GRADE, las tablas de estudios y la bibliografía de los incluidos.

Diagrama PRISMA 2020

Se genera solo a partir de los contadores de la revisión: registros por fuente, duplicados eliminados, cribados, excluidos, informes no recuperados, excluidos a texto completo por motivo y estudios incluidos. Se descarga en SVG (editable) y cualquier celda se puede fijar a mano si hay que ajustar un recuento externo.

GRADE y resumen de hallazgos

1. Exportar → GRADE. Define los resultados (outcomes) de la revisión.
2. Para cada resultado, valora los cinco dominios (riesgo de sesgo, inconsistencia, evidencia indirecta, imprecisión, sesgo de publicación) y, si procede, los factores que suben la certeza.
3. La certeza final (alta, moderada, baja, muy baja) se calcula y se puede justificar.
4. Exporta la tabla de resumen de hallazgos en CSV o Word.

Todas las exportaciones

Página pública

Desde la revisión puedes crear un enlace público de solo lectura con el protocolo y la lista de estudios incluidos, útil para el apéndice del artículo o para colaboradores externos. Se puede revocar en cualquier momento.

Enlace a este capítulo →

Equipo, roles y notificaciones

Cada revisión tiene su equipo con roles propios. Las invitaciones llegan por correo o por enlace, y la plataforma avisa de todo lo que necesita tu atención.

Roles dentro de una revisión

Invitar

1. Revisión → Equipo → Invitar.
2. Indica el correo y el rol. Si la persona ya tiene cuenta, entra directamente en la revisión; si no, recibe un enlace para crearla.
3. Sin SMTP, crea una invitación por enlace y envíala por el canal que quieras. Caduca en 7 días.

Repartir el trabajo

En la vista de coordinador del cribado puedes asignar referencias a revisores concretos (por bloques, a partes iguales o a mano) y ver el progreso de cada uno. Las referencias no asignadas las puede cribar cualquier revisor.

Notificaciones

La campana del menú superior avisa de conflictos nuevos, menciones en comentarios, invitaciones y tareas asignadas. En Perfil → Notificaciones eliges cuáles quieres recibir también por correo y en la app móvil (capítulo 18).

Comentarios y menciones

Cualquier referencia admite comentarios. Escribe @nombre para avisar a un compañero. Los comentarios se ven en el cribado, en la resolución de conflictos y en la lista.

Enlace a este capítulo →

Herramientas: búsqueda global, citas, análisis de artículos

Fuera de las revisiones, el menú Herramientas reúne utilidades para cualquier investigador: buscar en varias bases de datos, normalizar bibliografías, verificar citas y trabajar con un artículo suelto.

Verificar citas antes de enviar

La verificación de citas es especialmente útil con bibliografías generadas con herramientas de IA: detecta referencias inexistentes, DOI que apuntan a otro artículo y años o autores que no cuadran. Pega la bibliografía, ejecuta y revisa las filas en rojo.

Análisis de artículos y equipos

Cada artículo analizado se puede compartir con otros usuarios. El informe crítico se puede exportar a Word. Las conversaciones quedan guardadas con el artículo.

Enlace a este capítulo →

Análisis de artículos

Una herramienta propia de SysRevAI, fuera de las revisiones: sube un artículo o tu manuscrito y la IA elabora un informe crítico, conversa sobre él con citas del texto y te ayuda a mejorar su redacción.

Está en Herramientas → Artículos. Cada artículo es un proyecto independiente, con su documento, la conversación con la IA, el informe crítico, los documentos relacionados y su equipo. Hace falta tener la IA activada (Admin → Claude).

Crear un proyecto

1. Herramientas → Artículos → Subir un artículo.
2. Ponle un título y sube el documento en PDF o Word (.docx, .doc), hasta 50 MB. La plataforma extrae el texto.
3. Si quieres, añade artículos o guías relacionados (por ejemplo, la guía CONSORT o un estudio de referencia): la IA los leerá junto al principal.

Informe crítico

Pulsa Elaborar informe crítico y elige el idioma (catalán, castellano, inglés o francés). La IA lee el artículo como un revisor exigente y devuelve:

• una puntuación de 0 a 100 en cinco ejes: metodología, claridad, novedad, evidencia y tratamiento de las limitaciones;
• un resumen ejecutivo;
• el abogado del diablo: las objeciones más fuertes que haría un revisor;
• recomendaciones concretas para cada sección.

El informe se puede volver a generar y se exporta a Word, solo o con la transcripción de la conversación.

Conversación con citas

En el chat, pregunta lo que quieras sobre el artículo («¿cuál es el tamaño de la muestra?», «¿qué limitaciones reconocen los autores?»). Las respuestas citan el texto del artículo y de los documentos relacionados, para que puedas comprobarlas. La conversación se guarda con el proyecto.

Apoyo a la redacción de tu manuscrito

1. Abre Edición colaborativa: el documento se abre en un editor con formato, tablas e imágenes.
2. Selecciona un fragmento (o nada, para trabajar todo el documento) y pide al Copilot lo que necesites: «reescríbelo en un tono más formal», «aclara esta frase», «añade una tabla con los resultados».
3. El Copilot propone el cambio y tú lo aceptas o lo rechazas.
4. Guarda versiones con nombre para volver a ellas cuando quieras, y descarga el documento en Word.

Trabajar en equipo

Desde Equipo invita a coautores por correo: si ya tienen cuenta, se añaden; si no, reciben un enlace de invitación válido 7 días. Todos ven el documento, el informe y la conversación.

Enlace a este capítulo →

La IA: qué hace, qué cuesta y cómo controlarla

SysRevAI usa modelos de lenguaje de Claude (Anthropic) con tu propia clave. La IA ayuda; no decide. Aquí tienes qué hace en cada fase, cómo se activa y cómo se controla el coste.

Activarla

1. Crea una clave de API en la consola de Anthropic.
2. Admin → Claude (IA): pega la clave (se guarda cifrada), elige el modelo por defecto y un límite de gasto mensual.
3. Activa o desactiva cada función: cribado, extracción, resúmenes, chat, protocolo, citas, Copilot.
4. Dentro de cada revisión, el coordinador puede desactivar la IA del todo.

Qué hace en cada fase

Costes y límites

Cada llamada se registra con el modelo, los tokens y el coste estimado en euros. En la revisión, la pestaña Uso de IA lo desglosa por función y persona; en Admin → Claude (IA) fijas el límite mensual global, y cuando se alcanza las funciones se detienen sin afectar al resto de la plataforma.

La declaración de uso de IA

Cada revisión genera automáticamente una declaración de uso de IA: en qué fases se ha usado, con qué modelos y con qué volumen. Se exporta en Word para incluirla en los métodos del artículo, como piden cada vez más revistas.

Enlace a este capítulo →

Revisiones vivas y API

Una revisión viva se mantiene al día: las búsquedas guardadas se repiten solas y avisan de las referencias nuevas. La API permite leer los datos desde otras herramientas.

Búsquedas guardadas

1. Haz una búsqueda externa desde la revisión (Buscar → Bases de datos).
2. Pulsa Guardar la búsqueda: se guardan la consulta, los filtros y las bases de datos.
3. En Revisión → Búsquedas guardadas, activa la repetición automática (semanal o mensual).
4. El worker la vuelve a ejecutar; las referencias nuevas entran marcadas como «nuevas desde la última búsqueda» y recibes una notificación.

API de lectura

En Perfil → API puedes crear un token personal. Con ese token, otros programas pueden leer tus revisiones, referencias y el PRISMA en JSON.

curl -H "Authorization: Bearer TU_TOKEN" https://tu-instalacion/api/v1/reviews

Enlace a este capítulo →

Actualizaciones, copias y mantenimiento

Todo el mantenimiento se hace desde el panel: actualizar a la versión nueva, hacer y descargar copias, poner el sitio en mantenimiento y vigilar el worker.

Actualizar

1. La plataforma comprueba sola cada 6 horas si hay una versión nueva en sysrevai.com. Cuando la hay, los administradores ven una barra oscura arriba de todas las páginas («Hay una nueva versión de SysRevAI disponible») con el botón Actualizar ahora. La barra no se puede cerrar y desaparece sola una vez actualizado.
2. El botón abre Admin → Mantenimiento con la comprobación ya hecha: la versión disponible, las novedades y las comprobaciones previas. También puedes ir a mano y pulsar «Buscar actualizaciones».
3. Si todas las comprobaciones pasan, pulsa «Actualizar ahora».
4. La plataforma activa el modo mantenimiento, hace una copia de la base de datos, descarga el paquete con tu licencia, verifica su integridad, sustituye el código (conservando .env, storage/ y public/uploads/), aplica las migraciones y vuelve a abrir el sitio.
5. Si una migración falla, el código anterior se restaura y la copia queda a mano. El registro de cada actualización se guarda con su log.

Copias de seguridad

Admin → Mantenimiento → Copias completas: el worker hace automáticamente, cada 2 horas, una copia de toda la plataforma (base de datos, PDF, protocolos, artículos, credenciales, avatares y .env) y conserva las 24 más recientes; las más antiguas se borran solas. Puedes cambiar la frecuencia y cuántas se guardan, hacer una a mano y descargarlas. Para restaurar una, desde el servidor: php bin/console.php backup:restore storage/backups/<archivo>.zip --yes (con --with-env recupera también el .env). Descarga de vez en cuando una copia fuera del servidor.

Modo mantenimiento

Muestra una página de aviso a todos excepto a los administradores. Útil durante migraciones o cambios de servidor.

Worker y trabajos

Admin → Mantenimiento → Tareas programadas (cron) indica si el worker funciona y cuándo se ejecutó por última vez; si no funciona, tienes la línea de cron exacta para este servidor y los pasos para configurarla. Admin → Trabajos en segundo plano muestra la cola de tareas (valoraciones masivas con IA, búsquedas programadas, compilaciones).

Dónde está cada cosa

Exportar e importar datos (portabilidad)

Cada usuario puede descargar todo lo que ha creado desde Perfil → Mis datos: un archivo ZIP con sus revisiones (protocolo, referencias, decisiones, conflictos, extracción, riesgo de sesgo, GRADE, etiquetas, comentarios y registro de uso de IA), los PDF y los artículos. El mismo archivo se importa en cualquier otra instalación desde la misma pantalla.

• Las revisiones importadas pasan a ser de quien importa; los colaboradores se vinculan por el correo y, si no tienen cuenta, se crean desactivados (no ocupan plaza hasta que el administrador los activa).
• La importación es todo o nada: si algo falla, no se guarda nada.
• Para importar archivos grandes, aumenta upload_max_filesize y post_max_size en el PHP del servidor.

Enlace a este capítulo →

Soporte

Todas las cuentas de prueba y todas las instalaciones, Community e Institucional, tienen un sistema de soporte integrado: se pide ayuda al equipo de SysRevAI con tickets, desde la propia plataforma.

Quién tiene acceso

El resto de usuarios (revisores, miembros invitados) ven en Soporte quién administra su plataforma, para dirigirse a esa persona directamente.

Abrir un ticket

1. Pulsa el botón Soporte, en la barra superior, junto a «Guía de uso».
2. Pulsa Nuevo ticket. Escribe el asunto, elige el tipo (problema técnico, licencia e instalación, sugerencia u otros) y la prioridad, y describe qué pasa, qué esperabas y cómo reproducirlo.
3. Si hace falta, adjunta archivos: hasta 5 por mensaje (capturas de pantalla, PDF, documentos de Office o LibreOffice, texto, registros, CSV, RIS, BibTeX o ZIP), de 5 MB cada uno y 10 MB en total.
4. Envíalo. Recibirás un correo cuando el equipo de SysRevAI responda.

Información del sistema

Cada ticket lleva automáticamente la información técnica de la instalación: versión y edición, PHP y base de datos, extensiones que faltan, límites del servidor, número de usuarios y revisiones, estado de las tareas cron y si el correo y la IA están configurados. Así el equipo de soporte ve el entorno sin tener que preguntarlo. No incluye contraseñas, claves ni datos personales. En la pantalla de nuevo ticket aparece plegada: ábrela con la flecha del recuadro «Información del sistema» si quieres revisarla.

Seguir el ticket

• Las respuestas de SysRevAI aparecen en la conversación del ticket, con los archivos que se adjunten.
• El botón Soporte muestra en rojo cuántos tickets tienen una respuesta que aún no has abierto; en la lista llevan la etiqueta «Respuesta nueva».
• Puedes responder, también con archivos, tantas veces como haga falta. Si el ticket estaba resuelto o cerrado, responderlo lo vuelve a abrir.
• Cuando ya no lo necesites, pulsa Cerrar el ticket.

Edición Institucional: instalación en vuestros servidores

La edición Institucional incluye soporte para instalar SysRevAI en los servidores de la entidad, coordinado con vuestro servicio de informática. Para solicitarlo, escríbenos desde Contacto.

Enlace a este capítulo →

La app móvil

SysRevAI tiene app para iPhone, iPad y Android, en el móvil y en la tableta. Criba referencias, lee el texto completo, resuelve conflictos, comenta con el equipo y usa las herramientas, también sin conexión.

Una sola app sirve para todos los SysRevAI: las cuentas de prueba de sysrevai.com y la instalación propia de cualquier institución. Entras con el mismo usuario que en la web, ves las mismas revisiones y tus decisiones acaban en el mismo servidor. Lo que se hace mejor en una pantalla grande (la administración de la plataforma) sigue en la web, y la app te lleva a ella cuando hace falta.

Instalarla

1. En el iPhone o el iPad, busca «SysRevAI» en la App Store.
2. En un móvil o una tableta Android, búscala en Google Play.

Conectarla con tu servidor

Qué puedes hacer

• Inicio: lo que tienes pendiente en cada revisión y el botón «Continuar cribando».
• Cribado de título y resumen y de texto completo, con los términos del protocolo resaltados, los motivos de exclusión, notas y la propuesta de la IA si el servidor la tiene.
• Lista de artículos: el botón de la parte superior del cribado muestra los artículos pendientes y los que ya has cribado. Toca uno para cribarlo, o para cambiar tu decisión.
• Texto completo: el PDF con los términos resaltados, la búsqueda (con la lupa, que dice cuántos resultados hay) y el zoom, y los criterios del protocolo al lado. Si la IA ha evaluado el artículo, cada criterio aparece como cumplido, no cumplido o dudoso.
• Referencias: la lista de la revisión con filtros (estado, texto, etiqueta, fuente) y acciones sobre las marcadas: cribarlas por título y resumen, etiquetarlas o borrarlas (solo la persona propietaria). También importar un archivo del teléfono (Archivos, iCloud, Drive, un adjunto) o texto pegado, con previsualización; buscar referencias nuevas con los filtros del protocolo y guardar la búsqueda; las búsquedas guardadas; y los duplicados.
• Ficha de cada referencia (desde la lista o desde el cribado): el texto completo (abrir el PDF, subir uno desde el teléfono, sustituirlo, borrarlo o buscarlo ahora en las fuentes abiertas), las marcas de cada fase, y el resumen, la revisión por pares y el chat de la IA. En Texto completo de la revisión, la cobertura y la cola de búsqueda en segundo plano. En los conflictos, la propuesta de resolución de la IA.
• Gestión de la revisión: crear una nueva (la IA puede rellenar el formulario a partir del documento del protocolo, en PDF o Word), editar el protocolo, el equipo (invitar por correo, roles, ciego, quién resuelve conflictos), la configuración (archivar, el enlace público de consulta, borrar una revisión archivada) y la coordinación de cada fase: iniciarla, repartir el trabajo y hacer que la IA valore la cola y acepte sus veredictos más seguros. Cada persona ve lo que su rol le permite, como en la web.
• Estudios incluidos, pensado sobre todo para la tableta, con el PDF o el resumen del estudio junto al formulario: la extracción de datos (la IA puede rellenarte el borrador; la persona propietaria edita la plantilla y aprueba las extracciones), el riesgo de sesgo (RoB 2, ROBINS-I, Newcastle-Ottawa o JBI, con el diagrama semáforo, el gráfico resumen y la propuesta de la IA por dominio) y GRADE con la tabla de resumen de hallazgos. En el teléfono, un selector arriba pasa del formulario al estudio.
• Resultados y difusión: el diagrama PRISMA (y el editor para fijar celdas a mano), todos los archivos de la pestaña Exportar de la web (se descargan al teléfono y se abre el menú de compartir), el formulario de registro PROSPERO/OSF con el borrador de la IA, y la declaración de uso de la IA. Los comentarios se pueden borrar (los propios, o cualquiera si eres la persona propietaria).
• Conflictos, para quien los resuelve.
• Comentarios en cada referencia y en el tablón de la revisión. Al escribir @ te sugiere el equipo, y la persona mencionada recibe un aviso.
• Avisos de la plataforma y notificaciones push.
• Herramientas: las mismas de la web (más abajo).
• Soporte, para los administradores: consultas al equipo de SysRevAI con capturas de pantalla.

Trabajar sin conexión

• La app guarda en el teléfono una tanda de referencias de tu cola. Antes de un viaje, toca «Descargar 200 referencias para trabajar sin conexión».
• Cada decisión se guarda al momento y se envía en cuanto hay conexión; arriba ves cuántas quedan por enviar. Mientras no se haya enviado, puedes deshacer la última.
• Si otro revisor completó la referencia mientras estabas sin conexión, la app te avisa de que tu decisión no ha contado: el servidor siempre manda.
• En el texto completo, los PDF de la tanda (los 20 primeros) se descargan con ella y también se leen sin conexión. Los que ya están en el teléfono llevan la marca «Guardado para leer sin conexión».
• Los comentarios, la propuesta de la IA y las herramientas necesitan conexión. En Perfil → Datos sin conexión ves cuánto ocupa todo y puedes vaciarlo.

En la tableta

• En el iPad y en las tabletas Android, la navegación pasa a una barra lateral.
• El cribado se ve a dos columnas: la tanda a un lado y la referencia al otro.
• En el texto completo, el PDF queda a un lado y los criterios, la propuesta de la IA, las notas y la decisión al otro.
• Con un teclado conectado: I incluye, M marca como dudosa y E excluye (como en la web) (después, 1-9 elige el motivo y 0, ninguno).
• Las herramientas muestran la lista y el detalle a la vez. Con la app a media pantalla (Split View o las ventanas de Android) vuelve a la disposición del móvil sin perder lo que hacías.

Notificaciones

La app avisa cuando te invitan a una revisión, te asignan referencias, hay un conflicto, te mencionan o te devuelven trabajo. En la web, la columna «App móvil» de Perfil → Notificaciones decide cuáles recibes. El aviso solo lleva una frase genérica («Tienes un conflicto nuevo por resolver»); al tocarlo, la app pide el detalle directamente a tu servidor. Las instalaciones propias envían los avisos a través de sysrevai.com con su licencia, pero sin títulos, nombres ni decisiones.

Herramientas

• Verificar citas en CrossRef, OpenAlex y Europe PMC (hasta 15 por vez): pegadas, de una revisión o escaneando una bibliografía impresa con la cámara. El texto se reconoce en el propio móvil y lo revisas antes de verificar.
• Normalizar citas a cualquiera de los 8 estilos, para copiarlas, compartirlas o añadirlas a una revisión.
• Las últimas verificaciones y normalizaciones quedan en Recientes, para volver a abrirlas.
• Buscar referencias en las bases externas, en tus referencias o con una pregunta clínica, y añadir las que elijas a una revisión; los duplicados se detectan.
• Análisis de artículos: sube un PDF o un Word, genera el informe crítico, pregunta a la IA sobre el artículo o mejora un párrafo de tu manuscrito. Normalizar, el informe y el chat necesitan que el servidor tenga la IA configurada (capítulo 14).

Idioma, seguridad y actualizaciones

• Idioma: la app usa el del teléfono, y se cambia en Perfil → Idioma. Tiene todos los idiomas de la plataforma, y uno nuevo aparece sin actualizar la app.
• Dispositivos: cada teléfono tiene su propia sesión. En la web, Perfil → App móvil lista tus dispositivos conectados y te deja cerrar la sesión de uno que hayas perdido.
• Modo ciego: se aplica igual que en la web. Si la revisión es ciega, la app no recibe las decisiones del resto del equipo.
• Actualizaciones: la app se actualiza sola en segundo plano y aplica la versión nueva al volver a abrirla; en el perfil aparece un aviso para reiniciarla al momento.
• Cerrar sesión borra del teléfono las tandas y los PDF guardados. Las decisiones que aún no se hayan enviado se pierden, así que hazlo con conexión.

Dudas frecuentes

Enlace a este capítulo →

Preguntas frecuentes

Las respuestas cortas a las preguntas que nos llegan más a menudo. Si la tuya no está, escríbenos.

Enlace a este capítulo →

Buenas prácticas

Recomendaciones metodológicas y de organización que hemos visto que hacen las revisiones más rápidas y más defendibles.

Antes de empezar

• Cierra el protocolo y regístralo (PROSPERO, OSF) antes de importar referencias. Cambiar criterios a medio cribado obliga a volver atrás.
• Haz un piloto con 50 referencias y todo el equipo. Comparad decisiones, ajustad criterios y después abrid la fase de verdad.
• Definid los motivos de exclusión con el equipo: pocos, excluyentes y ordenados de más a menos restrictivo.

Durante el cribado

• Sesiones cortas y regulares (30–45 minutos) mantienen la consistencia mejor que las maratones.
• Revisad los conflictos cada semana: resolverlos pronto recalibra al equipo.
• Mirad el kappa. Por debajo de 0,6, parad y aclarad criterios.
• Usad «Quizás» con criterio: es una reserva, no una manera de aplazar la decisión.

Con la IA

• Empezad por la priorización; el cribado automático solo para referencias con puntuación muy baja y siempre con muestreo de comprobación.
• Verificad siempre la pre-extracción contra el fragmento citado.
• Incluid la declaración de uso de IA en los métodos del artículo.

Seguridad y datos

• Verificación en dos pasos para todos los que tengan rol de administrador.
• Comprobad en Admin → Mantenimiento que el cron dice «Funciona»: sin él no hay copias automáticas. Descargad de vez en cuando una copia completa fuera del servidor.
• Actualizad cuando salga una versión nueva: las actualizaciones hacen copia y revierten si hace falta.
• No subáis a la plataforma PDF que no podáis compartir con el equipo según vuestra licencia.

Enlace a este capítulo →