Перейти к содержимому
M
Все статьи
Практика 8 мин чтения

Технический долг в Moodle: как разгрести СДО после нескольких подрядчиков

План аудита СДО, которую много лет делали разные подрядчики: что проверять, как оценивать риск каждой находки и в каком порядке наводить порядок в Moodle.

План аудита СДО, которую много лет делали разные подрядчики: что проверять, как оценивать риск каждой находки и в каком порядке наводить порядок в Moodle.

Типичная история: колледж запустил СДО несколько лет назад, потом работали разные люди, каждый добавлял своё. Сейчас система работает, но обновить её страшно, никто не помнит, зачем стоит половина плагинов, а ответ на вопрос «что будет, если отключить вот этот» звучит как «не знаем». Это и есть технический долг в Moodle. Он не мешает жить сегодня и неожиданно становится проблемой при обновлении, взломе или уходе очередного исполнителя. Ниже порядок, по которому я разбираю такие системы.

Откуда берётся долг

Долг накапливается не от плохих людей, а от обстоятельств. Срочно нужно было заработать к началу семестра, поэтому взяли плагин «как есть». Автор уехал, документация осталась в чате. Новый исполнитель не стал разбираться и добавил свой код рядом. Через пять лет система состоит из слоёв, каждый из которых понятен только его автору.

Признаки, по которым я отличаю систему с долгом от здоровой:

  • Версия Moodle отстаёт от поддерживаемых на несколько релизов.
  • В списке плагинов есть те, у которых не заполнено или устарело поле поддерживаемой версии.
  • Нет тестовой копии, все правки делаются на рабочем сайте.
  • Файлы дистрибутива отличаются от чистой установки.
  • Резервные копии есть, но никто не проверял восстановление.
  • Доступы лежат у одного человека или у исполнителя, с которым нет связи.

Шаг 1. Инвентаризация

Без списка нельзя ничего планировать. Выпишите:

  1. Версию Moodle и PHP, тип базы и её версию, веб-сервер.
  2. Страницу «Плагины» в администрировании: она показывает все установленные плагины, источник, версию и совместимость.
  3. Расписание и место хранения резервных копий.
  4. Задачи cron: выполняются ли они, нет ли застрявших.
  5. Что настроено вне Moodle: интеграции, скрипты на сервере, письма, платёжные системы.

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

Шаг 2. Классификация плагинов

Каждый сторонний плагин попадает в одну из групп. От группы зависит решение.

ГруппаПризнакРешение
Из официального каталога, поддерживаетсяЕсть страница на moodle.org/plugins, свежие версии для вашей веткиОставить, обновлять вместе с Moodle
Из каталога, заброшенПоследняя версия давно, нет поддержки новых релизовНайти замену, проверить необходимость, при нужде взять поддержку на себя
Написан на заказ, есть код и описаниеИсходники в репозитории, понятно, что делаетОставить, проверить совместимость, при необходимости доработать
Написан на заказ, документации нетАвтор недоступен, непонятно, зачем нуженИзучить код, определить пользователей, решить: описать и поддерживать или убрать
Скачан с неофициального сайтаНет карточки в каталоге, источник неясенПроверить код на безопасность, заменить на проверенный аналог
Не используетсяНет данных, нет пользователей, нет связанных курсовУдалить на тестовой копии, убедиться, что ничего не ломается, затем на рабочей

Не ограничивайтесь «стоит или не стоит»: у каждого плагина есть данные в базе, и удаление затрагивает их. Поэтому все эксперименты проводятся на копии.

Шаг 3. Расхождения с дистрибутивом

Сравните файлы вашей установки с чистым дистрибутивом той же версии. Любое различие вне вашего местоположения для плагинов и темы — правка ядра. Я разбираю это подробнее в статье про доработку без правки ядра. Каждое найденное отличие описывается: что изменено, какую задачу решало, чем заменить.

Шаг 4. Оценка риска: таблица находок

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

НаходкаРискДействие
Версия Moodle вне поддержкиНет исправлений безопасности, взломПланировать обновление через промежуточную LTS-версию
Плагин с неизвестным источникомУязвимость или закладка в кодеПроверить код, заменить, сменить пароли
Правки ядра в нескольких файлахПотеря функций при обновленииПеренести в плагины до обновления
Нет тестовой копииКаждое изменение рискует рабочей системойРазвернуть копию из резервной
Резервные копии не проверялисьКопия окажется непригодной в момент аварииВыполнить пробное восстановление
Доступы у одного человекаПотеря управления системойПередать доступы организации, завести отдельные учётные записи
Интеграция работает скриптом на сервере без описанияСбой при переезде сервераОписать, перенести в плагин или задачу cron

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

