SysRevAI, pas a pas

Primers passos

SysRevAI és una plataforma que s’instal·la al servidor de la teva institució per fer revisions sistemàtiques i d’abast amb ajuda d’IA. Aquest capítol et porta de zero a tenir el programa descarregat i la llicència a la mà.

Què és SysRevAI

Cobreix tot el flux d’una revisió: protocol, importació i desduplicació de referències, cribratge per títol i resum, text complet, extracció de dades, risc de biaix, síntesi amb GRADE i exportacions (diagrama PRISMA 2020, Word, Excel, RIS). La IA hi és com a ajudant: prioritza, suggereix i resumeix, però cada decisió la pren una persona i queda registrada.

Les dades no surten mai del teu servidor. Les crides a la IA es fan amb la teva pròpia clau i es poden desactivar revisió per revisió.

Provar-ho sense instal·lar

Si vols veure com funciona abans d’instal·lar res, crea un compte de prova de 30 dies a sysrevai.com/prova. Hi pots convidar fins a 5 persones i fer una revisió real (fins a 3 revisions, 500 MB de PDF i un petit pressupost d’IA per equip). Al dia 20 rebràs un avís; al dia 30 el compte es bloqueja i només pots exportar les dades, i 7 dies després s’esborra. Abans, exporta-ho tot des de Perfil → Les meves dades i importa-ho a la teva instal·lació.

Què necessites

El número de llicència

Té el format SRAI-XXXXX-XXXXX-XXXXX-XXXXX. És gratuït, identifica la teva instal·lació per rebre actualitzacions i és vàlid per a un domini i fins a 10 usuaris actius. L’instal·lador el demana al pas 7 i és obligatori: sempre es valida amb sysrevai.com i no es pot ometre.

Sense clau d’IA també funciona

No cal cap clau d’intel·ligència artificial per instal·lar ni per fer la revisió. Les funcions assistides (propostes de cribratge i de resolució de conflictes, priorització, pre-extracció, resums, xat amb l’article) s’activen quan afegeixes una clau de l’API de Claude a Admin → Claude (IA). Ho veurem al capítol 3.

Enllaç a aquest capítol →

Instal·lació al servidor

L’assistent web fa tota la feina en nou pantalles. No cal línia d’ordres: només pujar fitxers, crear la base de dades i seguir els passos.

Pujar els fitxers

1. Descomprimeix el ZIP. Dins hi ha una sola carpeta, sysrevai/.
2. Puja-la sencera al servidor (SFTP, el gestor de fitxers del hosting o scp).
3. Configura el lloc web perquè el directori públic (document root) sigui sysrevai/public. Amb CloudPanel, Plesk o cPanel és una opció del lloc; amb Nginx o Apache, una línia a la configuració del vhost.
4. Assegura’t que PHP pot escriure a storage/ i a public/uploads/.

L’assistent, pas a pas

Després d’instal·lar

• El cron, imprescindible. Afegeix un cron que executi cada minut php /ruta/sysrevai/bin/worker.php com a usuari del lloc web. Sense ell no es fan les còpies automàtiques, la cerca i descàrrega d’articles, les cerques programades, els treballs llargs d’IA ni la comprovació d’actualitzacions. L’instal·lador et dona la línia exacta al final i, mentre no funcioni, els administradors veuen una barra taronja a totes les pàgines amb el botó «Com configurar el cron», que porta a Admin → Manteniment → Tasques programades (cron): la línia per copiar, els passos per SSH o amb un panell (CloudPanel, Plesk, cPanel) i l’estat. Quan el cron ja corre, la targeta diu «Funciona» i la barra desapareix.
• Instal·lador segellat. Un cop acabat, /install/ ja no s’obre. Pots esborrar la carpeta public/install/ si ho prefereixes.
• Còpies. Un cop funciona el cron, la plataforma fa sola una còpia completa cada 2 hores (capítol 15).

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

Problemes habituals

Enllaç a aquest capítol →

Configuració inicial (Admin)

Un cop dins, el panell d’administració (menú superior → Configuració) centralitza tot el que afecta la instal·lació: IA, correu, usuaris, seguretat i valors per defecte de les revisions.

Ordre recomanat

Totes les seccions

Rols de la plataforma

• Propietari: tot. Només n’hi pot haver un com a mínim i no es pot eliminar a si mateix.
• Administrador: configuració i usuaris, però no pot degradar el propietari.
• Usuari: crea i participa en revisions. Els permisos dins de cada revisió els fixa el seu coordinador (capítol 11).

Pàgines legals

Admin → Pàgines legals genera la política de privacitat i les condicions d’ús a partir de plantilles amb el nom de la institució, el correu de contacte i la data. Revisa-les abans d’obrir el registre: els usuaris les accepten en crear el compte.

Enllaç a aquest capítol →

Crear una revisió i el protocol

Una revisió és l’espai de treball d’un equip: el protocol, les referències, les decisions i les exportacions. Tot comença definint la pregunta.

