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
Изтегли
- Download OMP plugin v1.5.1 — ZIP
- Download OMP plugin v1.5.1 — TAR.GZ
- SHA-256 checksums
- Latest GitHub release
Архивът на версията използва 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
Свързана документация:
- Integration Architecture
- OMI Integration API v1
- OMP Integration Profile v1
- Integration Implementation Status
- Studio Deployment Modes
Модел за сигурност
Реализацията следва границите на хранилището и работния поток на PKP, вместо да заобикаля вътрешните механизми на OMP. Важните контролни механизми включват:
- краткотрайни твърдения за стартиране на HMAC-SHA256;
- подвързване и пресово скрепване;
- права с обхват до роля;
- проверка на възлагането на рецензенти;
- валидиране на текущия етап на преглед и кръг на преглед за качени ревизии;
- PKP
ReviewFilesDAOразрешение за достъп до изходните файлове, видими за рецензентите; - семантика на съхранение и валидиране, характерна за
Repo::submissionFile(); - проверка на жанра на файла спрямо актуалните публикации;
- завършените задачи за преглед се третират като само за четене;
- няма директен достъп между базите данни.
Документация за съвместимост и съответствие с PKP
Хранилището на плъгини документира произхода на „API“ и оставащата граница между техническата съвместимост и официалното одобрение от PKP:
Включването в официалната галерия с плъгини все още изисква преглед от страна на поддържащия екип на PKP и тестване на ниво инсталация върху поддържана, немодифицирана версия на OMP.
Разкриване на информация за разработки, подпомагани от изкуствен интелект
Разработката на плъгина е получила значителна подкрепа от генеративната изкуствена интелигенция в областта на архитектурата, имплементацията, анализа на PKP API, прегледа на сигурността, CI/CD, тестването и документацията. Човешките поддържащи лица продължават да носят отговорност за кода, подаден или пуснат за ползване от потребителите, а поведението, зависещо от PKP, се сверява с действителния източник на OMP/PKP и резултатите от тестовете.
Източник и проектна документация
- Source repository
- README
- Installation guide
- PKP compatibility
- Security
- Changelog
- License
- All releases
Статус на PKP
Плъгинът е разработен в съответствие с актуалния работен процес на OMP/PKP 3.5 и хранилището API, но самото му наличие на този уебсайт не означава, че е получил официално одобрение от PKP Plugin Gallery. Проектът прави ясно разграничение между съвместимост на имплементацията, тествана оперативна съвместимост и официално одобрение от PKP.