SysRevAI, paso a paso

Primeiros pasos

SysRevAI é unha plataforma que se instala no servidor da túa institución para facer revisións sistemáticas e de alcance con axuda da IA. Este capítulo lévate de cero a ter o programa descargado e a licenza na man.

Que é SysRevAI

Abrangue todo o fluxo dunha revisión: protocolo, importación e desduplicación de referencias, cribado por título e resumo, texto completo, extracción de datos, risco de nesgo, síntese con GRADE e exportacións (diagrama PRISMA 2020, Word, Excel, RIS). A IA está como axudante: prioriza, suxire e resume, pero cada decisión tómaa unha persoa e queda rexistrada.

Os datos nunca saen do teu servidor. As chamadas á IA fanse coa túa propia chave e pódense desactivar revisión por revisión.

Probalo sen instalar

Se queres ver como funciona antes de instalar nada, crea unha conta de proba de 30 días en sysrevai.com/prova. Podes convidar ata 5 persoas e facer unha revisión real (ata 3 revisións, 500 MB de PDF e un pequeno orzamento de IA por equipo). O día 20 recibirás un aviso; o día 30 a conta bloquéase e só podes exportar os datos, e 7 días despois bórrase. Antes, exporta todo desde Perfil → Mis datos e impórtao na túa instalación.

Que necesitas

O número de licenza

Ten o formato SRAI-XXXXX-XXXXX-XXXXX-XXXXX. É gratuíto, identifica a túa instalación para recibir actualizacións e é válido para un dominio e ata 10 usuarios activos. O instalador pídeo no paso 7 e é obrigatorio: sempre se valida con sysrevai.com e non se pode omitir.

Sen chave de IA tamén funciona

Non fai falta ningunha chave de intelixencia artificial para instalar nin para facer a revisión. As funcións asistidas (propostas de cribado e de resolución de conflitos, priorización, preextracción, resumos, chat co artigo) actívanse cando engades unha chave da API de Claude en Admin → Claude (IA). Verémolo no capítulo 3.

Ligazón a este capítulo →

Instalación no servidor

O asistente web fai todo o traballo en nove pantallas. Non fai falta liña de comandos: só subir ficheiros, crear a base de datos e seguir os pasos.

Subir os ficheiros

1. Descomprime o ZIP. Dentro hai un só cartafol, sysrevai/.
2. Súbeo enteiro ao servidor (SFTP, o xestor de ficheiros do hosting ou scp).
3. Configura o sitio web para que o directorio público (document root) sexa sysrevai/public. En CloudPanel, Plesk ou cPanel é unha opción do sitio; en Nginx ou Apache, unha liña na configuración do vhost.
4. Asegúrate de que PHP pode escribir en storage/ e en public/uploads/.

O asistente, paso a paso

Despois de instalar

• O cron, imprescindible. Engade un cron que execute cada minuto php /ruta/sysrevai/bin/worker.php como usuario do sitio web. Sen el non se fan as copias automáticas, a busca e descarga de artigos, as buscas programadas, os traballos longos de IA nin a comprobación de actualizacións. O instalador dáche a liña exacta ao final e, mentres non funcione, os administradores ven unha barra laranxa en todas as páxinas co botón «Cómo configurar el cron», que leva a Admin → Mantenimiento → Tareas programadas (cron): a liña para copiar, os pasos por SSH ou cun panel (CloudPanel, Plesk, cPanel) e o estado. Cando o cron xa se executa, a tarxeta di «Funciona» e a barra desaparece.
• Instalador selado. Unha vez rematado, /install/ xa non se abre. Podes borrar o cartafol public/install/ se o prefires.
• Copias. Unha vez que funciona o cron, a plataforma fai por si soa unha copia completa cada 2 horas (capítulo 15).

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

Problemas habituais

Ligazón a este capítulo →

Configuración inicial (Admin)

Unha vez dentro, o panel de administración (menú superior → Configuración) centraliza todo o que afecta á instalación: IA, correo, usuarios, seguranza e valores predeterminados das revisións.

Orde recomendada

Todas as seccións

Roles da plataforma

• Propietario: todo. Sempre debe haber polo menos un e non se pode eliminar a si mesmo.
• Administrador: configuración e usuarios, pero non pode degradar o propietario.
• Usuario: crea revisións e participa nelas. Os permisos dentro de cada revisión fíxaos o seu coordinador (capítulo 11).

Páxinas legais

Admin → Páginas legales xera a política de privacidade e as condicións de uso a partir de modelos co nome da institución, o correo de contacto e a data. Revísaas antes de abrir o rexistro: os usuarios acéptanas ao crear a conta.

Ligazón a este capítulo →

Crear unha revisión e o protocolo

Unha revisión é o espazo de traballo dun equipo: o protocolo, as referencias, as decisións e as exportacións. Todo comeza definindo a pregunta.

Crear a revisión

