Типичная история: колледж запустил СДО несколько лет назад, потом работали разные люди, каждый добавлял своё. Сейчас система работает, но обновить её страшно, никто не помнит, зачем стоит половина плагинов, а ответ на вопрос «что будет, если отключить вот этот» звучит как «не знаем». Это и есть технический долг в Moodle. Он не мешает жить сегодня и неожиданно становится проблемой при обновлении, взломе или уходе очередного исполнителя. Ниже порядок, по которому я разбираю такие системы.
Откуда берётся долг
Долг накапливается не от плохих людей, а от обстоятельств. Срочно нужно было заработать к началу семестра, поэтому взяли плагин «как есть». Автор уехал, документация осталась в чате. Новый исполнитель не стал разбираться и добавил свой код рядом. Через пять лет система состоит из слоёв, каждый из которых понятен только его автору.
Признаки, по которым я отличаю систему с долгом от здоровой:
- Версия Moodle отстаёт от поддерживаемых на несколько релизов.
- В списке плагинов есть те, у которых не заполнено или устарело поле поддерживаемой версии.
- Нет тестовой копии, все правки делаются на рабочем сайте.
- Файлы дистрибутива отличаются от чистой установки.
- Резервные копии есть, но никто не проверял восстановление.
- Доступы лежат у одного человека или у исполнителя, с которым нет связи.
Шаг 1. Инвентаризация
Без списка нельзя ничего планировать. Выпишите:
- Версию Moodle и PHP, тип базы и её версию, веб-сервер.
- Страницу «Плагины» в администрировании: она показывает все установленные плагины, источник, версию и совместимость.
- Расписание и место хранения резервных копий.
- Задачи cron: выполняются ли они, нет ли застрявших.
- Что настроено вне Moodle: интеграции, скрипты на сервере, письма, платёжные системы.
Последний пункт самый ненадёжный: интеграции часто живут отдельными скриптами в каталогах сервера, о которых никто не помнит. Ищите их по задачам планировщика сервера и по подключённым внешним службам.
Шаг 2. Классификация плагинов
Каждый сторонний плагин попадает в одну из групп. От группы зависит решение.
| Группа | Признак | Решение |
|---|---|---|
| Из официального каталога, поддерживается | Есть страница на moodle.org/plugins, свежие версии для вашей ветки | Оставить, обновлять вместе с Moodle |
| Из каталога, заброшен | Последняя версия давно, нет поддержки новых релизов | Найти замену, проверить необходимость, при нужде взять поддержку на себя |
| Написан на заказ, есть код и описание | Исходники в репозитории, понятно, что делает | Оставить, проверить совместимость, при необходимости доработать |
| Написан на заказ, документации нет | Автор недоступен, непонятно, зачем нужен | Изучить код, определить пользователей, решить: описать и поддерживать или убрать |
| Скачан с неофициального сайта | Нет карточки в каталоге, источник неясен | Проверить код на безопасность, заменить на проверенный аналог |
| Не используется | Нет данных, нет пользователей, нет связанных курсов | Удалить на тестовой копии, убедиться, что ничего не ломается, затем на рабочей |
Не ограничивайтесь «стоит или не стоит»: у каждого плагина есть данные в базе, и удаление затрагивает их. Поэтому все эксперименты проводятся на копии.
Шаг 3. Расхождения с дистрибутивом
Сравните файлы вашей установки с чистым дистрибутивом той же версии. Любое различие вне вашего местоположения для плагинов и темы — правка ядра. Я разбираю это подробнее в статье про доработку без правки ядра. Каждое найденное отличие описывается: что изменено, какую задачу решало, чем заменить.
Шаг 4. Оценка риска: таблица находок
Когда данные собраны, составьте таблицу и оценивайте каждую находку по двум осям: что случится, если ничего не делать, и сколько стоит исправление. Пример для вымышленной, но типичной системы:
| Находка | Риск | Действие |
|---|---|---|
| Версия Moodle вне поддержки | Нет исправлений безопасности, взлом | Планировать обновление через промежуточную LTS-версию |
| Плагин с неизвестным источником | Уязвимость или закладка в коде | Проверить код, заменить, сменить пароли |
| Правки ядра в нескольких файлах | Потеря функций при обновлении | Перенести в плагины до обновления |
| Нет тестовой копии | Каждое изменение рискует рабочей системой | Развернуть копию из резервной |
| Резервные копии не проверялись | Копия окажется непригодной в момент аварии | Выполнить пробное восстановление |
| Доступы у одного человека | Потеря управления системой | Передать доступы организации, завести отдельные учётные записи |
| Интеграция работает скриптом на сервере без описания | Сбой при переезде сервера | Описать, перенести в плагин или задачу cron |
Порядок работ определяется риском. Сначала то, что ведёт к потере данных и доступа: резервные копии и доступы. Потом безопасность: версия, сомнительные плагины. Потом всё, что мешает обновлению. Улучшения вроде красивой темы идут последними.
Шаг 5. Тестовая копия как основа
Все дальнейшие действия выполняются на копии, которая воспроизводит рабочую систему: те же версии PHP и базы, те же плагины, свежие данные. Я проверяю на копии каждый шаг, от удаления плагина до обновления версии, и записываю результат. Такой подход сработал при обновлении рабочей СДО центра ДПО: каждый сторонний плагин проверялся отдельно, несовместимые заменялись, а переход на новый редактор и исправление формата курса «Плитки» отрабатывались заранее.
Шаг 6. Документация и правила на будущее
Чтобы долг не накопился снова, нужны минимальные правила, которые вы закрепляете в договорах с исполнителями:
- Весь код на заказ хранится в репозитории, к которому есть доступ у организации.
- Ядро не изменяется, все исключения оформляются описанным патчем.
- Каждый плагин имеет описание: что делает, для кого, на каких версиях проверен.
- Любое изменение проходит через тестовую копию.
- Раз в год проводится проверка по списку из этой статьи.
Хорошая отправная точка для таких правил — страница технической поддержки и общая статья об аудите Moodle.
Как говорить об этом с руководством
Технический долг трудно продать руководителю: система работает, студенты учатся, а вы просите время и деньги на то, что снаружи незаметно. Помогает перевод в язык рисков и событий, которые руководитель понимает. Вместо «устаревший плагин» говорите: «если сервер выйдет из строя, колледж не сможет восстановить функцию выдачи справок, потому что код есть только на одном компьютере». Вместо «правки ядра» — «обновление безопасности нельзя установить, не потеряв собственные доработки».
Полезно приложить к разговору таблицу находок из шага 4 с тремя колонками: что случится, как вероятно, что делать. Две-три самые тяжёлые строки обычно убеждают лучше, чем длинный перечень.
Что делать с долгом постепенно
Наводить порядок можно без остановки обучения, если разбить работу на небольшие этапы, каждый из которых завершён и безопасен:
- Первый этап: безопасность и сохранность. Резервные копии, доступы, тестовая копия, проверка сомнительных плагинов.
- Второй этап: прозрачность. Описание каждого плагина и интеграции, репозиторий для собственного кода, перечень правок ядра.
- Третий этап: устранение блокировщиков обновления. Перенос правок ядра в плагины, замена заброшенных плагинов, обновление до поддерживаемой версии.
- Четвёртый этап: упрощение. Удаление лишнего, объединение дублирующих решений, настройка вместо кода там, где это возможно.
После каждого этапа система остаётся рабочей, и вы можете остановиться или продолжить. Важно не пытаться исправить всё сразу: массовая переделка одновременно создаёт новые ошибки и мешает находить их причины. Если вы хотите понять, на каком этапе находится ваша система, достаточно ответить на вопросы шага 1 и показать результат специалисту: оценка по готовому списку занимает заметно меньше времени, чем исследование с нуля.
Что не нужно делать в начале
Не удаляйте плагины и не обновляйте систему сразу, как только обнаружили проблему. Сначала резервная копия и тестовая копия, затем эксперимент. Не меняйте пароли и доступы без плана: прежние интеграции могут держаться на старых учётных записях, и внезапная смена остановит обмен данными. Не торопитесь выкладывать все выводы аудита широкой аудитории: найденные уязвимости лучше сначала закрыть. И не принимайте решение о смене платформы только из-за накопившегося долга: чаще выгоднее привести в порядок существующую систему, чем переносить все проблемы в новое место вместе с данными.
Когда звать специалиста
Инвентаризацию можно сделать самостоятельно, если у вас есть администратор с доступом к серверу. Разбор чужого кода, перенос правок в плагины и подготовку к обновлению лучше отдать программисту Moodle: он быстрее понимает, что делает неизвестный плагин и безопасно ли его удалять. Если вам нужен разбор вашей системы, опишите её на странице доработки Moodle, и я скажу, с чего начать.
Опишите задачу — расскажу, как решить её конкретно в вашем случае. Свяжитесь — разберём вместе.