Přejít na hlavní obsah

OMI OMP Integrační plugin

Plugin pro integraciOMI s OMP propojuje Open Monograph Press (OMP) verze 3.5.x s Open Manuscript Studio prostřednictvím integrace OMI API. OMP zůstává hlavním systémem pro pracovní postupy nakladatelství, zasílání monografií, kola recenzí, přidělování recenzí a ukládání soukromých souborů; Studio komunikuje výhradně prostřednictvím podepsaných integračních koncových bodů na úrovni aplikace.

Aktuální verze​

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

Stáhnout​

Archiv vydání používá adresář studioIntegration/ jako kořenový adresář balíčků pro instalaci kompatibilní s PKP.

Hlavní funkce​

Konektor OMP podporuje monografie a zachovává sémantiku pracovního postupu specifickou pro OMP, místo aby považoval OMP za OJS s odlišnými štítky. Mezi současné oblasti integrace patří:

  • podepsané uvedení na Open Manuscript Studio;
  • výslovné režimy pro editora, autora a recenzenta;
  • rozsahy rolí s minimálními oprávněními;
  • mapování identit v tisku a monografiích;
  • nativní OMP 3.5 metadata založená na repozitáři a počet zobrazení přispěvatelů;
  • chráněný výpis odeslaných souborů a přenos binárních dat;
  • architektura zohledňující jednotlivé komponenty pro kapitoly a další části knihy;
  • přístup recenzenta k souboru je vázán na konkrétní recenzní úkol PKP;
  • vlastní vyhodnocování formulářů PKP a vytrvalost v reakcích;
  • nahrávání příloh recenzentů v rámci konkrétního úkolu;
  • nahrání revize autora s rozsahem na celou revizi;
  • fáze revize „internal-review“ a „external-review“;
  • detekce nativních funkcí pro chování kontroly specifické pro OMP;
  • podepsaná připomínka k přezkumu / zpětná vazba k formuláři;
  • projekce hodnotitele omezená na jedinou přidělenou studii, s vyloučením údajů o rodičovské monografii, sourozenecké studii a totožnosti přispěvatele;
  • Nativní OMP 3.5 – komplexní ověření spouštění, souborů, kontrolních formulářů, oprav, oddělené zpětné vazby a podepsaného zápisu.

OMP Verze 3.5 v současné době uvádí, že hostitelská aplikace nepodporuje přizpůsobitelná doporučení recenzentů. Konektor proto nevytváří identifikátory doporučení ve stylu OJSa do komentářů nezapisuje syntetické hodnoty doporučení.

Instalace​

Archiv nainstalujte prostřednictvím rozhraní pro správu pluginů na adrese OMP (pokud je to podporováno), nebo jej rozbalte následujícím způsobem:

plugins/generic/studioIntegration/

Po aktivaci pluginu proveďte následující nastavení:

  • URL studia — základní adresa URL Open Manuscript Studio;
  • ID instalace — stabilní identifikátor instalace systému OMP;
  • Sdílený tajný klíč — integrační tajný klíč na straně serveru sdílený se Studiem;
  • Životnost tokenu — krátká životnost při ověření spuštění.

V produkčním prostředí by se měl používat protokol HTTPS. Aplikace Studio nesmí dostávat přímé přihlašovací údaje k databázi ani mít soukromý přístup k souborovému systému OMP.

OMP-specifický model pracovního postupu​

Tento konektor zachovává koncepty jazykaOMP, včetně:

  • lisy;
  • monografie a sborníky;
  • kapitoly a součásti publikace;
  • přispěvatelé na úrovni knih a na úrovni komponent;
  • role autora, redaktora, překladatele a autora kapitol;
  • fáze interního a externího přezkumu;
  • konkrétní kola hodnocení a úkoly v rámci hodnocení;
  • sledovatelné úpravy autora a přílohy recenzentů.

Dokončení recenzenta má i nadále rozhodující význam v nativním pracovním postupu OMP, protože toto dokončení spouští další funkce PKP, jako jsou oznámení, protokolování a finalizace stavu pozvánky.

Architektura a API​

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

omi-integration/1/omp

Související dokumentace:

Bezpečnostní model​

Implementace respektuje hranice repozitáře a pracovních postupů PKP, místo aby obcházela vnitřní strukturu OMP. Mezi důležité kontrolní mechanismy patří:

  • krátkodobá tvrzení o spuštění HMAC-SHA256;
  • vázání a knihařské vázání;
  • oprávnění vázaná na roli;
  • ověření přiřazení recenzenta;
  • ověřování aktuální fáze a kola posuzování u nahraných revizí;
  • Oprávnění PKP ReviewFilesDAO pro zdrojové soubory viditelné pro recenzenty;
  • nativní sémantika ukládání a ověřování v jazyceRepo::submissionFile();
  • ověření žánru souboru na základě aktuálních tiskových zpráv;
  • dokončené revizní úkoly se považují za pouze pro čtení;
  • žádný přímý přístup mezi databázemi.

Dokumentace o kompatibilitě a shodě s normami PKP​

Repozitář pluginů dokumentuje původ API a přetrvávající hranici mezi technickou kompatibilitou a oficiálním přijetím ze strany PKP:

Zařazení do oficiální galerie pluginů stále vyžaduje posouzení správcem PKP a testování na úrovni instalace na podporované, neupravené verzi OMP.

Zveřejnění informací o vývoji s využitím umělé inteligence​

Při vývoji tohoto pluginu byla ve značné míře využita generativní umělá inteligence v oblastech architektury, implementace, analýzy PKP API, bezpečnostního posouzení, CI/CD, testování a dokumentace. Za kód odeslaný nebo vydaný uživatelům nadále nesou odpovědnost lidští správci a chování závislé na PKP se ověřuje na základě aktuálního zdrojového kódu OMP/PKP a výsledků testů.

Zdrojová a projektová dokumentace​

Stav PKP​

Tento plugin byl vyvinut v souladu se současnými postupy OMPa standardy PKP 3.5 pro repozitáře API, avšak jeho dostupnost na této webové stránce sama o sobě neznamená oficiální schválení v rámci PKP Plugin Gallery. Projekt výslovně rozlišuje mezi kompatibilitou implementace, otestovanou interoperabilitou a formálním schválením ze strany PKP.