1. No taboleiro, preme Nueva revisión.
2. Indica o título, o tipo (sistemática ou de alcance) e o marco da pregunta: PICO para intervencións ou PCC (poboación, concepto, contexto) para revisións de alcance.
3. Elixe o modo de cribado: un só revisor, dobre cego, dobre cego con terceiro revisor ou piloto. Pódese cambiar máis adiante mentres non haxa decisións.
4. Garda. Xa podes convidar o equipo (capítulo 11) ou seguir co protocolo.

O protocolo

A lapela Protocolo recolle a pregunta, os criterios de inclusión e exclusión, os motivos de exclusión que se usarán no cribado, a estratexia de busca por base de datos e as notas metodolóxicas. Os criterios alimentan o realce de palabras clave durante o cribado.

Motivos de exclusión

Defíneos antes de comezar a cribar: cada exclusión a texto completo necesita un, e son os que aparecen no diagrama PRISMA. Os valores predeterminados pódense cambiar en Admin → Revisiones.

O taboleiro da revisión

A páxina principal de cada revisión mostra o estado de cada fase (referencias, cribado, texto completo, extracción, risco de nesgo, exportacións) con contadores, quen ten traballo pendente e a actividade recente. A barra de fases da parte superior é o camiño: cada paso ilumínase cando está rematado.

Ligazón a este capítulo →

Importar referencias e duplicados

As referencias entran por ficheiro, por busca directa ou pegando texto. Despois, a desduplicación deixa unha soa copia de cada estudo.

Formatos aceptados

Importar paso a paso

1. Dentro da revisión, vai a Referencias → Importar.
2. Elixe o formato, sobe o ficheiro (ou pega o texto) e indica a fonte (a base de datos da que procede). A fonte é a que aparece no diagrama PRISMA.
3. Revisa a previsualización: cada referencia ten unha caixa e unha marca verde se ten DOI ou PMID. Desmarca as que non queiras.
4. Confirma. As referencias quedan na fase de cribado por título e resumo.

Busca directa

Desde Buscar (menú superior) podes consultar PubMed, CrossRef, OpenAlex e Europe PMC á vez, ver a relevancia de cada resultado e envialos á revisión sen pasar por ningún ficheiro. As buscas pódense gardar e repetir (capítulo 14).

Desduplicación

Referencias → Duplicados busca coincidencias en tres pasadas: identificadores exactos (DOI, PMID), título normalizado e semellanza (algoritmo Jaro-Winkler con autores e ano). Cada parella proposta confírmase ou descártase; consérvase a referencia con máis metadatos e a outra queda marcada como duplicado, fóra do cribado pero contabilizada en PRISMA.

Etiquetas e busca local

Na lista de referencias podes filtrar por fase, decisión, fonte, etiqueta ou texto, e aplicar accións masivas (etiquetar, mover de fase, exportar). As etiquetas son libres e serven para calquera clasificación propia: «dubidoso», «pedir á biblioteca», «subestudo A».

Ligazón a este capítulo →

Cribado de título e resumo

A fase na que o equipo decide, referencia a referencia, que pasa a texto completo. Dous revisores traballan a cegas, os desacordos resólveos un terceiro e a IA pode propor unha orde de lectura.

A pantalla de cribado

Á esquerda, a referencia (título, autores, ano, revista, resumo) coas palabras clave do protocolo realzadas. Á dereita, os criterios de inclusión e exclusión. Debaixo, os botóns de decisión. As referencias chegan na orde de importación ou, se o coordinador o activou, na orde que propón a IA.

Tomar unha decisión

1. Le o título e o resumo.
2. Preme Incluir, Excluir ou Quizás. Co teclado: I, E, M.
3. Se exclúes, elixe o motivo (opcional nesta fase; obrigatorio en texto completo).
4. Pasa á seguinte con →. Podes volver atrás e cambiar unha decisión mentres a fase estea aberta.

Lista de pendentes e marcas

• Lista de pendientes: o botón situado xunto a Anterior e Siguiente abre as referencias que aínda tes que cribar, na orde da cola, cun filtro por título, autor ou ano. Fai clic nunha para abrila directamente.
• Marcar: o botón situado xunto ao título pon unha marca na referencia cun motivo (Esperando el PDF, Consultar con el equipo, Revisar más tarde u Otros) e unha nota. É visible para todo o equipo e non cambia ningunha decisión nin a orde da cola. «Editar» cámbiaa e «Quitar la marca» elimínaa.
• Marcadas: na Lista de pendientes, o filtro «Marcadas» mostra só as referencias pendentes marcadas, co motivo e a nota. O número do botón indica cantas tes.

Modos e cegamento

Mentres a fase está aberta, ningún revisor ve as decisións dos demais. O coordinador si: na vista de coordinador ve o progreso de cada un e as referencias pendentes, e pode repartir o traballo.

Conflitos e terceiro revisor