Crear la revisió

1. Al tauler, prem Nova revisió.
2. Indica el títol, el tipus (sistemàtica o d’abast) i el marc de la pregunta: PICO per a intervencions o PCC (població, concepte, context) per a revisions d’abast.
3. Tria el mode de cribratge: un sol revisor, doble cec, doble cec amb tercer revisor o pilot. Es pot canviar més endavant mentre no hi hagi decisions.
4. Desa. Ja pots convidar l’equip (capítol 11) o seguir amb el protocol.

El protocol

La pestanya Protocol recull la pregunta, els criteris d’inclusió i exclusió, els motius d’exclusió que es faran servir al cribratge, l’estratègia de cerca per base de dades i les notes metodològiques. Els criteris alimenten el ressaltat de paraules clau durant el cribratge.

Motius d’exclusió

Defineix-los abans de començar a cribrar: cada exclusió a text complet en necessita un, i són els que apareixen al diagrama PRISMA. Els valors per defecte es poden canviar a Admin → Revisions.

El tauler de la revisió

La pàgina principal de cada revisió mostra l’estat de cada fase (referències, cribratge, text complet, extracció, risc de biaix, exportacions) amb comptadors, qui té feina pendent i l’activitat recent. La barra de fases de dalt és el camí: cada pas s’il·lumina quan està acabat.

Enllaç a aquest capítol →

Importar referències i duplicats

Les referències entren per fitxer, per cerca directa o enganxant text. Després, la desduplicació deixa una sola còpia de cada estudi.

Formats acceptats

Importar pas a pas

1. Dins de la revisió, ves a Referències → Importar.
2. Tria el format, puja el fitxer (o enganxa el text) i indica la font (la base de dades d’on prové). La font és la que surt al diagrama PRISMA.
3. Revisa la previsualització: cada referència té una casella i una marca verda si té DOI o PMID. Desmarca les que no vulguis.
4. Confirma. Les referències queden a la fase de cribratge per títol i resum.

Cerca directa

Des de Cercar (menú superior) pots consultar PubMed, CrossRef, OpenAlex i Europe PMC alhora, veure la rellevància de cada resultat i enviar-los a la revisió sense passar per cap fitxer. Les cerques es poden desar i repetir (capítol 14).

Desduplicació

Referències → Duplicats busca coincidències en tres passades: identificadors exactes (DOI, PMID), títol normalitzat i semblança (algoritme Jaro-Winkler amb autors i any). Cada parella proposada es confirma o es descarta; es conserva la referència amb més metadades i l’altra queda marcada com a duplicat, fora del cribratge però comptada a PRISMA.

Etiquetes i cerca local

A la llista de referències pots filtrar per fase, decisió, font, etiqueta o text, i aplicar accions massives (etiquetar, moure de fase, exportar). Les etiquetes són lliures i serveixen per a qualsevol classificació pròpia: «dubtós», «demanar a biblioteca», «subestudi A».

Enllaç a aquest capítol →

Cribratge de títol i resum

La fase on l’equip decideix, referència a referència, què passa a text complet. Dos revisors treballen a cegues, els desacords els resol un tercer i la IA pot proposar un ordre de lectura.

La pantalla de cribratge

A l’esquerra, la referència (títol, autors, any, revista, resum) amb les paraules clau del protocol ressaltades. A la dreta, els criteris d’inclusió i exclusió. A sota, els botons de decisió. Les referències arriben en l’ordre d’importació o, si el coordinador ho ha activat, en l’ordre que proposa la IA.

Prendre una decisió

1. Llegeix el títol i el resum.
2. Prem Incloure, Excloure o Potser. Amb el teclat: I, E, M.
3. Si exclous, tria el motiu (opcional en aquesta fase; obligatori a text complet).
4. Passa a la següent amb →. Pots tornar enrere i canviar una decisió mentre la fase estigui oberta.

Llista de pendents i marques

• Llista de pendents: el botó al costat d’Anterior i Següent obre les referències que encara has de cribrar, en l’ordre de la cua, amb un filtre per títol, autor o any. Fes clic en una per obrir-la directament.
• Marcar: el botó al costat del títol posa una marca a la referència amb un motiu (Esperant el PDF, Consultar amb l’equip, Revisar més tard o Altres) i una nota. La veu tot l’equip i no canvia cap decisió ni l’ordre de la cua. «Editar» la canvia i «Treure la marca» l’elimina.
• Marcades: a la Llista de pendents, el filtre «Marcades» mostra només les referències pendents marcades, amb el motiu i la nota. El número al botó indica quantes en tens.

Modes i cegament

Mentre la fase està oberta, cap revisor veu les decisions dels altres. El coordinador sí: a la vista de coordinador veu el progrés de cadascú, les referències pendents i pot repartir la feina.

Conflictes i tercer revisor

