Статус на внедряването на интеграцията
Дата на актуализация: 05.09.2026 г.
Обхват: Референтна реализация на Open Manuscript Studio
Правова основа: Информативен доклад за прилагането; спецификациите за интегриране запазват нормативния си характер, където това е приложимо.
На тази страница се прави разграничение между реализираното поведение на продукта, проектирането на протокола и планираните конектори. Наличието на документиран профил за интеграция само по себе си не означава, че съответният конектор за производствена среда е готов.
Лексика, свързана със статуса
| Статус | Значение |
|---|---|
| Оперативно | Внедрено и тествано в текущия работен процес на Studio. Възможно е все пак да се наложи конфигурация, специфична за конкретното внедряване. |
| Зависи от конфигурацията | Реализирано в Studio, но изисква администраторски права, крайни точки, регистрация по стандарта „OAuth“ (OIDC), доставка на електронна поща, миграция на база данни или външна услуга. |
| Основа | Налице са моделът на данните, потребителският интерфейс, регистърът на доставчиците, скелетът на клиента или конфигурацията, но цялостната интеграция в производствена среда все още не е завършена. |
| Само спецификация | Протоколът/профилът е документиран, но еталонната реализация все още не предоставя пълния конектор. |
| Планирано | Предвидена област за интеграция без изчерпателна отправна точка за внедряване. |
Актуална матрица за интеграция
| Интеграция | Текущо състояние | Приложени доказателства / текущ обхват | Оставаща работа |
|---|---|---|---|
| OJS | Зависи от оперативните условия и конфигурацията; проверено чрез вградена E2E проверка | Стартиране с подпис на автор/редактор/рецензент; обмен на метаданни и файлове в рамките на заданието; импорт от DOCX; двойно анонимно представяне на рецензентите; задължителни вградени формуляри за рецензиране; корекции на ръкописа; обратна връзка, видима за автора, и такава, достъпна само за редактора; записване на рецензията с HMAC подпис. Проверено спрямо еднократна среда OJS 3.5. | Продължаване на укрепването на процеса на връщане за публикуване, тестване на съвместимостта с поддържаните версии на OJS и документацията за операторите. |
| OMP | Зависи от оперативната среда и конфигурацията; проверено в оригинална E2E среда | Стартиране с подпис на автор/редактор/рецензент; съпоставяне на монографии и проучвания; обхватът на рецензента е ограничен до възложеното проучване; файлове в рамките на възложената задача; задължителни оригинални формуляри за рецензиране; корекции; отделна обратна връзка; записване с HMAC-подпис. Проверено спрямо еднократна среда OMP 3.5. | Продължаване на по-широкото тестване на съвместимостта с версиите на OMP, указания за внедряване в производствена среда и укрепване на процеса на връщане на публикации. |
| ORCID OAuth/OIDC | Зависи от конфигурацията | Реализирани са: удостоверяване/свързване на акаунти, маршрутизиране на лични/институционални идентификационни данни, избор между тестова среда и производствена среда, прехвърляне между вграден браузър и App-Link, както и пряка проверка на „ORCID“ от потока за авторски подпис. | Регистрация на удостоверения в производствената среда, конфигурация на обратното извикване, оперативен мониторинг и по-широко междуплатформено регресивно тестване. |
| Google / Microsoft / институционален OIDC | Зависи от конфигурацията | Имплементирани са: код за оторизация + PKCE, валидиране на състоянието и nonce, проверка на discovery/JWKS, проверки на издателя/получателя, изрично свързване на акаунти и споделено родно прехвърляне. | Регистрация на доставчици в производствена среда, тестване на внедряването за конкретни клиенти/доставчици и оперативен мониторинг. |
| Управление на свързани идентичности | Оперативно / зависи от доставчика | Настройките на профила включват парола, идентичности по стандарта „ORCID“ и OIDC, показват метаданни за връзката и последното използване, поддържат изрично свързване/развързване и предотвратяват премахването на последния използваем метод за вход. | По-широко потребителско изживяване от страна на доставчика и бъдеща платформа за управление на SAML. |
| Институционално администриране | Зависи от конфигурацията | Внедрени са членството в институции, ролите MEMBER/ADMIN/OWNER, специален вход за администратори, прилагане на роли от страна на сървъра, централно администриране на OMI и защита на последния собственик. | Насоки за миграция/конфигурация в производствена среда, покритие на регресионните тестове за оторизация и разширяване на управлението на интеграцията с институциите. |
| Администратор на институцията API | Зависи от конфигурацията | Удостоверенията за устройства, обвързани с институцията, използват показване на еднократни токени, съхранение с хеш на SHA-256, срок на валидност/отмяна, изрично определени обхвати и събития за одит на администрирането, които се записват само за добавяне. Имплементирани са крайни точки от версия v1 за членове/контекст. | Добавете крайни точки за управление на интеграцията в обхвата на институцията зад запазените обхвати integrations:read / integrations:write и разширете документацията за автоматизацията. |
| Нативно съхранение, съобразено с устройството | Работи на инсталираните клиенти | Инсталираните клиенти разграничават собствените устройства от споделените/чуждите устройства. Собствените устройства могат да запазват нативните работни пътища; споделените устройства не запазват локалните пътища и предпочитат облачни връзки в рамките на профила. Еднократните преносими/сменяеми носители остават достъпни. | Продължете тестовете за възстановяване и валидирането на крайни случаи, специфични за платформата. |
| Документи в Android / SAF | Работеща публична бета версия | Android използва системния избор „Документи / Storage Access Framework“ за отваряне, запазване, запазване под друго име, преносимо архивиране чрез „OMI“ и поддържани експортирания, вместо общи разрешения за споделено хранилище. | Тестване за регресия на устройствата/производителите и укрепване на сигурността при разпространението в магазините. |
| Локално синхронизирано хранилище | Работи на настолен компютър | OneDrive, SharePoint, Google Drive, Dropbox, Nextcloud и iCloud Drive са представени като специфични за съответния доставчик методи за локално синхронизирани папки. Studio записва преносими файлове от типа „OMI“ локално, докато клиентът на доставчика извършва удостоверяване/синхронизация. Пътеките остават локални за устройството. | Продължете тестовете за възстановяване при прекъсната локална/доставчикова синхронизация и разширете валидирането на родните платформи. |
| WebDAV / Nextcloud в рамките на профила | Зависи от конфигурацията | Пряките връзки поддържат криптирани идентификационни данни от страна на сървъра, тестване на връзката, качване на преносими резервни копия, проверка на целостта, възстановяване и изтриване. Връзките са ограничени до автентифицирания профил в Studio и могат да следват потребителя на различни устройства. | Усъвършенстване на потребителския интерфейс, специфично за доставчика, оперативно наблюдение и по-широко тестване на оперативната съвместимост. |
| Каталог на доставчиците на облачни услуги | Оперативна основа | Изборът на доставчик → тип акаунт (личен/бизнес) → метод на свързване е реализиран за Nextcloud, WebDAV, OneDrive, SharePoint, Google Drive, Dropbox и iCloud Drive. Локалните синхронизирани папки представляват методи на реалния доставчик, а не на псевдо-доставчик. | Постепенно добавяне на директни OAuth 2.0 конектори, когато нативната/локалната синхронизация не е желаният режим. |
| Структуриран превод с DeepL | Зависи от конфигурацията | Изпълнението на DeepL от страна на сървъра е реализирано за обхвати като избрани части, блокове, раздели и целия текст. Структурираната сегментация запазва вградените маркировки и изключва цитати, препратки, код, уравнения и записи от библиографията; по-големи преводи могат да се съхраняват като отделни езикови варианти. | Мониторинг на производствените удостоверения/квоти, потребителски интерфейс при грешки на доставчика и по-широко тестване на езиковите двойки. |
| Услуги по граматика и стил | Зависими от конфигурацията | Незадължителна проверка, съвместима с LanguageTool, и изпълнение на конфигуриран езиков редактор с изкуствен интелект, които предоставят структурирани данни за проблеми с правописа, граматиката, пунктуацията и стила, без пряко променяне на текста от страна на сървъра. | Настройка на доставчика на производствени услуги, управление на латентността и грешките, както и по-широко езиково покритие. |
| ** AI агенти наOMI** | Зависими от конфигурацията | Независимият от доставчика езиков редактор, асистентът за метаданни, инструментът за обобщаване и проверката на цитати работят чрез конфигурируема HTTPS крайна точка за автодопълване в чата. Предложенията изискват изрично одобрение от страна на потребителя. Съдържанието, което е поверително за преглед, се блокира, освен ако не е изрично разрешено. | Тестване на оперативната съвместимост между доставчиците, тестови набори за оценка, управление на квоти/закъснения и допълнителни ограничения за безопасност, специфични за всеки агент. |
| Аудиторска следа за интеграция | Оперативна | Външната система за изпълнение записва метаданни за операцията, доставчика и обхвата, както и размери и хеш-суми от SHA-256, вместо текст от ръкописа, подсказки, резултати или поверителна информация. | Контроли за отчитане и съхранение, както и оперативни табла за управление. |
| Разширение за интеграция „API“ v1 | Оперативна основа | Реализирани са регистърът на манифестите на разширенията, проверките за съвместимост и версии, разрешенията с ограничен обхват, функционалните възможности, крайните точки, достъпни само през HTTPS, и документацията за SDK. | Примери за разширения на трети страни, политика за подписване и доверие, както и тестови набори за съответствие. |
| Каталог на доставчиците на интеграции | В експлоатация | Studio предоставя достъп до раздел „Интеграции“, регистър на доставчиците, метаданни за режима на удостоверяване, състояние на конфигурацията, конфигурация на хранилището, инструменти за превод/агенти, информация за одит и интерфейси за разширения. | Добавяйте постепенно производствени конектори, без да обвързвате модела на ръкописа „OMI“ с конкретни доставчици. |
| Структурирани библиографски услуги | Оперативна основа | Структурираните търсения в Crossref, DataCite, OpenAlex и MTMT се съпоставят с общ библиографски модел, като се прилагат нормализация и премахване на дублираните записи съгласно стандарта „DOI“. Интегрирани са и търсенията по идентификатори в ROR и ORCID. | Кеширане, политика за съгласуване/произход, повече регистри на идентификатори и специфично за доставчика управление на надеждността. |
| Библиографски уеб доставчици с вход | Оперативна основа / зависи от доставчика | Предварително зададените и конфигурируеми HTTPS уеб доставчици с вход в Academia.edu могат да се отварят, без Studio да събира пароли. Tauri запазва сесиите на WebView на доставчика и поддържа изрично изчистване при излизане от системата. | Тестване на съвместимостта, специфично за всеки доставчик, и по-ясен потребителски интерфейс за доверие/сесия. |
| Хранилище / депозит за съхранение | Планирано | Архитектурата поддържа адаптери за външно депозиране и съхранение. | Определяне на конкретни профили на свързващи елементи и внедряване на референтни адаптери. |
OJS бележка за внедряване
OJS понастоящем представлява най-добре разработената интеграция с външна платформа за публикуване в референтната реализация. Производствената архитектура запазва OJS и Studio като отделни приложения с отделни слоеве за съхранение на данни. OJS остава основният източник на информация за работния процес по подаване на статии, възлагането на рецензенти, етапите на рецензиране и редакционните решения; Studio осигурява структурираната работна среда за ръкописи и рецензии.
Проверената траектория вече е надхвърлила етапа на концептуалния профил на изстрелване. Studio може да получава подписан контекст от „OJS“, да извлича файлове с ръкописи чрез интеграционни крайни точки, да възстановява структурата на ръкописа от материал от „DOCX“, да запазва поддържаната вградена семантика и бележките, както и да предоставя работни потоци за автори, редактори и рецензенти, съобразени с техните роли. Външно възложените рецензии могат да бъдат приемани и обработвани в Studio, докато границите на двойно-сляпата идентичност остават част от рецензионния процес.
Заявките от страна на сървъра, произтичащи от контекста на стартиране на OJS, са ограничени до регистрирания от администратора източник на инсталацията и са защитени срещу опасни пренасочвания, частни/резервирани дестинации, преминаване през пътеки и промени в правата, контролирани чрез заявки. Това е част от настоящите базови изисквания за сигурност при интеграцията, а не промяна в самия протокол OJS.
Интеграцията умишлено използва границите на application/API, вместо директен достъп до базата данни OJS. Това запазва независимостта при внедряването и позволява тестване на поведението на протокола.
Това не означава, че всяка операция, описана в пълния профил за интеграция „OJS“ v1, е достигнала окончателен статус на оперативна съвместимост или съответствие. Синхронизацията в двете посоки, пътищата за публикуване и връщане, както и по-широката съвместимост между версиите, остават области, в които все още се работи за подобряване.
OMP бележка за внедряване
OMP е първокласна цел за оперативна интеграция със специален плъгин и пълно покритие от начало до край в OMP 3.5. Стартирането на рецензентите е обвързано с едно зададено проучване; данните за родителската монография, съпътстващите проучвания и самоличността на съавторите се изключват от анонимната проекция на рецензирането. „OMP“ остава авторитетен източник за работния поток на печат, заданията, кръговете и поведението при завършване, докато Studio осигурява структурираното работно пространство за рецензиране.
Модел за интеграция на хранилищата
Studio вече използва три явни контекста за съхранение.
Собствено устройство / вградено системно хранилище. На надеждно инсталирано устройство Studio може да използва обичайното вградено в платформата хранилище, избрано от автора. При целеви платформи от типа „настолен компютър“ могат да се използват локални папки, монтирани/мрежови хранилища и папки, синхронизирани от доставчика. Android използва системния интерфейс „Документи“ / „Storage Access Framework“.
Споделено или външно устройство. По подразбиране новооткритите инсталирани устройства се настройват на ограничено локално съхранение. Studio не запазва пътя към локалния работен файл и дава предимство на облачните връзки, принадлежащи към профила, с който сте влезли. Възможно е еднократно използване на сменяеми/преносими носители, без да се запазва избраният път.
Директна връзка чрез профил. Самата Studio се свързва с услуга за съхранение на данни. В момента реализираният директен път е WebDAV/Nextcloud с криптирани данни за достъп от страна на сървъра, ограничени до обхвата на автентифицирания потребител. Бъдещите връзки с доставчици от типа „OAuth“ следва да следват същия модел, ограничен до обхвата на профила.
Този дизайн запазва принципа „първо локално“, без да предполага, че всеки доставчик на облачни услуги трябва да бъде контролиран от Studio или че споделеното устройство трябва да запази локалния път на автора.
Граница на интеграцията между нативния клиент и сървъра
Уеб, десктоп и Android приложенията използват общо Studio API и договори за интеграция. Нативните Tauri клиенти използват транспорт за удостоверяване, съвместим с източниците на нативните приложения, вместо да разчитат на поведението на „бисквитките“, характерно само за браузърите. ORCID и OIDC могат да се върнат чрез общия нативен път за прехвърляне.
Работата с файлове в родния формат е съобразена с платформата: настолните приложения използват диалогови прозорци за файлове и папки, характерни за съответната платформа, докато Android използва „Documents“/SAF. Hosted Studio използва изтегляне през браузъра за експортиране на файлове.
Режими на удостоверяване
Интеграционният слой на Studio разграничава моделите за удостоверяване на доставчиците, вместо да приема, че всяка услуга може да използва един и същ тип удостоверителни данни. В зависимост от доставчика дадена интеграция може да използва OAuth/OIDC, ключове или токени от типа „API“, удостоверения за услуга, подписани твърдения за стартиране, удостоверения, управлявани при разгръщането, удостоверения от типа „API“ с обхват на институцията или изобщо да не използва удостоверения на доставчика, съхранявани в OMI, когато локален клиент за синхронизация извършва удостоверяване.
Влизането чрез потребителско име и парола от страна на потребителя е подходящо само когато външният доставчик изрично поддържа такъв процес. Данните за влизане не трябва да се извличат от формуляра за влизане в уебсайта на доставчика, предназначен за потребители.
Разделяне на идентичността и администрирането
Идентичността на акаунта в Studio, идентичността на научния сътрудник, членството в институцията и централната администрация са умишлено разграничени.
Аутентификацията определя кои лица имат достъп до услугите на Studio. Записите за съавторите отразяват научното авторство, принадлежността към институция, ORCID и ролите на съавторите. Членството в институция отразява принадлежността към конкретна организация и правомощията, определени на MEMBER/ADMIN/OWNER. Централното администриране представлява отделно ниво на привилегии, обхващащо всички институции.
Нито администрацията на институцията, нито централната администрация предоставя самостоятелно достъп до ръкописи, рецензии или редакционно съдържание.
За модела на управление вижте Institutional and Central Administration.
Статус на продукта спрямо съответствието със стандарта „OMI“
Статусите на тази страница описват Open Manuscript Studio имплементацията на продукта. Те не удостоверяват съответствие на конектора с OMI. Формалното съответствие изисква изисквания с версии, тестови набори и рамката за способности/съответствие.
За информация относно статуса на нивото на спецификациите вижте OMI Implementation Status Matrix. За по-общата продуктова линия на Studio вижте Studio Implementation Status.