Cando dous revisores non coinciden, a referencia aparece en Conflictos. Quen resolve ve as dúas decisións cos motivos e comentarios, decide e pode deixar unha nota de resolución. «Quizás» fronte a «Incluir» non é conflito: pasa a texto completo. Co botón Propuesta IA, a IA analiza o artigo con cada criterio de inclusión e exclusión do protocolo e, dentro da mesma tarxeta, recomenda incluír ou excluír cunha porcentaxe de confianza, o motivo e por que cre que os revisores discreparon. «Copiar a la nota» lévaa á nota de resolución, e o rexistro de actividade garda a proposta xunto á decisión final.

Suxestións da IA

Durante o cribado, o botón Sugerir con IA abre na columna de valoración a mesma análise que a resolución de conflitos: a IA revisa o artigo co protocolo e propón incluír, excluír ou dúbida. O coordinador tamén pode pedir unha priorización de toda a cola (as referencias máis probables saen primeiro) e un cribado automático das que teñen unha puntuación moi baixa, sempre cun limiar de confianza e revisable. Todo queda na declaración de uso de IA (capítulo 13).

• Recomendación: incluír, excluír ou dúbida.
• Confianza en porcentaxe, cunha barra verde (alta, desde o 80 %), amarela (media, desde o 60 %) ou vermella (baixa).
• Motivo en dúas a catro frases.
• Criterios do protocolo un por un: cúmprese, non se cumpre ou non consta, cunha nota breve.
• Botóns «Copiar a la nota» e «Volver a generar». A decisión tómala sempre ti.

Acordo entre revisores

O panel Equipo mostra o kappa de Cohen (dous revisores) ou de Fleiss (máis de dous) calculado sobre as referencias que todos cribaron, e cantas lle quedan a cada un.

Ligazón a este capítulo →

Texto completo

As referencias incluídas pasan a lerse enteiras. SysRevAI tenta conseguir o PDF automaticamente e permíteche decidir co documento ao lado.

Conseguir os PDF

O módulo de recuperación automática consulta, por orde, fontes legais de acceso aberto: PubMed Central, Europe PMC, Unpaywall, OpenAlex, Semantic Scholar, bioRxiv/medRxiv, arXiv, CrossRef e DOAJ. De cada fonte proba todas as copias abertas que coñece (a da editorial e as dos repositorios) e, se unha ligazón leva a unha páxina web en lugar do PDF, segue a súa ligazón ata o documento. Só usa API oficiais e nunca salta ningún muro de pagamento nin ningunha verificación «non son un robot». O worker de cron procesa a cola en segundo plano. Os PDF de PubMed Central descárgaos do seu depósito de datos abertos (a canle oficial da NLM para descargas automáticas), porque as ligazóns «PDF» das páxinas de PMC piden unha verificación do navegador.

• Buscar artículo completo: na pantalla de cribado a texto completo, cando un artigo aínda non ten texto, o botón búscao nese momento en todas as fontes abertas. Se atopa o texto pero non o PDF, móstrao nun lector e segue buscando un PDF. Se o atopa pero a fonte non permite a descarga automática, dícecho («Hemos encontrado el artículo en…, pero hay que descargarlo manualmente») coa ligazón para abrilo. Se non o atopa en ningures, dícecho, dáche a ligazón á editorial (DOI) e pídeche que o subas.
• Artigos de PubMed Central con restrición da editorial: algúns artigos pódense ler de balde en PMC, pero a editorial non deixa que ningún programa descargue o texto nin o PDF. Nestes casos a plataforma explícacho: abre a ligazón, fai clic en «PDF», garda o ficheiro e súbeo. Despois de subilo, continúas na mesma referencia.
• Cola: Texto completo → Cola mostra que se atopou, que falta e por que.
• Subida manual: para os artigos sen acceso aberto, sobe o PDF que teñas a través da túa licenza institucional. Pódese subir un a un ou en lote (ZIP co DOI ou o PMID no nome do ficheiro).
• Cobertura: Admin → Informes mostra a porcentaxe de referencias con texto completo por revisión.

Cribar co documento ao lado

A pantalla mostra o PDF á esquerda (ou o texto extraído, se non se puido abrir o PDF) e os criterios e botóns á dereita. Aquí a exclusión sempre pide un motivo: é o que conta para PRISMA.

Sen PDF

Se non hai maneira de conseguir o documento, marca a referencia como «no recuperable». Queda contabilizada en PRISMA como informe non recuperado, separada das exclusións por motivo.

Ligazón a este capítulo →

Extracción de datos

Dos estudos incluídos, o equipo extrae os datos cun modelo propio da revisión. Pódese facer por duplicado e comparar.

Deseñar o modelo

1. Extracción → Plantilla. Engade os campos que necesites: texto, número, data, lista de opcións, si/non ou texto longo.
2. Agrúpaos por seccións (características do estudo, participantes, intervención, resultados).
3. Marca os obrigatorios. Garda. O modelo pódese ampliar máis adiante sen perder datos.