Quan dos revisors no coincideixen, la referència apareix a Conflictes. Qui resol veu les dues decisions amb els motius i comentaris, decideix i pot deixar una nota de resolució. «Potser» contra «Incloure» no és conflicte: passa a text complet. Amb el botó Proposta IA, la IA analitza l’article amb cada criteri d’inclusió i exclusió del protocol i, dins la mateixa targeta, recomana incloure o excloure amb un percentatge de confiança, el motiu i per què creu que els revisors han discrepat. «Copiar a la nota» la porta a la nota de resolució, i el registre d’activitat guarda la proposta al costat de la decisió final.

Suggeriments de la IA

Durant el cribratge, el botó Suggerir amb IA obre a la columna de valoració la mateixa anàlisi que la resolució de conflictes: la IA revisa l’article amb el protocol i proposa incloure, excloure o dubte. El coordinador també pot demanar una priorització de tota la cua (les referències més probables surten primer) i un cribratge automàtic de les que tenen una puntuació molt baixa, sempre amb un llindar de confiança i revisable. Tot queda a la declaració d’ús d’IA (capítol 13).

• Recomanació: incloure, excloure o dubte.
• Confiança en percentatge, amb una barra verda (alta, a partir del 80 %), groga (mitjana, del 60 %) o vermella (baixa).
• Motiu en dues o quatre frases.
• Criteris del protocol un per un: es compleix, no es compleix o no consta, amb una nota breu.
• Botons «Copiar a la nota» i «Tornar a generar». La decisió sempre la prens tu.

Acord entre revisors

El panell Equip mostra el kappa de Cohen (dos revisors) o de Fleiss (més de dos) calculat sobre les referències que tots han cribrat, i quantes en queden a cadascú.

Enllaç a aquest capítol →

Text complet

Les referències incloses passen a llegir-se senceres. SysRevAI intenta aconseguir el PDF automàticament i et deixa decidir al costat del document.

Aconseguir els PDF

El mòdul de recuperació automàtica consulta, en ordre, fonts legals d’accés obert: PubMed Central, Europe PMC, Unpaywall, OpenAlex, Semantic Scholar, bioRxiv/medRxiv, arXiv, CrossRef i DOAJ. De cada font prova totes les còpies obertes que coneix (la de l’editorial i les dels repositoris), i si un enllaç porta a una pàgina web en lloc del PDF, en segueix l’enllaç al document. Només fa servir API oficials i mai salta cap mur de pagament ni cap verificació «no sóc un robot». El worker de cron processa la cua en segon pla. Els PDF de PubMed Central els baixa del seu dipòsit de dades obertes (el canal oficial de l’NLM per a descàrregues automàtiques), perquè els enllaços «PDF» de les pàgines de PMC demanen una verificació del navegador.

• Cercar article complet: a la pantalla de cribratge a text complet, quan un article encara no té text, el botó el busca en aquell moment a totes les fonts obertes. Si en troba el text però no el PDF, el mostra en un lector i continua buscant un PDF. Si el troba però la font no en permet la descàrrega automàtica, t’ho diu («Hem trobat l’article a…, però cal descarregar-lo manualment») amb l’enllaç per obrir-lo. Si no el troba enlloc, t’ho diu, et dona l’enllaç a l’editorial (DOI) i et demana que el pugis.
• Articles de PubMed Central amb restricció de l’editorial: alguns articles es poden llegir gratis a PMC però l’editorial no deixa que cap programa en descarregui el text ni el PDF. En aquests casos la plataforma t’ho explica: obre l’enllaç, fes clic a «PDF», desa el fitxer i puja’l. Després de pujar-lo, continues a la mateixa referència.
• Cua: Text complet → Cua mostra què s’ha trobat, què falta i per què.
• Pujada manual: per als articles sense accés obert, puja el PDF que tinguis per la teva llicència institucional. Es pot pujar un per un o en lot (ZIP amb el DOI o el PMID al nom del fitxer).
• Cobertura: Admin → Informes mostra el percentatge de referències amb text complet per revisió.

Cribrar amb el document al costat

La pantalla mostra el PDF a l’esquerra (o el text extret, si el PDF no s’ha pogut obrir) i els criteris i botons a la dreta. Aquí l’exclusió sempre demana un motiu: és el que compta PRISMA.

Sense PDF

Si no hi ha manera d’aconseguir el document, marca la referència com a «no recuperable». Queda comptada a PRISMA com a informe no recuperat, separada de les exclusions per motiu.

Enllaç a aquest capítol →

Extracció de dades

Dels estudis inclosos, l’equip extreu les dades amb una plantilla pròpia de la revisió. Es pot fer per duplicat i comparar.

Dissenyar la plantilla

1. Extracció → Plantilla. Afegeix els camps que necessitis: text, número, data, llista d’opcions, sí/no o text llarg.
2. Agrupa’ls per seccions (característiques de l’estudi, participants, intervenció, resultats).
3. Marca els obligatoris. Desa. La plantilla es pot ampliar més endavant sense perdre dades.

Extreure

