Добро пожаловать
Adapstory — GenAI-native LMS с архитектурой plugin-first. Создавайте плагины, которые расширяют runtime, модель данных и AI-gateway.
Эта документация адресована разработчикам, создающим и разворачивающим плагины для платформы Adapstory.
Идентичность платформы
Adapstory — GenAI-native (LLM это ядро, а не надстройка) и plugin-first (всё что может быть плагином обязано быть плагином). Ядро минимально: BC-10, BC-02, BC-15, BC-16, BC-19, BC-01. Вся бизнес-ценность поставляется плагинами.
С чего начать
Обзор платформы
Как связаны ограниченные контексты (bounded contexts), что делает plugin runtime и куда встраивается ваш код.
Quickstart по плагинам
От нуля до работающего плагина за ~30 минут. Манифест, handler, локальный запуск, публикация.
Справочник по манифесту плагина
Все поля `plugin.yaml` — идентичность, MCP-инструменты, конфиг моделей, guardrails, права.
Жизненный цикл и деплой
Установка, обновление, откат и тенант-изоляция. Как Kyverno проверяет подписанный образ.
Что вы будете собирать
Плагины Adapstory могут:
- Расширять Data Model Engine (BC-15) собственными сущностями, валидациями и реакциями на события.
- Регистрировать MCP-инструменты в Plugin Gateway (BC-01), чтобы LLM могли вызывать их.
- Выполнять изолированную тенант-логику под управлением Multi-Tenant Runtime (BC-19) с жёсткими границами данных.
- Поставлять AI-фичи с версионированными guardrails, контролем token-бюджета и A/B-тестированием конфигов моделей.
Гарантии контракта
- Плагины подписываются Cosign и сопровождаются SBOM + SLSA provenance. Kyverno обеспечивает это на admission.
- Связь plugin ↔ core — через Kafka + CloudEvents или REST. Shared-баз данных нет.
- Доступ к LLM — только через LLM Gateway. Прямые вызовы провайдеров запрещены.
- Секреты идут по пути Vault → External Secrets Operator → Kubernetes Secret. Никогда в манифестах.
Помощь и вклад
- Исходники: github.com/adapstory/Adapstory-GitOps (
infra/docs/content/) - Issues: github.com/adapstory/Adapstory-GitOps/issues
- Редактирование страницы: у каждой статьи справа вверху есть ссылка «Edit on GitHub».