Přejít na hlavní obsah

OMI OJS Integrační plugin

Plugin pro integraciOMI a OJS propojuje Open Journal Systems (OJS) verze 3.5.x s platformou Open Manuscript Studio prostřednictvím integrace OMI API. OJS zůstává hlavním systémem pro řízení pracovního toku časopisu, identifikaci autorů, přidělování recenzí a chráněné soubory; Studio přímo nečte databázi OJS ani úložiště soukromých souborů.

Aktuální verze​

Stabilní verze: v1.6.0
Cílová platforma: OJS 3.5.x
Licence: GNU GPL v3.0

Stáhnout​

Archiv vydání obsahuje plugin v kořenovém adresáři balíčku studioIntegration/, jak to vyžadují postupy instalace pluginů PKP.

Hlavní funkce​

Tento konektor umožňuje spouštění aplikace Studio s ohledem na role a poskytuje podepsaný přístup k integraci pro pracovní postupy autorů, editorů a recenzentů v rámci platformyOJS. Mezi implementované oblasti integrace patří:

  • podepsaná, krátkodobá tvrzení o spuštění;
  • výslovné režimy pro autory, redaktory a recenzenty;
  • rozsahy rolí s minimálními oprávněními;
  • OJS metadata k odeslaným příspěvkům a převod přispěvatelů;
  • vyhledávání kandidátů na recenzenty pro redaktory;
  • chráněný výpis odeslaných souborů a přenos binárních dat;
  • oprávnění k souboru recenzenta vázané na konkrétní úkol v rámci recenzního řízení OJS;
  • nativní OJS čtení z formuláře a zápis odpovědi;
  • komentáře k recenzi viditelné pro autora a pouze pro redaktora;
  • omezení přístupu recenzentů v rámci dvojitě slepého hodnocení;
  • zápis s HMAC podpisem mezi servery;
  • konzistentní metadata o žánru souboru pro výběr zdrojového souboru;
  • nativní OJS 3.5 komplexní ověření přístupu anonymních recenzentů, povinné recenzní formuláře, opravy rukopisu, oddělená zpětná vazba a podepsané recenzní posudky.

Prohlášení při spuštění recenzenta záměrně nemají rozsah platnosti pro přispěvatele ani recenzenta. Soubory recenzenta podléhají omezením daným přiřazením recenze v systému PKP, nikoli obecným oprávněním k souborům na úrovni příspěvku.

Instalace​

Archiv nainstalujte pomocí rozhraní pro nahrávání pluginů na stránce OJS (je-li to podporováno), nebo jej rozbalte následujícím způsobem:

plugins/generic/studioIntegration/

Po aktivaci pluginu nakonfigurujte URL Studia, identifikátor instalace, sdílený integrační klíč a dobu platnosti spouštěcího tokenu. V produkčním prostředí by se mělo používat HTTPS.

Databáze služby „OJS“ a aplikace Studio zůstávají oddělené. Neposkytujte aplikaci Studio přímý přístup k databázi služby „OJS“ ani soukromý přístup k souborovému systému.

Architektura a API​

Konektor využívá integrační profil „OMI“:

omi-integration/1/ojs

Podrobnější dokumentace k sadě nástrojů „API“ a k profilům je k dispozici zde:

Bezpečnostní model​

Operace citlivé z hlediska bezpečnosti se provádějí prostřednictvím OJS/PKP na úrovni aplikací APIa služeb úložišť. Konektor využívá krátkodobá podepsaná tvrzení pro interaktivní spouštěcí toky a požadavky na služby podepsané algoritmem HMAC-SHA256 pro chráněné zpětné zápisy.

Návrh se řídí těmito hranicemi:

  • OJS nadále představuje autoritativní zdroj pro pracovní postupy a přidělování úkolů k posouzení;
  • Studio přijímá pouze data s výslovně vymezeným rozsahem;
  • přístup recenzenta je vázán na konkrétní úkol;
  • soukromé soubory se přenášejí až po autorizaci ze strany OJS;
  • tajemství zůstávají na straně serveru;
  • Zápis revize se ověřuje podle aktuálního přiřazení typu „OJS“ a definice formuláře.

Zveřejnění informací o vývoji podporovaném umělou inteligencí​

Při vývoji tohoto pluginu byla v oblasti architektury, implementace, analýzy PKP API, bezpečnostního posouzení, CI/CD, testování a dokumentace využita významná podpora generativní umělé inteligence. Projekt zachovává výslovnou lidskou odpovědnost za odevzdaný kód a ověřuje chování závislé na PKP na základě aktuálního zdrojového kódu PKP/OJS a výsledků testů.

Repozitář obsahuje výslovné prohlášení o podílu umělé inteligence pro účely recenze prováděné PKP:

Zdrojová a projektová dokumentace​

Stav PKP​

Tento plugin je navržen v souladu se specifikacemi PKP/OJSu 3.5 APIa v současné době se připravuje k posouzení ze strany PKP. Zveřejnění na webu OMI a dostupnost jako instalovatelná verze neznamenají, že byl plugin již přijat do oficiální galerie pluginů PKP. Oficiální zařazení do galerie podléhá posouzení správcem PKP a ověření kompatibility.