Extraer

Cada estudo incluído ten un formulario co modelo. O PDF (ou o resumo) móstrase ao lado para que non teñas que cambiar de xanela. Garda a miúdo: o formulario lembra os cambios.

Preextracción con IA

Cunha chave de IA, o botón Rellenar con IA propón un valor para cada campo baleiro a partir do texto completo, co fragmento de onde o tirou. Ti verificas, corrixes e gardas. Os campos que xa teñen valor non se tocan.

Dobre extracción

Se dous revisores extraen o mesmo estudo, a vista Comparar pon os dous formularios lado a lado e marca as diferenzas. O coordinador aproba a versión definitiva, que é a que se exporta.

Exportar os datos

Desde Exportar: CSV ou Excel cunha fila por estudo e unha columna por campo, e un CSV en formato longo (estudo × campo × revisor) preparado para metafor, Stata ou RevMan Web.

Ligazón a este capítulo →

Risco de nesgo

Cada estudo incluído avalíase coa ferramenta adecuada ao seu deseño. Os xuízos por dominio quedan xustificados e expórtanse para a táboa do informe.

Ferramentas dispoñibles

Avaliar un estudo

1. Riesgo de sesgo → elixe o estudo e a ferramenta.
2. Para cada dominio, responde ás preguntas guía, elixe o xuízo (baixo, algunhas preocupacións, alto) e escribe a xustificación citando o texto.
3. O xuízo global calcúlase segundo o algoritmo da ferramenta; podes sobrescribilo indicando un motivo.
4. Garda. Un segundo revisor pode facer a súa avaliación e comparala.

Exportar

Exportar → Riesgo de sesgo xera un CSV cunha fila por estudo, revisor e ferramenta, e unha columna por dominio co xuízo e a xustificación. Serve para facer o gráfico de semáforos con robvis ou directamente no informe.

Ligazón a este capítulo →

Síntese, GRADE e exportacións

O traballo remata en documentos: o diagrama PRISMA 2020, a táboa de resumo de achados con GRADE, as táboas de estudos e a bibliografía dos incluídos.

Diagrama PRISMA 2020

Xérase automaticamente a partir dos contadores da revisión: rexistros por fonte, duplicados eliminados, cribados, excluídos, informes non recuperados, excluídos a texto completo por motivo e estudos incluídos. Descárgase en SVG (editable) e calquera cela se pode fixar a man se cómpre axustar un reconto externo.

GRADE e resumo de achados

1. Exportar → GRADE. Define os resultados (outcomes) da revisión.
2. Para cada resultado, valora os cinco dominios (risco de nesgo, inconsistencia, evidencia indirecta, imprecisión, nesgo de publicación) e, se procede, os factores que aumentan a certeza.
3. A certeza final (alta, moderada, baixa, moi baixa) calcúlase e pódese xustificar.
4. Exporta a táboa de resumo de achados en CSV ou Word.

Todas as exportacións

Páxina pública

Desde a revisión podes crear unha ligazón pública de só lectura co protocolo e a lista de estudos incluídos, útil para o apéndice do artigo ou para colaboradores externos. Pódese revogar en calquera momento.

Ligazón a este capítulo →

Equipo, roles e notificacións

Cada revisión ten o seu equipo con roles propios. Os convites chegan por correo ou por ligazón, e a plataforma avisa de todo o que necesita a túa atención.

Roles dentro dunha revisión

Convidar

1. Revisión → Equipo → Invitar.
2. Indica o correo e o rol. Se a persoa xa ten conta, entra directamente na revisión; se non, recibe unha ligazón para creala.
3. Sen SMTP, crea un convite por ligazón e envíao pola canle que queiras. Caduca en 7 días.

Repartir o traballo

Na vista de coordinador do cribado podes asignar referencias a revisores concretos (por bloques, a partes iguais ou a man) e ver o progreso de cada un. Calquera revisor pode cribar as referencias non asignadas.

Notificacións

A campá do menú superior avisa de conflitos novos, mencións en comentarios, convites e tarefas asignadas. En Perfil → Notificaciones elixes cales queres recibir tamén por correo e na app móbil (capítulo 18).

Comentarios e mencións

Calquera referencia admite comentarios. Escribe @nome para avisar un compañeiro. Os comentarios vense no cribado, na resolución de conflitos e na lista.

Ligazón a este capítulo →

Ferramentas: busca global, citas, análise de artigos

Fóra das revisións, o menú Herramientas reúne utilidades para calquera investigador: buscar en varias bases de datos, normalizar bibliografías, verificar citas e traballar cun artigo solto.

Verificar citas antes de enviar

A verificación de citas é especialmente útil con bibliografías xeradas con ferramentas de IA: detecta referencias inexistentes, DOI que apuntan a outro artigo e anos ou autores que non cadran. Pega a bibliografía, executa a verificación e revisa as filas en vermello.

Análise de artigos e equipos