Cada estudi inclòs té un formulari amb la plantilla. El PDF (o el resum) es mostra al costat perquè no hagis de canviar de finestra. Desa sovint: el formulari recorda els canvis.

Pre-extracció amb IA

Amb una clau d’IA, el botó Omplir amb IA proposa un valor per a cada camp buit a partir del text complet, amb el fragment d’on l’ha tret. Tu verifiques, corregeixes i desa. Els camps que ja tenen valor no es toquen.

Doble extracció

Si dos revisors extreuen el mateix estudi, la vista Comparar posa els dos formularis costat a costat i marca les diferències. El coordinador aprova la versió definitiva, que és la que s’exporta.

Exportar les dades

Des d’Exportar: CSV o Excel amb una fila per estudi i una columna per camp, i un CSV en format llarg (estudi × camp × revisor) preparat per a metafor, Stata o RevMan Web.

Enllaç a aquest capítol →

Risc de biaix

Cada estudi inclòs s’avalua amb l’eina adequada al seu disseny. Els judicis per domini queden justificats i s’exporten per a la taula de l’informe.

Eines disponibles

Avaluar un estudi

1. Risc de biaix → tria l’estudi i l’eina.
2. Per a cada domini, respon les preguntes guia, tria el judici (baix, algunes preocupacions, alt) i escriu la justificació citant el text.
3. El judici global es calcula segons l’algoritme de l’eina; pots sobreescriure’l amb un motiu.
4. Desa. Un segon revisor pot fer la seva avaluació i comparar-la.

Exportar

Exportar → Risc de biaix genera un CSV amb una fila per estudi, revisor i eina, i una columna per domini amb el judici i la justificació. Serveix per fer el gràfic de semàfors amb robvis o directament a l’informe.

Enllaç a aquest capítol →

Síntesi, GRADE i exportacions

La feina acaba en documents: el diagrama PRISMA 2020, la taula de resum de troballes amb GRADE, les taules d’estudis i la bibliografia dels inclosos.

Diagrama PRISMA 2020

Es genera sol a partir dels comptadors de la revisió: registres per font, duplicats eliminats, cribrats, exclosos, informes no recuperats, exclosos a text complet per motiu i estudis inclosos. Es descarrega en SVG (editable) i qualsevol cel·la es pot fixar a mà si cal ajustar un recompte extern.

GRADE i resum de troballes

1. Exportar → GRADE. Defineix els resultats (outcomes) de la revisió.
2. Per a cada resultat, valora els cinc dominis (risc de biaix, inconsistència, evidència indirecta, imprecisió, biaix de publicació) i, si escau, els factors que apugen la certesa.
3. La certesa final (alta, moderada, baixa, molt baixa) es calcula i es pot justificar.
4. Exporta la taula de resum de troballes en CSV o Word.

Totes les exportacions

Pàgina pública

Des de la revisió pots crear un enllaç públic de només lectura amb el protocol i la llista d’estudis inclosos, útil per a l’apèndix de l’article o per a col·laboradors externs. Es pot revocar en qualsevol moment.

Enllaç a aquest capítol →

Equip, rols i notificacions

Cada revisió té el seu equip amb rols propis. Les invitacions arriben per correu o per enllaç, i la plataforma avisa de tot el que necessita la teva atenció.

Rols dins d’una revisió

Convidar

1. Revisió → Equip → Convidar.
2. Indica el correu i el rol. Si la persona ja té compte, entra directament a la revisió; si no, rep un enllaç per crear-lo.
3. Sense SMTP, crea una invitació per enllaç i envia-la pel canal que vulguis. Caduca en 7 dies.

Repartir la feina

A la vista de coordinador del cribratge pots assignar referències a revisors concrets (per blocs, a parts iguals o a mà) i veure el progrés de cadascú. Les referències no assignades les pot cribrar qualsevol revisor.

Notificacions

La campana del menú superior avisa de conflictes nous, mencions en comentaris, invitacions i tasques assignades. A Perfil → Notificacions tries quines vols rebre també per correu i a l’app mòbil (capítol 18).

Comentaris i mencions

Qualsevol referència admet comentaris. Escriu @nom per avisar un company. Els comentaris es veuen al cribratge, a la resolució de conflictes i a la llista.

Enllaç a aquest capítol →

Eines: cerca global, citacions, anàlisi d’articles

Fora de les revisions, el menú Eines reuneix utilitats per a qualsevol investigador: cercar a diverses bases de dades, normalitzar bibliografies, verificar citacions i treballar amb un article sol.

Verificar citacions abans d’enviar

La verificació de citacions és especialment útil amb bibliografies generades amb eines d’IA: detecta referències inexistents, DOI que apunten a un altre article i anys o autors que no quadren. Enganxa la bibliografia, executa i revisa les files en vermell.

Anàlisi d’articles i equips

Cada article analitzat es pot compartir amb altres usuaris. L’informe crític es pot exportar a Word. Les converses queden guardades amb l’article.

Enllaç a aquest capítol →

Anàlisi d’articles

