Различия

Показаны различия между двумя версиями страницы.

--- sharixopen:knowledge:integrations:start [2026/10/17 08:51] – [sharixknowledge] approved package sx_knowledge_api_open
+++ sharixopen:knowledge:integrations:start [2026/10/17 20:49] (текущий) – [sharixknowledge] approved package sx_knowledge_api_open
@@ Строка 1: / Строка 1: @@
-====== Интеграции и внешние интерфейсы ======
+<sharix-knowledge-meta>
+{
+    "id": "ShariXKnowledgeIntegrations",
+    "page": "sharixopen:knowledge:integrations:start",
+    "area": "open",
+    "type": "reference",
+    "title": "Интеграции Open",
+    "status": "review",
+    "schema_version": 1,
+    "relations": {
+        "related_to": [
+            "ShariXKnowledgeOpenKnowledgeIntegrationsArchitecture",
+            "ShariXKnowledgeOpenKnowledgeIntegrationsPlatformprofiles",
+            "ShariXKnowledgeOpenKnowledgeDomainAutomatedverification",
+            "ShariXKnowledgeOpenKnowledgeIntegrationsXmppnotifications",
+            "ShariXKnowledgeOpenKnowledgeModulesMoodle",
+            "ShariXKnowledgeOpenKnowledgeModulesNextcloud"
+        ]
+    },
+    "extensions": {
+        "taxonomy": {
+            "domain": "reference",
+            "lifecycle": "unspecified",
+            "parents": [
+                "ShariXKnowledgeOpenKnowledgeStart"
+            ],
+            "terms": []
+        },
+        "glossary": []
+    },
+    "content_sha256": "a12b72115a8f33a82f69d221fcdcdf28cc70552ee4e3e0401ae4c467c07cd3ff",
+    "schema": 1
+}
+</sharix-knowledge-meta>
+====== Интеграции Open ======
+~~NOCACHE~~
-**Область:** Open. **Состояние документа:** проект для обсуждения (review).
+===== Внешние границы =====
+Platform API управляет удалёнными действиями, Moodle сообщает образовательное evidence, Nextcloud хранит файлы, Calendar показывает расписания, XMPP доставляет уведомления. Все результаты подтверждаются владельцем первичных данных.
+===== Отказы =====
+Транспортная ошибка, отказ авторизации, неподходящий профиль, недоступный provider и бизнес-отказ — разные состояния. Fallback не должен выдавать фиктивный успех.
-Здесь фиксируются контракты между модулями, сервисами и внешними системами, без публикации токенов, паролей, закрытых эндпоинтов и частной конфигурации.
+===== Детальные правила =====
+  * [[sharixopen:knowledge:integrations:architecture|Интеграции Open: принцип локального владельца]]
+  * [[sharixopen:knowledge:integrations:platform_profiles|Профили подключения к Platform и demo boundary]]
+  * [[sharixopen:knowledge:domain:automated_verification|Автоматизированная верификация и fallback]]
+  * [[sharixopen:knowledge:integrations:xmpp_notifications|XMPP, уведомления и диагностика соединения]]
+  * [[sharixopen:knowledge:modules:moodle|Moodle: требования к курсам и проверка результатов]]
+  * [[sharixopen:knowledge:modules:nextcloud|Nextcloud: хранение файлов и ссылки]]
-===== Для каждого взаимодействия =====
+~~SHARIX_KNOWLEDGE_RELATED~~
-  - Стороны, владелец контракта и граница доступа Open/Platform/Joint.
-  - Формат запросов и ответов, схема ошибок, идемпотентность.
-  - Аутентификация на уровне принципов; секреты — только вне wiki.
-  - Версионирование только при действительно одновременной поддержке несовместимых протоколов.
-  - Способы проверки и характерные сбои.
-  * [[sharixopen:knowledge:architecture:boundaries|Разделение ответственности]].
-  * [[sharixopen:knowledge:configuration:start|Настройка]].
-Ориентиры TZ: ''02-api-and-extension-contracts.md'', ''11-external-integrations.md'', ''integrations/*''. Переносить только сведения, допустимые для Open.
-===== Навигация =====
-  * [[sharixopen:knowledge:start|Общий каталог ShariX]].
-  * [[sharixopen:knowledge:architecture:start|Архитектура проекта ShariX]].
-  * [[sharixopen:knowledge:configuration:start|Рекомендации по настройке]].
-~~NOCACHE~~
 ~~SHARIX_KNOWLEDGE_GRAPH~~
 ~~SHARIX_KNOWLEDGE_CATALOG~~
-~~SHARIX_KNOWLEDGE_RELATED~~