Cada artigo analizado pódese compartir con outros usuarios. O informe crítico pódese exportar a Word. As conversas quedan gardadas co artigo.

Ligazón a este capítulo →

Análise de artigos

Unha ferramenta propia de SysRevAI, fóra das revisións: sobe un artigo ou o teu manuscrito e a IA elabora un informe crítico, conversa sobre el con citas do texto e axúdache a mellorar a súa redacción.

Está en Herramientas → Artículos. Cada artigo é un proxecto independente, co seu documento, a conversa coa IA, o informe crítico, os documentos relacionados e o seu equipo. Cómpre ter a IA activada (Admin → Claude).

Crear un proxecto

1. Herramientas → Artículos → Subir un artículo.
2. Ponlle un título e sobe o documento en PDF ou Word (.docx, .doc), ata 50 MB. A plataforma extrae o texto.
3. Se queres, engade artigos ou guías relacionados (por exemplo, a guía CONSORT ou un estudo de referencia): a IA lereos xunto ao principal.

Informe crítico

Preme Elaborar informe crítico e escolle o idioma (catalán, castelán, inglés ou francés). A IA le o artigo como un revisor esixente e devolve:

• unha puntuación de 0 a 100 en cinco eixes: metodoloxía, claridade, novidade, evidencia e tratamento das limitacións;
• un resumo executivo;
• o avogado do diaño: as obxeccións máis fortes que faría un revisor;
• recomendacións concretas para cada sección.

O informe pódese volver xerar e expórtase a Word, só ou coa transcrición da conversa.

Conversa con citas

No chat, pregunta o que queiras sobre o artigo («cal é o tamaño da mostra?», «que limitacións recoñecen os autores?»). As respostas citan o texto do artigo e dos documentos relacionados, para que as poidas comprobar. A conversa gárdase co proxecto.

Apoio á redacción do teu manuscrito

1. Abre Edición colaborativa: o documento ábrese nun editor con formato, táboas e imaxes.
2. Selecciona un fragmento (ou nada, para traballar todo o documento) e pídelle ao Copilot o que necesites: «reescríbeo nun ton máis formal», «aclara esta frase», «engade unha táboa cos resultados».
3. O Copilot propón o cambio e ti acéptalo ou rexéitalo.
4. Garda versións con nome para volver a elas cando queiras, e descarga o documento en Word.

Traballar en equipo

Desde Equipo convida coautores por correo: se xa teñen conta, engádense; se non, reciben unha ligazón de invitación válida 7 días. Todos ven o documento, o informe e a conversa.

Ligazón a este capítulo →

A IA: que fai, canto custa e como controlala

SysRevAI usa modelos de linguaxe de Claude (Anthropic) coa túa propia chave. A IA axuda; non decide. Aquí tes que fai en cada fase, como se activa e como se controla o custo.

Activala

1. Crea unha chave de API na consola de Anthropic.
2. Admin → Claude (IA): pega a chave (gárdase cifrada), elixe o modelo predeterminado e un límite de gasto mensual.
3. Activa ou desactiva cada función: cribado, extracción, resumos, chat, protocolo, citas, Copilot.
4. Dentro de cada revisión, o coordinador pode desactivar a IA por completo.

Que fai en cada fase

Custos e límites

Cada chamada rexístrase co modelo, os tokens e o custo estimado en euros. Na revisión, a lapela Uso de IA desagrégao por función e persoa; en Admin → Claude (IA) fixas o límite mensual global e, cando se alcanza, as funcións detéñense sen afectar o resto da plataforma.

A declaración de uso de IA

Cada revisión xera automaticamente unha declaración de uso de IA: en que fases se usou, con que modelos e con que volume. Expórtase en Word para incluíla nos métodos do artigo, como piden cada vez máis revistas.

Ligazón a este capítulo →

Revisións vivas e API

Unha revisión viva mantense ao día: as buscas gardadas repítense soas e avisan das referencias novas. A API permite ler os datos desde outras ferramentas.

Buscas gardadas

1. Fai unha busca externa desde a revisión (Buscar → Bases de datos).
2. Preme Guardar la búsqueda: gárdanse a consulta, os filtros e as bases de datos.
3. En Revisión → Búsquedas guardadas, activa a repetición automática (semanal ou mensual).
4. O worker vólvea executar; as referencias novas entran marcadas como «nuevas desde la última búsqueda» e recibes unha notificación.

API de lectura

En Perfil → API podes crear un token persoal. Con ese token, outros programas poden ler as túas revisións, as referencias e o PRISMA en JSON.

curl -H "Authorization: Bearer O_TEU_TOKEN" https://a-tua-instalacion/api/v1/reviews

Ligazón a este capítulo →

Actualizacións, copias e mantemento

Todo o mantemento faise desde o panel: actualizar á versión nova, facer e descargar copias, poñer o sitio en mantemento e vixiar o worker.

Actualizar