Una eina pròpia de SysRevAI, fora de les revisions: puja un article o el teu manuscrit i la IA en fa un informe crític, hi conversa amb cites al text i t’ajuda a millorar-ne la redacció.

És a Eines → Articles. Cada article és un projecte independent, amb el seu document, la conversa amb la IA, l’informe crític, els documents relacionats i el seu equip. Cal tenir la IA activada (Admin → Claude).

Crear un projecte

1. Eines → Articles → Pujar un article.
2. Posa-li un títol i puja el document en PDF o Word (.docx, .doc), fins a 50 MB. La plataforma n’extreu el text.
3. Si vols, afegeix-hi articles o guies relacionats (per exemple, la guia CONSORT o un estudi de referència): la IA els llegirà al costat del principal.

Informe crític

Prem Elaborar informe crític i tria l’idioma (català, castellà, anglès o francès). La IA llegeix l’article com un revisor exigent i en retorna:

• una puntuació de 0 a 100 en cinc eixos: metodologia, claredat, novetat, evidència i tractament de les limitacions;
• un resum executiu;
• l’advocat del diable: les objeccions més fortes que hi faria un revisor;
• recomanacions concretes per a cada secció.

L’informe es pot tornar a generar i s’exporta a Word, sol o amb la transcripció de la conversa.

Conversa amb cites

Al xat, pregunta el que vulguis sobre l’article («quina és la mida de la mostra?», «quines limitacions reconeixen els autors?»). Les respostes citen el text de l’article i dels documents relacionats, perquè les puguis comprovar. La conversa es desa amb el projecte.

Suport a la redacció del teu manuscrit

1. Obre Edició col·laborativa: el document s’obre en un editor amb format, taules i imatges.
2. Selecciona un fragment (o res, per treballar tot el document) i demana al Copilot el que necessitis: «reescriu-ho en un to més formal», «aclareix aquesta frase», «afegeix una taula amb els resultats».
3. El Copilot proposa el canvi i tu l’acceptes o el rebutges.
4. Desa versions amb nom per tornar-hi quan vulguis, i descarrega el document en Word.

Treballar en equip

Des d’Equip convida coautors pel correu: si ja tenen compte, s’hi afegeixen; si no, reben un enllaç d’invitació vàlid 7 dies. Tots veuen el document, l’informe i la conversa.

Enllaç a aquest capítol →

La IA: què fa, què costa i com controlar-la

SysRevAI fa servir models de llenguatge de Claude (Anthropic) amb la teva pròpia clau. La IA ajuda; no decideix. Aquí tens què fa a cada fase, com s’activa i com es controla el cost.

Activar-la

1. Crea una clau d’API a la consola d’Anthropic.
2. Admin → Claude (IA): enganxa la clau (es desa xifrada), tria el model per defecte i un límit de despesa mensual.
3. Activa o desactiva cada funció: cribratge, extracció, resums, xat, protocol, citacions, Copilot.
4. Dins de cada revisió, el coordinador pot desactivar la IA del tot.

Què fa a cada fase

Costos i límits

Cada crida es registra amb el model, els tokens i el cost estimat en euros. A la revisió, la pestanya Ús d’IA ho desglossa per funció i persona; a Admin → Claude (IA) fixes el límit mensual global, i quan s’hi arriba les funcions s’aturen sense afectar la resta de la plataforma.

La declaració d’ús d’IA

Cada revisió genera automàticament una declaració d’ús d’IA: en quines fases s’ha fet servir, amb quins models i amb quin volum. S’exporta en Word per incloure-la als mètodes de l’article, tal com demanen cada cop més revistes.

Enllaç a aquest capítol →

Revisions vives i API

Una revisió viva es manté al dia: les cerques desades es repeteixen soles i avisen de les referències noves. L’API permet llegir les dades des d’altres eines.

Cerques desades

1. Fes una cerca externa des de la revisió (Cercar → Bases de dades).
2. Prem Desar la cerca: es guarden la consulta, els filtres i les bases de dades.
3. A Revisió → Cerques desades, activa la repetició automàtica (setmanal o mensual).
4. El worker la torna a executar; les referències noves entren marcades com a «noves des de l’última cerca» i reps una notificació.

API de lectura

A Perfil → API pots crear un testimoni personal. Amb aquest testimoni, altres programes poden llegir les teves revisions, referències i el PRISMA en JSON.

curl -H "Authorization: Bearer EL_TEU_TESTIMONI" https://la-teva-instal·lacio/api/v1/reviews

Enllaç a aquest capítol →

Actualitzacions, còpies i manteniment

Tot el manteniment es fa des del panell: actualitzar a la versió nova, fer i descarregar còpies, posar el lloc en manteniment i vigilar el worker.

Actualitzar

