Преминете към основното съдържание

OMI OMP Плъгин за интеграция

Плъгинът за интеграция „OMI“ OMP свързва Open Monograph Press (OMP) 3.5.x с Open Manuscript Studio чрез интеграцията „OMI“ API. OMP остава основната платформа за работния процес на издателството, подаването на монографии, рецензионните цикли, възлагането на рецензии и съхранението на файлове в частен режим; Studio комуникира единствено чрез подписани крайни точки за интеграция на ниво приложение.

Текуща версия​

Стабилна версия: v1.5.1
Целева платформа: OMP 3.5.x
Лиценз: GNU GPL v3.0

Изтегли​

Архивът на версията използва studioIntegration/ като корен на пакетите за инсталация, съвместима с PKP.

Основни възможности​

Коннекторът „OMP“ поддържа монографии и запазва семантиката на работния процес, специфична за „OMP“, вместо да третира „OMP“ като „OJS“ с различни етикети. Настоящите области на интеграция включват:

  • подписано пускане в Open Manuscript Studio;
  • ясно определени режими за редактор, автор и рецензент;
  • обхвати на роли с минимални права;
  • съпоставяне на идентичността в пресата и монографиите;
  • метаданни, базирани на репозиторията „OMP“ 3.5, и прочетени данни от съавтори;
  • защитен списък с файлове за изпращане и пренос на двоични данни;
  • архитектура, съобразена с компонентите, за глави и други части от книгата;
  • достъпът на рецензента до файловете е обвързан с конкретната задача за рецензиране на PKP;
  • устойчивост при четене на формуляри за преглед и отговаряне в родния език на PKP;
  • качване на прикачени файлове от рецензенти в рамките на заданието;
  • преглед на качването на редакцията на автора в рамките на кръга;
  • етапи на преразглеждане „internal-review“ и „external-review“;
  • откриване на вградени възможности за поведение при преглед, специфично за „OMP“;
  • подписан коментар към рецензията/отговор на формуляра;
  • прогнозата на рецензента се ограничава до едното възложено проучване, като се изключват данните от родителската монография, проучванията на братя и сестри, както и данните за самоличността на сътрудниците;
  • Вградена функция „OMP“ 3.5 – цялостна проверка на стартирането, файловете, формулярите за преглед, корекциите, отделната обратна връзка и подписаното потвърждение.

OMP В версия 3.5 се съобщава, че персонализираните препоръки за рецензенти не се поддържат от приложението-домакин. Поради това конекторът не генерира идентификатори на препоръки от типа „OJS“ и не кодира изкуствени стойности на препоръките в коментарите.

Инсталиране​

Инсталирайте архива чрез интерфейса за управление на плъгините на OMP, ако това се поддържа, или го разархивирайте по следния начин:

plugins/generic/studioIntegration/

След като активирате плъгина, конфигурирайте го:

  • URL на студиото — основният URL адрес на Open Manuscript Studio;
  • Идентификатор на инсталацията — стабилен идентификатор за инсталацията на „OMP“;
  • Споделен секретен ключ — секретният ключ за интеграция от страна на сървъра, споделен със Studio;
  • Срок на валидност на токена — кратък срок на валидност на твърдението за стартиране.

В производствената среда трябва да се използва HTTPS. Studio не трябва да получава директни данни за достъп до базата данни, нито частен достъп до файловата система на OMP.

OMP-специфичен модел на работния процес​

Коннекторът запазва концепциите на „OMP“, включително:

  • преси;
  • монографии и сборници;
  • глави и елементи на публикацията;
  • съавтори на ниво книга и на ниво компонент;
  • роли на автор, редактор, преводач и автор на глави;
  • етапи на вътрешен и външен преглед;
  • конкретни цикли на преглед и задачи за преглед;
  • проследими редакции на автора и прикачени файлове от рецензентите.

Автоматичното попълване от рецензента продължава да има решаващо значение в стандартния работен процес на „OMP“, тъй като то задейства допълнителни функции на PKP, като например известия, регистриране и финализиране на статуса на поканата.

Архитектура и „API“​

Коннекторът използва профила за интеграция „OMI“:

omi-integration/1/omp

Свързана документация:

Модел за сигурност​

Реализацията следва границите на хранилището и работния поток на PKP, вместо да заобикаля вътрешните механизми на OMP. Важните контролни механизми включват:

  • краткотрайни твърдения за стартиране на HMAC-SHA256;
  • подвързване и пресово скрепване;
  • права с обхват до роля;
  • проверка на възлагането на рецензенти;
  • валидиране на текущия етап на преглед и кръг на преглед за качени ревизии;
  • PKP ReviewFilesDAO разрешение за достъп до изходните файлове, видими за рецензентите;
  • семантика на съхранение и валидиране, характерна за Repo::submissionFile();
  • проверка на жанра на файла спрямо актуалните публикации;
  • завършените задачи за преглед се третират като само за четене;
  • няма директен достъп между базите данни.

Документация за съвместимост и съответствие с PKP​

Хранилището на плъгини документира произхода на „API“ и оставащата граница между техническата съвместимост и официалното одобрение от PKP:

Включването в официалната галерия с плъгини все още изисква преглед от страна на поддържащия екип на PKP и тестване на ниво инсталация върху поддържана, немодифицирана версия на OMP.

Разкриване на информация за разработки, подпомагани от изкуствен интелект​

Разработката на плъгина е получила значителна подкрепа от генеративната изкуствена интелигенция в областта на архитектурата, имплементацията, анализа на PKP API, прегледа на сигурността, CI/CD, тестването и документацията. Човешките поддържащи лица продължават да носят отговорност за кода, подаден или пуснат за ползване от потребителите, а поведението, зависещо от PKP, се сверява с действителния източник на OMP/PKP и резултатите от тестовете.

Източник и проектна документация​

Статус на PKP​

Плъгинът е разработен в съответствие с актуалния работен процес на OMP/PKP 3.5 и хранилището API, но самото му наличие на този уебсайт не означава, че е получил официално одобрение от PKP Plugin Gallery. Проектът прави ясно разграничение между съвместимост на имплементацията, тествана оперативна съвместимост и официално одобрение от PKP.