1. A plataforma comproba por si soa cada 6 horas se hai unha versión nova en sysrevai.com. Cando a hai, os administradores ven unha barra escura na parte superior de todas as páxinas («Hay una nueva versión de SysRevAI disponible») co botón Actualizar ahora. A barra non se pode pechar e desaparece soa unha vez feita a actualización.
2. O botón abre Admin → Mantenimiento coa comprobación xa feita: a versión dispoñible, as novidades e as comprobacións previas. Tamén podes ir alí a man e premer «Buscar actualizaciones».
3. Se se superan todas as comprobacións, preme «Actualizar ahora».
4. A plataforma activa o modo mantemento, fai unha copia da base de datos, descarga o paquete coa túa licenza, verifica a súa integridade, substitúe o código (conservando .env, storage/ e public/uploads/), aplica as migracións e volve abrir o sitio.
5. Se unha migración falla, restáurase o código anterior e a copia queda á man. O rexistro de cada actualización gárdase co seu log.

Copias de seguranza

Admin → Mantenimiento → Copias completas: o worker fai automaticamente, cada 2 horas, unha copia de toda a plataforma (base de datos, PDF, protocolos, artigos, credenciais, avatares e .env) e conserva as 24 máis recentes; as máis antigas bórranse soas. Podes cambiar a frecuencia e cantas se gardan, facer unha a man e descargalas. Para restaurar unha, desde o servidor: php bin/console.php backup:restore storage/backups/<ficheiro>.zip --yes (con --with-env recupera tamén o .env). Descarga de cando en vez unha copia fóra do servidor.

Modo mantemento

Mostra unha páxina de aviso a todo o mundo agás aos administradores. Útil durante migracións ou cambios de servidor.

Worker e traballos

Admin → Mantenimiento → Tareas programadas (cron) indica se o worker funciona e cando se executou por última vez; se non funciona, alí tes a liña de cron exacta para este servidor e os pasos para configurala. Admin → Trabajos en segundo plano mostra a cola de tarefas (valoracións masivas con IA, buscas programadas, compilacións).

Onde está cada cousa

Exportar e importar datos (portabilidade)

Cada usuario pode descargar todo o que creou desde Perfil → Mis datos: un ficheiro ZIP coas súas revisións (protocolo, referencias, decisións, conflitos, extracción, risco de nesgo, GRADE, etiquetas, comentarios e rexistro de uso de IA), os PDF e os artigos. O mesmo ficheiro impórtase en calquera outra instalación desde a mesma pantalla.

• As revisións importadas pasan a ser de quen as importa; os colaboradores vincúlanse polo correo e, se non teñen conta, créanse desactivados (non ocupan praza ata que o administrador os activa).
• A importación é todo ou nada: se algo falla, non se garda nada.
• Para importar ficheiros grandes, aumenta upload_max_filesize e post_max_size no PHP do servidor.

Ligazón a este capítulo →

Soporte

Todas as contas de proba e todas as instalacións, Community e Institucional, teñen un sistema de soporte integrado: pídeselle axuda ao equipo de SysRevAI con tiques, desde a propia plataforma.

Quen ten acceso

O resto dos usuarios (revisores, membros convidados) ven en Soporte quen administra a súa plataforma, para dirixirse a esa persoa directamente.

Abrir un tique

1. Preme o botón Soporte, na barra superior, xunto a «Guía de uso».
2. Preme Novo tique. Escribe o asunto, escolle o tipo (problema técnico, licenza e instalación, suxestión ou outros) e a prioridade, e describe que pasa, que esperabas e como reproducilo.
3. Se fai falta, anexa ficheiros: ata 5 por mensaxe (capturas de pantalla, PDF, documentos de Office ou LibreOffice, texto, rexistros, CSV, RIS, BibTeX ou ZIP), de 5 MB cada un e 10 MB en total.
4. Envíao. Recibirás un correo cando o equipo de SysRevAI responda.

Información do sistema

Cada tique leva automaticamente a información técnica da instalación: versión e edición, PHP e base de datos, extensións que faltan, límites do servidor, número de usuarios e revisións, estado das tarefas cron e se o correo e a IA están configurados. Así o equipo de soporte ve o contorno sen ter que preguntalo. Non inclúe contrasinais, chaves nin datos persoais. Na pantalla de novo tique aparece pregada: ábrea coa frecha do cadro «Información do sistema» se a queres revisar.

Seguir o tique

• As respostas de SysRevAI aparecen na conversa do tique, cos ficheiros que se lle anexen.
• O botón Soporte mostra en vermello cantos tiques teñen unha resposta que aínda non abriches; na lista levan a etiqueta «Resposta nova».
• Podes responder, tamén con ficheiros, tantas veces como faga falta. Se o tique estaba resolto ou pechado, respondelo vólveo abrir.
• Cando xa non o necesites, preme Pechar o tique.

Edición Institucional: instalación nos vosos servidores