1. La plataforma comprova sola cada 6 hores si hi ha una versió nova a sysrevai.com. Quan n’hi ha, els administradors veuen una barra fosca a dalt de totes les pàgines («Hi ha una nova versió de SysRevAI disponible») amb el botó Actualitzar ara. La barra no es pot tancar i desapareix sola un cop actualitzat.
2. El botó obre Admin → Manteniment amb la comprovació ja feta: la versió disponible, les novetats i les comprovacions prèvies. També hi pots anar a mà i prémer «Buscar actualitzacions».
3. Si totes les comprovacions passen, prem «Actualitzar ara».
4. La plataforma activa el mode manteniment, fa una còpia de la base de dades, descarrega el paquet amb la teva llicència, en verifica la integritat, substitueix el codi (conservant .env, storage/ i public/uploads/), aplica les migracions i torna a obrir el lloc.
5. Si una migració falla, el codi anterior es restaura i la còpia queda a mà. El registre de cada actualització es guarda amb el seu log.

Còpies de seguretat

Admin → Manteniment → Còpies completes: el worker fa automàticament, cada 2 hores, una còpia de tota la plataforma (base de dades, PDF, protocols, articles, credencials, avatars i .env) i en conserva les 24 més recents; les més antigues s’esborren soles. Pots canviar la freqüència i quantes se’n guarden, fer-ne una a mà i descarregar-les. Per restaurar-ne una, des del servidor: php bin/console.php backup:restore storage/backups/<fitxer>.zip --yes (amb --with-env recupera també el .env). Descarrega de tant en tant una còpia fora del servidor.

Mode manteniment

Mostra una pàgina d’avís a tothom excepte als administradors. Útil durant migracions o canvis de servidor.

Worker i treballs

Admin → Manteniment → Tasques programades (cron) diu si el worker funciona i quan s’ha executat per última vegada; si no funciona, hi tens la línia de cron exacta per a aquest servidor i els passos per configurar-la. Admin → Treballs en segon pla mostra la cua de tasques (valoracions massives amb IA, cerques programades, compilacions).

On és cada cosa

Exportar i importar dades (portabilitat)

Cada usuari pot descarregar tot el que ha creat des de Perfil → Les meves dades: un fitxer ZIP amb les seves revisions (protocol, referències, decisions, conflictes, extracció, risc de biaix, GRADE, etiquetes, comentaris i registre d’ús d’IA), els PDF i els articles. El mateix fitxer s’importa a qualsevol altra instal·lació des de la mateixa pantalla.

• Les revisions importades passen a ser de qui importa; els col·laboradors s’enllacen pel correu i, si no tenen compte, es creen desactivats (no ocupen plaça fins que l’administrador els activa).
• La importació és tot o res: si alguna cosa falla, no es desa res.
• Per importar fitxers grans, augmenta upload_max_filesize i post_max_size al PHP del servidor.

Enllaç a aquest capítol →

Suport

Tots els comptes de prova i totes les instal·lacions, Community i Institucional, tenen un sistema de suport integrat: es demana ajuda a l’equip de SysRevAI amb tiquets, des de la mateixa plataforma.

Qui hi té accés

La resta d’usuaris (revisors, membres convidats) veuen a Suport qui administra la seva plataforma, per adreçar-s’hi directament.

Obrir un tiquet

1. Prem la pastilla Suport, a la barra superior, al costat de «Guia d’ús».
2. Prem Nou tiquet. Escriu l’assumpte, tria el tipus (problema tècnic, llicència i instal·lació, suggeriment o altres) i la prioritat, i descriu què passa, què esperaves i com reproduir-ho.
3. Si cal, adjunta fitxers: fins a 5 per missatge (captures de pantalla, PDF, documents d’Office o LibreOffice, text, registres, CSV, RIS, BibTeX o ZIP), de 5 MB cadascun i 10 MB en total.
4. Envia’l. Rebràs un correu quan l’equip de SysRevAI respongui.

Informació del sistema

Cada tiquet porta automàticament la informació tècnica de la instal·lació: versió i edició, PHP i base de dades, extensions que falten, límits del servidor, nombre d’usuaris i revisions, estat dels treballs cron i si el correu i la IA estan configurats. Així l’equip de suport veu l’entorn sense haver de preguntar-lo. No inclou contrasenyes, claus ni dades personals. A la pantalla de nou tiquet surt plegada: obre-la amb la fletxa del quadre «Informació del sistema» si la vols revisar.

Seguir el tiquet

• Les respostes de SysRevAI apareixen a la conversa del tiquet, amb els fitxers que s’hi adjuntin.
• La pastilla Suport mostra en vermell quants tiquets tenen una resposta que encara no has obert; a la llista, porten l’etiqueta «Resposta nova».
• Pots respondre, també amb fitxers, tantes vegades com calgui. Si el tiquet estava resolt o tancat, respondre’l el torna a obrir.
• Quan ja no el necessitis, prem Tancar el tiquet.

Edició Institucional: instal·lació als vostres servidors

L’edició Institucional inclou suport per instal·lar SysRevAI als servidors de l’entitat, coordinat amb el vostre servei d’informàtica. Per demanar-lo, escriu-nos des de Contacte.