Шаг 5. Тестовая копия как основа

Все дальнейшие действия выполняются на копии, которая воспроизводит рабочую систему: те же версии PHP и базы, те же плагины, свежие данные. Я проверяю на копии каждый шаг, от удаления плагина до обновления версии, и записываю результат. Такой подход сработал при обновлении рабочей СДО центра ДПО: каждый сторонний плагин проверялся отдельно, несовместимые заменялись, а переход на новый редактор и исправление формата курса «Плитки» отрабатывались заранее.

Шаг 6. Документация и правила на будущее

Чтобы долг не накопился снова, нужны минимальные правила, которые вы закрепляете в договорах с исполнителями:

  • Весь код на заказ хранится в репозитории, к которому есть доступ у организации.
  • Ядро не изменяется, все исключения оформляются описанным патчем.
  • Каждый плагин имеет описание: что делает, для кого, на каких версиях проверен.
  • Любое изменение проходит через тестовую копию.
  • Раз в год проводится проверка по списку из этой статьи.

Хорошая отправная точка для таких правил — страница технической поддержки и общая статья об аудите Moodle.

Как говорить об этом с руководством

Технический долг трудно продать руководителю: система работает, студенты учатся, а вы просите время и деньги на то, что снаружи незаметно. Помогает перевод в язык рисков и событий, которые руководитель понимает. Вместо «устаревший плагин» говорите: «если сервер выйдет из строя, колледж не сможет восстановить функцию выдачи справок, потому что код есть только на одном компьютере». Вместо «правки ядра» — «обновление безопасности нельзя установить, не потеряв собственные доработки».

Полезно приложить к разговору таблицу находок из шага 4 с тремя колонками: что случится, как вероятно, что делать. Две-три самые тяжёлые строки обычно убеждают лучше, чем длинный перечень.

Что делать с долгом постепенно

Наводить порядок можно без остановки обучения, если разбить работу на небольшие этапы, каждый из которых завершён и безопасен:

  1. Первый этап: безопасность и сохранность. Резервные копии, доступы, тестовая копия, проверка сомнительных плагинов.
  2. Второй этап: прозрачность. Описание каждого плагина и интеграции, репозиторий для собственного кода, перечень правок ядра.
  3. Третий этап: устранение блокировщиков обновления. Перенос правок ядра в плагины, замена заброшенных плагинов, обновление до поддерживаемой версии.
  4. Четвёртый этап: упрощение. Удаление лишнего, объединение дублирующих решений, настройка вместо кода там, где это возможно.

После каждого этапа система остаётся рабочей, и вы можете остановиться или продолжить. Важно не пытаться исправить всё сразу: массовая переделка одновременно создаёт новые ошибки и мешает находить их причины. Если вы хотите понять, на каком этапе находится ваша система, достаточно ответить на вопросы шага 1 и показать результат специалисту: оценка по готовому списку занимает заметно меньше времени, чем исследование с нуля.

Что не нужно делать в начале

Не удаляйте плагины и не обновляйте систему сразу, как только обнаружили проблему. Сначала резервная копия и тестовая копия, затем эксперимент. Не меняйте пароли и доступы без плана: прежние интеграции могут держаться на старых учётных записях, и внезапная смена остановит обмен данными. Не торопитесь выкладывать все выводы аудита широкой аудитории: найденные уязвимости лучше сначала закрыть. И не принимайте решение о смене платформы только из-за накопившегося долга: чаще выгоднее привести в порядок существующую систему, чем переносить все проблемы в новое место вместе с данными.

Когда звать специалиста

Инвентаризацию можно сделать самостоятельно, если у вас есть администратор с доступом к серверу. Разбор чужого кода, перенос правок в плагины и подготовку к обновлению лучше отдать программисту Moodle: он быстрее понимает, что делает неизвестный плагин и безопасно ли его удалять. Если вам нужен разбор вашей системы, опишите её на странице доработки Moodle, и я скажу, с чего начать.

Нужна помощь с Moodle?

Опишите задачу — расскажу, как решить её конкретно в вашем случае. Свяжитесь — разберём вместе.