A edición Institucional inclúe soporte para instalar SysRevAI nos servidores da entidade, coordinado co voso servizo de informática. Para solicitalo, escríbenos desde Contacto.

Ligazón a este capítulo →

A app móbil

SysRevAI ten app para iPhone, iPad e Android, no móbil e na tableta. Criba referencias, le o texto completo, resolve conflitos, comenta co equipo e usa as ferramentas, tamén sen conexión.

Unha soa app serve para todos os SysRevAI: as contas de proba de sysrevai.com e a instalación propia de calquera institución. Entras co mesmo usuario que na web, ves as mesmas revisións e as túas decisións acaban no mesmo servidor. O que se fai mellor nunha pantalla grande (a administración da plataforma) segue na web, e a app lévate a ela cando fai falta.

Instalala

1. No iPhone ou no iPad, busca «SysRevAI» na App Store.
2. Nun móbil ou nunha tableta Android, búscaa en Google Play.

Conectala co teu servidor

Que podes facer

• Inicio: o que tes pendente en cada revisión e o botón «Continuar cribando».
• Cribado por título e resumo e por texto completo, cos termos do protocolo resaltados, os motivos de exclusión, notas e a proposta da IA se o servidor a ten.
• Lista de artigos: o botón da parte superior do cribado amosa os artigos pendentes e os que xa cribaches. Toca un para cribalo, ou para cambiar a túa decisión.
• Texto completo: o PDF cos termos resaltados, a busca (coa lupa, que di cantos resultados hai) e o zoom, e os criterios do protocolo ao lado. Se a IA avaliou o artigo, cada criterio aparece como cumprido, non cumprido ou dubidoso.
• Referencias: a lista da revisión con filtros (estado, texto, etiqueta, fonte) e accións sobre as marcadas: cribalas por título e resumo, etiquetalas ou borralas (só a persoa propietaria). Tamén importar un ficheiro do teléfono (Ficheiros, iCloud, Drive, un anexo) ou texto pegado, con previsualización; buscar referencias novas cos filtros do protocolo e gardar a busca; as buscas gardadas; e os duplicados.
• Ficha de cada referencia (desde a lista ou desde o cribado): o texto completo (abrir o PDF, subir un desde o teléfono, substituílo, borralo ou buscalo agora nas fontes abertas), as marcas de cada fase, e o resumo, a revisión por pares e o chat da IA. En Texto completo da revisión, a cobertura e a cola de busca en segundo plano. Nos conflitos, a proposta de resolución da IA.
• Xestión da revisión: crear unha nova (a IA pode encher o formulario a partir do documento do protocolo, en PDF ou Word), editar o protocolo, o equipo (convidar por correo, roles, cego, quen resolve conflitos), a configuración (arquivar, a ligazón pública de consulta, borrar unha revisión arquivada) e a coordinación de cada fase: iniciala, repartir o traballo e facer que a IA valore a cola e acepte os seus veredictos máis seguros. Cada persoa ve o que o seu rol lle permite, como na web.
• Estudos incluídos, pensado sobre todo para a tableta, co PDF ou o resumo do estudo xunto ao formulario: a extracción de datos (a IA pode encherche o borrador; a persoa propietaria edita o modelo e aproba as extraccións), o risco de nesgo (RoB 2, ROBINS-I, Newcastle-Ottawa ou JBI, co diagrama semáforo, o gráfico resumo e a proposta da IA por dominio) e GRADE coa táboa de resumo de achados. No teléfono, un selector arriba pasa do formulario ao estudo.
• Resultados e difusión: o diagrama PRISMA (e o editor para fixar celas a man), todos os ficheiros da pestana Exportar da web (descárganse no teléfono e ábrese o menú de compartir), o formulario de rexistro PROSPERO/OSF co borrador da IA, e a declaración de uso da IA. Os comentarios pódense borrar (os propios, ou calquera se es a persoa propietaria).
• Conflitos, para quen os resolve.
• Comentarios en cada referencia e no taboleiro da revisión. Ao escribir @ suxíreche o equipo, e a persoa mencionada recibe un aviso.
• Avisos da plataforma e notificacións push.
• Ferramentas: as mesmas da web (máis abaixo).
• Soporte, para os administradores: consultas ao equipo de SysRevAI con capturas de pantalla.

Traballar sen conexión

• A app garda no teléfono unha tanda de referencias da túa cola. Antes dunha viaxe, toca «Descargar 200 referencias para traballar sen conexión».
• Cada decisión gárdase ao momento e envíase en canto hai conexión; arriba ves cantas quedan por enviar. Mentres non se enviou, podes desfacer a última.
• Se outro revisor completou a referencia mentres estabas sen conexión, a app avísate de que a túa decisión non contou: o servidor sempre manda.
• No texto completo, os PDF da tanda (os 20 primeiros) descárganse con ela e tamén se len sen conexión. Os que xa están no teléfono levan a marca «Gardado para ler sen conexión».
• Os comentarios, a proposta da IA e as ferramentas precisan conexión. En Perfil → Datos sen conexión ves canto ocupa todo e podes baleiralo.