Enllaç a aquest capítol →

L’app mòbil

SysRevAI té app per a iPhone, iPad i Android, al mòbil i a la tauleta. Cribra referències, llegeix el text complet, resol conflictes, comenta amb l’equip i fes servir les eines, també sense connexió.

Una sola app serveix per a tots els SysRevAI: els comptes de prova de sysrevai.com i la instal·lació pròpia de qualsevol institució. Hi entres amb el mateix usuari que al web, hi veus les mateixes revisions i les teves decisions van a parar al mateix servidor. El que es fa millor en una pantalla gran (l’administració de la plataforma) continua al web, i l’app t’hi porta quan cal.

Instal·lar-la

1. A l’iPhone o l’iPad, cerca «SysRevAI» a l’App Store.
2. En un mòbil o una tauleta Android, cerca-la a Google Play.

Connectar-la amb el teu servidor

Què hi pots fer

• Inici: el que tens pendent a cada revisió i el botó «Continuar cribrant».
• Cribratge per títol i resum i per text complet, amb els termes del protocol ressaltats, els motius d’exclusió, notes i la proposta de la IA si el servidor en té.
• Llista d’articles: el botó de la part superior del cribratge mostra els articles pendents i els que ja has cribrat. Toca’n un per cribrar-lo, o per canviar la teva decisió.
• Text complet: el PDF amb els termes ressaltats, la cerca (amb la lupa, que diu quants resultats hi ha) i el zoom, i els criteris del protocol al costat. Si la IA ha avaluat l’article, cada criteri apareix com a complert, no complert o dubtós.
• Referències: la llista de la revisió amb filtres (estat, text, etiqueta, font) i accions sobre les marcades: cribrar-les per títol i resum, etiquetar-les o esborrar-les (només la persona propietària). També importar un fitxer del telèfon (Fitxers, iCloud, Drive, un adjunt) o text enganxat, amb previsualització; cercar referències noves amb els filtres del protocol i desar la cerca; les cerques desades; i els duplicats.
• Fitxa de cada referència (des de la llista o des del cribratge): el text complet (obrir el PDF, pujar-ne un des del telèfon, substituir-lo, esborrar-lo o cercar-lo ara a les fonts obertes), les marques de cada fase, i el resum, la revisió per parells i el xat de la IA. A Text complet de la revisió, la cobertura i la cua de cerca en segon pla. Als conflictes, la proposta de resolució de la IA.
• Gestió de la revisió: crear-ne una de nova (la IA pot omplir el formulari a partir del document del protocol, en PDF o Word), editar el protocol, l’equip (convidar per correu, rols, cec, qui resol conflictes), la configuració (arxivar, l’enllaç públic de consulta, esborrar una revisió arxivada) i la coordinació de cada fase: iniciar-la, repartir la feina i fer que la IA valori la cua i n’accepti els veredictes més segurs. Cadascú hi veu el que el seu rol li permet, com al web.
• Estudis inclosos, pensat sobretot per a la tauleta, amb el PDF o el resum de l’estudi al costat del formulari: l’extracció de dades (la IA pot emplenar-te l’esborrany; la persona propietària edita la plantilla i aprova les extraccions), el risc de biaix (RoB 2, ROBINS-I, Newcastle-Ottawa o JBI, amb el diagrama semàfor, el gràfic resum i la proposta de la IA per domini) i GRADE amb la taula de resum de troballes. Al telèfon, un selector a dalt passa del formulari a l’estudi.
• Resultats i difusió: el diagrama PRISMA (i l’editor per fixar-ne cel·les a mà), tots els fitxers de la pestanya Exportar del web (es descarreguen al telèfon i s’obre el menú de compartir), el formulari de registre PROSPERO/OSF amb l’esborrany de la IA, i la declaració d’ús de la IA. Els comentaris es poden esborrar (els propis, o qualsevol si ets la persona propietària).
• Conflictes, per a qui els resol.
• Comentaris a cada referència i al tauler de la revisió. En escriure @ et suggereix l’equip, i la persona mencionada rep un avís.
• Avisos de la plataforma i notificacions push.
• Eines: les mateixes del web (més avall).
• Suport, per als administradors: consultes a l’equip de SysRevAI amb captures de pantalla.

Treballar sense connexió

• L’app desa al telèfon una tanda de referències de la teva cua. Abans d’un viatge, toca «Descarregar 200 referències per treballar sense connexió».
• Cada decisió es desa al moment i s’envia quan hi ha connexió; a dalt veus quantes en queden per enviar. Mentre no s’hagi enviat, pots desfer l’última.
• Si un altre revisor ha completat la referència mentre eres sense connexió, l’app t’avisa que la teva decisió no ha comptat: el servidor sempre mana.
• Al text complet, els PDF de la tanda (els 20 primers) es descarreguen amb ella i també es llegeixen sense connexió. Els que ja són al telèfon porten la marca «Desat per llegir sense connexió».
• Els comentaris, la proposta de la IA i les eines necessiten connexió. A Perfil → Dades sense connexió veus quant ocupa tot plegat i ho pots buidar.

