# Документация LMS

> Коробочная LMS-платформа для онлайн-школ: одна установка — одна школа. Документация к версии продукта 2026.10.2. Продукт в разработке, и это видно по пометкам: «страница ещё не написана» — значит продукт умеет, а мы не описали; «этого ещё нет в продукте» — значит не умеет. Раздел «API» описывает первый рабочий срез — он в разработке, маршрутов пока нет; раздел «Проект API» — замысел остального.

Вся документация одним текстом — /llms-full.txt.
Спецификация API — /openapi.draft.json. В имени «draft» не для красоты: API ещё не написано,
спецификация собрана из проектного документа, часть адресов выведена из сокращений и может измениться.
Адрес /openapi.json не занят намеренно — он появится, когда появится API.
Любая страница доступна в Markdown: к её адресу добавляется `.md`.

## Начало

Что это за платформа, как она устроена, чем отличается от GetCourse и School-master, как поставить и запустить.

- [Начало](https://docs-school.sersidteh.ru/start/): Что это за платформа, как она устроена, чем отличается от GetCourse и School-master, как поставить на сервер и что сделать в первые полчаса.
- [Что это за платформа](https://docs-school.sersidteh.ru/start/what-is-it/): Коробочная LMS для онлайн-школы: код и база на сервере школы, одна установка — одна школа, что входит и кому не подходит.
- [Как устроена](https://docs-school.sersidteh.ru/start/architecture/): Модульный монолит из трёх процессов, шина событий вместо прямых вызовов, адаптеры к внешним сервисам и требования к серверу.
- [Чем отличается технически](https://docs-school.sersidteh.ru/start/differences/): Устройство API и вебхуков, модель прав, механизм кастомизации и выгрузка данных — как это сделано у GetCourse и как здесь. Плюс список того, чего в продукте нет.
- [Лицензионный ключ и обновления](https://docs-school.sersidteh.ru/start/license/): Что такое ключ установки, что происходит при недоступности сервера лицензий, что с копией без ключа и как приходят обновления.
- [Что вам понадобится кроме коробки](https://docs-school.sersidteh.ru/start/requirements/): Сервер и его характеристики, хранилище, видеохостинг, домен, отправка писем, платёжный провайдер — что нужно завести и порядок цен на внешние сервисы.
- [Установка](https://docs-school.sersidteh.ru/start/install/): Требования к серверу, предустановочный чек-лист из шести проверок, порядок установки и честное состояние сценария обновления. [написано наполовину]
- [Перенос данных с GetCourse](https://docs-school.sersidteh.ru/start/migration/): Что их API отдаёт, что не отдаёт, что придётся выгружать руками и сколько это занимает при их квотах. Порядок переноса и что проверить. [написано наполовину]
- [Первый запуск](https://docs-school.sersidteh.ru/start/first-run/): Что сделать в первые полчаса после установки: настройки школы, первый курс с уроком и видео, ученик, доступ, проверка входа.

## Как пользоваться

Работа со школой по задачам: курсы и уроки, доступы, ученики, продажи, рассылки, сценарии.

- [Как пользоваться](https://docs-school.sersidteh.ru/guide/): Работа со школой по задачам: курсы и уроки, доступы, ученики, продажи, почта и рассылки, сценарии, вебинары, аналитика, ИИ-агент.
- [Курсы и уроки](https://docs-school.sersidteh.ru/guide/courses/): Три уровня — курс, модуль, урок. Блоки урока, видео двумя источниками, задания и ответы, тесты, публикация.
- [Доступы](https://docs-school.sersidteh.ru/guide/access/): Доступ как запись, четыре правила открытия урока, дата старта, условия только через «и», продление, заморозка, отзыв и ответ на «почему урок закрыт».
- [Сертификаты](https://docs-school.sersidteh.ru/guide/certificates/): Как курс выдаёт сертификат, раздел «Сертификаты» со списком выданных, выдача вручную, отзыв и проверка по номеру.
- [Ученики](https://docs-school.sersidteh.ru/guide/students/): Поиск и сегменты, профиль, потоки и группы, и отдельно — как устроены персональные данные: журнал согласий, отзыв, выгрузка по требованию, обезличивание.
- [Свой домен](https://docs-school.sersidteh.ru/guide/domains/): Как подключить к школе свой домен — какие записи добавить у регистратора, что значит каждое состояние проверки, когда выпускается сертификат и почему адрес установки остаётся рабочим.
- [Поручения](https://docs-school.sersidteh.ru/guide/errands/): Задачник команды внутри школы: кто кому ставит, воронка работы от «новое» до «готово», отделы, сроки и проверка.
- [Интеграции](https://docs-school.sersidteh.ru/guide/integrations/): Всё, чем школа связана с внешним миром, — касса, почта, Telegram, видео, файлы и счётчики — одним списком по задачам, с состоянием каждой и прямым списком того, чего в продукте нет.
- [Подключение сервисов пошагово](https://docs-school.sersidteh.ru/guide/setup/): Куда нажимать в MAX для бизнеса, ВКонтакте, VK ID и Telegram, чтобы получить бота, ключ и включить приём сообщений — со ссылками на кабинеты.
- [Продажи](https://docs-school.sersidteh.ru/guide/sales/): Продукт и тариф, заказ и покупка, приём оплаты, промокоды, рассрочка, отмена заказа и письма, которые уходят покупателю сами.
- [Почта школы](https://docs-school.sersidteh.ru/guide/mail/): Как настроить отправку писем, чтобы они доходили: SMTP, SPF, DKIM, DMARC, подтверждение адреса и что делать, когда письма уходят в спам.
- [Рассылки](https://docs-school.sersidteh.ru/guide/messaging/): Конструктор рассылки по шагам, кому письмо дойдёт, подстановки, отписка, тестовое до отправки, темп, расписание и отчёт. И почему отписка проверяется в движке, а не в форме.
- [Вебинары](https://docs-school.sersidteh.ru/guide/webinars/): Свой эфир из OBS и чужие плееры, комната с чатом, продающие блоки по ходу эфира, письма записавшимся и отчёт «пришли — досмотрели — купили».
- [ИИ-агент школы](https://docs-school.sersidteh.ru/guide/agent/): Помощник внутри школы: что умеет, кому открыт, что делает сам, а что спрашивает, и почему у него нет собственных прав.
- [Сценарии](https://docs-school.sersidteh.ru/guide/scenarios/): Графический редактор автоматизаций: узлы возят мышью, связи тянут от портов. Триггеры, условия, задержки, проверка до запуска и путь конкретного человека.
- [Аналитика и отчёты](https://docs-school.sersidteh.ru/guide/analytics/): Посещения школы, деньги по источникам, когорты, расходы на рекламу и десять отчётов по учёбе. И почему «источник неизвестен» стоит первой строкой, а не сноской внизу.

## API

Первый рабочий срез API — в разработке: курсы, модули, уроки, блоки, файлы, люди, доступы, прогресс, сертификаты, вебхуки — примерно 50–60 операций по тому, что продукт уже умеет руками. Маршрутов пока нет. Быстрый старт, ключи, формат, пагинация, лимиты, ошибки, идемпотентность, вебхуки, песочница.

- [API](https://docs-school.sersidteh.ru/api/): Одно API на всё, что умеет интерфейс. Первый рабочий срез в разработке: курсы, уроки, файлы, люди, доступы, прогресс, сертификаты, вебхуки.
- [Быстрый старт](https://docs-school.sersidteh.ru/api/quickstart/): Ключ и первый запрос за пять минут: создать ключ, получить список курсов, прочитать конверт ответа и служебные заголовки, подписаться на события.
- [Ошибки первого дня](https://docs-school.sersidteh.ru/api/first-day/): Симптом → причина → починка. Всё, обо что спотыкаются в первые сутки интеграции: 401 на верном ключе, тихо неверные даты, двойные заказы, подпись вебхука.
- [Состав среза и граница](https://docs-school.sersidteh.ru/api/scope/): Что входит в первый рабочий срез API, что остаётся проектом, почему граница проходит именно там и как отличать одно от другого на этом сайте.
- [Аутентификация](https://docs-school.sersidteh.ru/api/auth/): Токен в заголовке Authorization, префиксы боевого и тестового ключа, действие от лица пользователя и одноразовая ссылка входа.
- [Ключи](https://docs-school.sersidteh.ru/api/keys/): Школа заводит ключи сама: создание, срок, список адресов, отзыв. Значение показывается один раз, права те же, что у роли, и сужаются до курса. [написано наполовину]
- [Права](https://docs-school.sersidteh.ru/api/permissions/): Сорок девять прав — у каждого раздела своё, семь ролей и одна функция проверки — общая для человека, ключа интеграции и ИИ-агента. Плюс пять личных выдач владельца и две ступени ролей — старший куратор и руководитель отдела продаж.
- [Формат](https://docs-school.sersidteh.ru/api/format/): Базовый адрес, транспорт, тело, именование, типизированные идентификаторы, даты с поясом, деньги парой с валютой и конверт ответа.
- [Пагинация, фильтры, сортировка](https://docs-school.sersidteh.ru/api/pagination/): Курсор вместо смещения, единый синтаксис фильтров для всех ресурсов, фильтр по сегменту, разворачивание связей и выбор полей.
- [Лимиты](https://docs-school.sersidteh.ru/api/limits/): Значения по умолчанию, заголовки в каждом ответе, что делать при 429 и как поменять лимиты — это ваш сервер, и они параметр установки.
- [Ошибки](https://docs-school.sersidteh.ru/api/errors/): Форма ошибки, полный список кодов и что делать с каждым, несколько ошибок валидации разом и идентификатор запроса, по которому находится трассировка.
- [Идемпотентность](https://docs-school.sersidteh.ru/api/idempotency/): Ключ идемпотентности на операциях записи, повтор с тем же ключом, тот же ключ с другим телом — и идемпотентность на приёме вебхуков.
- [Вебхуки](https://docs-school.sersidteh.ru/api/webhooks/): Подписка на события, единый конверт для всех событий, подпись HMAC по сырому телу, шесть попыток за сутки, переигрывание пропущенного и почему порядок не гарантируется.
- [Песочница](https://docs-school.sersidteh.ru/api/sandbox/): Тестовый ключ против той же установки: платежи в тестовом режиме, сообщения не уходят наружу, вебхуки на отдельный адрес. И чего это не заменяет.

## Проект API

ПРОЕКТНАЯ СПЕЦИФИКАЦИЯ, А НЕ РАБОТАЮЩЕЕ API: каталог всего замысла — 226 операций, у 60 адрес выведен из сокращённой записи и может измениться. Писать интеграцию по этому разделу нельзя; что реализуется первым срезом — в разделе «API».

- [Проект API](https://docs-school.sersidteh.ru/api-project/): ПРОЕКТНАЯ СПЕЦИФИКАЦИЯ, А НЕ РАБОТАЮЩЕЕ API. Каталог всего замысла — 226 операций. Оценить возможности можно, писать интеграцию — нет.
- [Каталог ресурсов](https://docs-school.sersidteh.ru/api/reference/): Все 253 операций API по разделам, с путями, параметрами и готовым curl. Собрано из OpenAPI.
- [Каталог событий](https://docs-school.sersidteh.ru/api/events/): Все 82 событий системы по группам. Одно и то же событие приходит в вебхук, запускает сценарий и лежит в журнале.
- [Агент школы](https://docs-school.sersidteh.ru/api/reference/agent-shkoly/): Операции API раздела «Агент школы»: 8 шт. Пути, параметры, коды ответа и готовый curl.
- [Аналитика](https://docs-school.sersidteh.ru/api/reference/analitika/): Операции API раздела «Аналитика»: 5 шт. Пути, параметры, коды ответа и готовый curl.
- [CRM, сегменты, сообщения](https://docs-school.sersidteh.ru/api/reference/crm-segmenty-soobshheniya/): Операции API раздела «CRM, сегменты, сообщения»: 25 шт. Пути, параметры, коды ответа и готовый curl.
- [Ключи API](https://docs-school.sersidteh.ru/api/reference/klyuchi-api/): Операции API раздела «Ключи API»: 3 шт. Пути, параметры, коды ответа и готовый curl.
- [Коммерция](https://docs-school.sersidteh.ru/api/reference/kommerciya/): Операции API раздела «Коммерция»: 45 шт. Пути, параметры, коды ответа и готовый curl.
- [Массовое действие над сегментом](https://docs-school.sersidteh.ru/api/reference/massovoe-dejstvie-nad-segmentom/): Операции API раздела «Массовое действие над сегментом»: 1 шт. Пути, параметры, коды ответа и готовый curl.
- [Обучение](https://docs-school.sersidteh.ru/api/reference/obuchenie/): Операции API раздела «Обучение»: 57 шт. Пути, параметры, коды ответа и готовый curl.
- [Пользователи и доступ](https://docs-school.sersidteh.ru/api/reference/polzovateli-i-dostup/): Операции API раздела «Пользователи и доступ»: 31 шт. Пути, параметры, коды ответа и готовый curl.
- [Приём денег](https://docs-school.sersidteh.ru/api/reference/priem-deneg/): Операции API раздела «Приём денег»: 1 шт. Пути, параметры, коды ответа и готовый curl.
- [Продажи: продукты, тарифы, заказы](https://docs-school.sersidteh.ru/api/reference/prodazhi-produkty-tarify-zakazy/): Операции API раздела «Продажи: продукты, тарифы, заказы»: 1 шт. Пути, параметры, коды ответа и готовый curl.
- [Рассылки](https://docs-school.sersidteh.ru/api/reference/rassylki/): Операции API раздела «Рассылки»: 4 шт. Пути, параметры, коды ответа и готовый curl.
- [Сайт и файлы](https://docs-school.sersidteh.ru/api/reference/sajt-i-fajly/): Операции API раздела «Сайт и файлы»: 17 шт. Пути, параметры, коды ответа и готовый curl.
- [Сценарии (автоматизации)](https://docs-school.sersidteh.ru/api/reference/scenarii-avtomatizacii/): Операции API раздела «Сценарии (автоматизации)»: 12 шт. Пути, параметры, коды ответа и готовый curl.
- [Сценарии](https://docs-school.sersidteh.ru/api/reference/scenarii/): Операции API раздела «Сценарии»: 3 шт. Пути, параметры, коды ответа и готовый curl.
- [Сегменты и теги](https://docs-school.sersidteh.ru/api/reference/segmenty-i-tegi/): Операции API раздела «Сегменты и теги»: 2 шт. Пути, параметры, коды ответа и готовый curl.
- [Служебное](https://docs-school.sersidteh.ru/api/reference/sluzhebnoe/): Операции API раздела «Служебное»: 21 шт. Пути, параметры, коды ответа и готовый curl.
- [Вебинары](https://docs-school.sersidteh.ru/api/reference/vebinary/): Операции API раздела «Вебинары»: 15 шт. Пути, параметры, коды ответа и готовый curl.
- [Вход из Telegram](https://docs-school.sersidteh.ru/api/reference/vhod-iz-telegram/): Операции API раздела «Вход из Telegram»: 2 шт. Пути, параметры, коды ответа и готовый curl.

## Оформление

Как менять вид школы, не трогая нашу вёрстку: переменные оформления, якоря, темы, блоки кода, аварийный выключатель.

- [Оформление](https://docs-school.sersidteh.ru/appearance/): Как менять вид школы, не трогая нашу вёрстку: две настройки закрывают фирменный стиль, переменные и якоря — контракт, который переживает обновление.
- [Переменные оформления](https://docs-school.sersidteh.ru/appearance/variables/): 83 публичных переменных CSS, которыми школа меняет цвета, шрифты, скругления и плотность интерфейса, не трогая нашу вёрстку.
- [Якоря](https://docs-school.sersidteh.ru/appearance/anchors/): Стабильные атрибуты data-lms на элементах, которые называют словами, — по ним пишется свой CSS школы. Почему не классы вёрстки и какие якоря есть.
- [Свой CSS и JS школы](https://docs-school.sersidteh.ru/appearance/themes/): Куда писать свой CSS и JS, кто может, где они действуют и где нет, как проверить и откатить — и аварийный адрес, который понадобится раньше, чем кажется.
- [Блоки кода](https://docs-school.sersidteh.ru/appearance/code-blocks/): Блоков кода в конструкторе ещё нет. Что решено: три блока разной опасности, изоляция CSS документом, JS никогда не выполняется в админке. [этого ещё нет в продукте]
- [Аварийный выключатель](https://docs-school.sersidteh.ru/appearance/kill-switch/): Что делать, если свой CSS или JS сломал страницы школы: адрес без своего кода, экраны, к которым он не применяется никогда, и порядок восстановления.

## Рецепты

Готовые решения целых задач: доступ после оплаты на внешнем лендинге, синхронизация с CRM, фирменный стиль, свой отчёт по доходимости.

- [Рецепты](https://docs-school.sersidteh.ru/recipes/): Задача целиком, а не описание метода. Сейчас до конца написан один — фирменный стиль; остальные упираются в API и якоря, которых ещё нет. [написано наполовину]
- [Выдать доступ после оплаты на внешнем лендинге](https://docs-school.sersidteh.ru/recipes/access-after-external-payment/): Лендинг принимает заявку, школа заводит человека и выдаёт доступ. Закрывается виджетом — строкой скрипта на чужом сайте, а не интеграцией по API. [этого ещё нет в продукте]
- [Синхронизировать с CRM](https://docs-school.sersidteh.ru/recipes/crm-sync/): Двусторонняя связь со сторонней CRM на вебхуках: что слать, что принимать, как не задвоить. [этого ещё нет в продукте]
- [Перекрасить школу под фирменный стиль](https://docs-school.sersidteh.ru/recipes/brand-colors/): Одна строка задаёт весь цвет школы, включая тёмную тему. Плюс шрифт, скругления и плотность — и что проверить, чтобы не сломать читаемость.
- [Убрать колонку из таблицы заказов](https://docs-school.sersidteh.ru/recipes/hide-orders-column/): Задача на конкретный элемент, а не на цвет вообще: как это делается якорем. [этого ещё нет в продукте]
- [Построить свой отчёт по доходимости](https://docs-school.sersidteh.ru/recipes/completion-report/): Выгрузить прогресс по урокам и собрать свой отчёт во внешнем инструменте. [этого ещё нет в продукте]

## Для агентов

Как работать со школой из ИИ-агента: MCP-сервер, ключ с узкими правами, машинные выходы документации.

- [Для агентов](https://docs-school.sersidteh.ru/agents/): Как подключиться к школе снаружи своим ИИ-агентом: машинные выходы документации работают сегодня, MCP-сервера пока нет. Встроенный помощник школы — отдельная страница.
- [Машинные выходы](https://docs-school.sersidteh.ru/agents/machine-readable/): llms.txt, llms-full.txt, openapi.draft.json и Markdown-исходник любой страницы — что это, где лежит и чем отличается одно от другого.
- [MCP-сервер: как подключить](https://docs-school.sersidteh.ru/agents/mcp/): Сервер MCP отдаёт операции API как инструменты. Одна настройка в агенте. [этого ещё нет в продукте]
- [Что умеет MCP-сервер](https://docs-school.sersidteh.ru/agents/tools/): Перечень инструментов и то, как он соотносится с операциями API. [этого ещё нет в продукте]
- [Ключ с узкими правами](https://docs-school.sersidteh.ru/agents/keys/): Ключ для агента по умолчанию создаётся только на чтение. Права на запись выдаются явно, и на экране создания об этом написано словами. [написано наполовину]

## Обновления

Журнал изменений: что сделано и когда, новые записи сверху. Собирается из журнала разработки автоматически.

- [Обновления](https://docs-school.sersidteh.ru/changelog/): Что сделано и когда: 278 записей журнала разработки, последняя — 18 октября 2026. Раздел собирается из журнала автоматически.