Na tableta

• No iPad e nas tabletas Android, a navegación pasa a unha barra lateral.
• O cribado vese a dúas columnas: a tanda a un lado e a referencia ao outro.
• No texto completo, o PDF queda a un lado e os criterios, a proposta da IA, as notas e a decisión ao outro.
• Cun teclado conectado: I inclúe, M marca como dubidosa e E exclúe (como na web) (despois, 1-9 escolle o motivo e 0, ningún).
• As ferramentas mostran a lista e o detalle á vez. Coa app a media pantalla (Split View ou as xanelas de Android) volve á disposición do móbil sen perder o que facías.

Notificacións

A app avisa cando te invitan a unha revisión, che asignan referencias, hai un conflito, te mencionan ou che devolven traballo. Na web, a columna «App móvil» de Perfil → Notificaciones decide cales recibes. O aviso só leva unha frase xenérica («Tes un conflito novo por resolver»); ao tocalo, a app pídelle o detalle directamente ao teu servidor. As instalacións propias envían os avisos a través de sysrevai.com coa súa licenza, pero sen títulos, nomes nin decisións.

Ferramentas

• Verificar citas en CrossRef, OpenAlex e Europe PMC (ata 15 por vez): pegadas, dunha revisión ou escaneando unha bibliografía impresa coa cámara. O texto recoñécese no propio móbil e revísalo antes de verificar.
• Normalizar citas a calquera dos 8 estilos, para copialas, compartilas ou engadilas a unha revisión.
• As últimas verificacións e normalizacións quedan en Recentes, para volver abrilas.
• Buscar referencias nas bases externas, nas túas referencias ou cunha pregunta clínica, e engadir as que escollas a unha revisión; os duplicados detéctanse.
• Análise de artigos: sube un PDF ou un Word, xera o informe crítico, pregunta á IA sobre o artigo ou mellora un parágrafo do teu manuscrito. Normalizar, o informe e o chat precisan que o servidor teña a IA configurada (capítulo 14).

Idioma, seguridade e actualizacións

• Idioma: a app usa o do teléfono, e cámbiase en Perfil → Idioma. Ten todos os idiomas da plataforma, e un novo aparece sen actualizar a app.
• Dispositivos: cada teléfono ten a súa propia sesión. Na web, Perfil → App móvil lista os teus dispositivos conectados e déixache pechar a sesión dun que perdeses.
• Modo cego: aplícase igual que na web. Se a revisión é cega, a app non recibe as decisións do resto do equipo.
• Actualizacións: a app actualízase soa en segundo plano e aplica a versión nova ao volvela abrir; no perfil aparece un aviso para reiniciala ao momento.
• Pechar a sesión borra do teléfono as tandas e os PDF gardados. As decisións que aínda non se enviaron pérdense, así que faino con conexión.

Dúbidas frecuentes

Ligazón a este capítulo →

Preguntas frecuentes

As respostas curtas ás preguntas que nos chegan máis a miúdo. Se a túa non está, escríbenos.

Ligazón a este capítulo →

Boas prácticas

Recomendacións metodolóxicas e de organización que, segundo a nosa experiencia, fan as revisións máis rápidas e máis defendibles.

Antes de comezar

• Pecha o protocolo e rexístrao (PROSPERO, OSF) antes de importar referencias. Cambiar criterios a medio cribado obriga a volver atrás.
• Fai un piloto con 50 referencias e todo o equipo. Comparade as decisións, axustade os criterios e despois abride a fase de verdade.
• Definide os motivos de exclusión co equipo: poucos, mutuamente excluíntes e ordenados de máis a menos restritivo.

Durante o cribado

• As sesións curtas e regulares (30–45 minutos) manteñen a consistencia mellor que as maratóns.
• Revisade os conflitos cada semana: resolvelos axiña recalibra o equipo.
• Mirade o kappa. Por debaixo de 0,6, parade e aclarade os criterios.
• Usade «Quizás» con criterio: é unha reserva, non unha maneira de adiar a decisión.

Coa IA

• Comezade pola priorización; o cribado automático, só para referencias con puntuación moi baixa e sempre cunha mostraxe de comprobación.
• Verificade sempre a preextracción contrastándoa co fragmento citado.
• Incluíde a declaración de uso de IA nos métodos do artigo.

Seguranza e datos

• Verificación en dous pasos para todas as persoas con rol de administrador.
• Comprobade en Admin → Mantenimiento que o cron di «Funciona»: sen el non hai copias automáticas. Descargade de cando en vez unha copia completa fóra do servidor.
• Actualizade cando saia unha versión nova: as actualizacións fan copia e reverten os cambios se cómpre.
• Non subades á plataforma PDF que non poidades compartir co equipo segundo a vosa licenza.

Ligazón a este capítulo →