A la tauleta

• A l’iPad i a les tauletes Android, la navegació passa a una barra lateral.
• El cribratge es veu a dues columnes: la tanda a un costat i la referència a l’altre.
• Al text complet, el PDF queda a un costat i els criteris, la proposta de la IA, les notes i la decisió a l’altre.
• Amb un teclat connectat: I inclou, M marca com a dubtosa i E exclou (com al web) (després, 1-9 tria el motiu i 0, cap).
• Les eines mostren la llista i el detall alhora. Amb l’app a mitja pantalla (Split View o les finestres d’Android) torna a la disposició del mòbil sense perdre el que feies.

Notificacions

L’app t’avisa quan et conviden a una revisió, t’assignen referències, hi ha un conflicte, et mencionen o et retornen feina. Al web, la columna «App mòbil» de Perfil → Notificacions decideix quines reps. L’avís només porta una frase genèrica («Tens un conflicte nou per resoldre»); quan el toques, l’app demana el detall directament al teu servidor. Les instal·lacions pròpies envien els avisos a través de sysrevai.com amb la seva llicència, però sense títols, noms ni decisions.

Eines

• Verificar cites a CrossRef, OpenAlex i Europe PMC (fins a 15 cada vegada): enganxades, d’una revisió o escanejant una bibliografia impresa amb la càmera. El text es reconeix al mateix mòbil i el revises abans de verificar.
• Normalitzar cites a qualsevol dels 8 estils, per copiar-les, compartir-les o afegir-les a una revisió.
• Les darreres verificacions i normalitzacions queden a Recents, per tornar-les a obrir.
• Cercar referències a les bases externes, a les teves referències o amb una pregunta clínica, i afegir les que triïs a una revisió; els duplicats es detecten.
• Anàlisi d’articles: puja un PDF o un Word, genera l’informe crític, pregunta a la IA sobre l’article o millora un paràgraf del teu manuscrit. Normalitzar, l’informe i el xat necessiten que el servidor tingui la IA configurada (capítol 14).

Idioma, seguretat i actualitzacions

• Idioma: l’app fa servir el del telèfon, i es canvia a Perfil → Idioma. Té tots els idiomes de la plataforma, i un de nou hi apareix sense actualitzar l’app.
• Dispositius: cada telèfon té la seva pròpia sessió. Al web, Perfil → App mòbil llista els teus dispositius connectats i et deixa tancar la sessió d’un que hagis perdut.
• Mode cec: s’aplica igual que al web. Si la revisió és cega, l’app no rep les decisions de la resta de l’equip.
• Actualitzacions: l’app s’actualitza sola en segon pla i aplica la versió nova en tornar-la a obrir; al perfil hi apareix un avís per reiniciar-la al moment.
• Tancar la sessió esborra del telèfon les tandes i els PDF desats. Les decisions que encara no s’hagin enviat es perden, així que fes-ho amb connexió.

Dubtes freqüents

Enllaç a aquest capítol →

Preguntes freqüents

Les respostes curtes a les preguntes que ens arriben més sovint. Si la teva no hi és, escriu-nos.

Enllaç a aquest capítol →

Bones pràctiques

Recomanacions metodològiques i d’organització que hem vist que fan les revisions més ràpides i més defensables.

Abans de començar

• Tanca el protocol i registra’l (PROSPERO, OSF) abans d’importar referències. Canviar criteris a mig cribratge obliga a tornar enrere.
• Fes un pilot amb 50 referències i tot l’equip. Compareu decisions, ajusteu criteris i després obriu la fase de debò.
• Definiu els motius d’exclusió amb l’equip: pocs, excloents i ordenats de més a menys restrictiu.

Durant el cribratge

• Sessions curtes i regulars (30–45 minuts) mantenen la consistència millor que maratons.
• Reviseu els conflictes cada setmana: resoldre’ls aviat recalibra l’equip.
• Mireu el kappa. Per sota de 0,6, atureu-vos i aclariu criteris.
• Feu servir «Potser» amb criteri: és una reserva, no una manera d’ajornar la decisió.

Amb la IA

• Comenceu per la priorització; el cribratge automàtic només per a referències amb puntuació molt baixa i sempre amb mostreig de comprovació.
• Verifiqueu sempre la pre-extracció contra el fragment citat.
• Incloeu la declaració d’ús d’IA als mètodes de l’article.

Seguretat i dades

• Verificació en dos passos per a tothom amb rol d’administrador.
• Comproveu a Admin → Manteniment que el cron diu «Funciona»: sense ell no hi ha còpies automàtiques. Descarregueu de tant en tant una còpia completa fora del servidor.
• Actualitzeu quan surti una versió nova: les actualitzacions fan còpia i reverteixen si cal.
• No pugeu PDF a la plataforma que no pugueu compartir amb l’equip segons la vostra llicència.

Enllaç a aquest capítol →