Как мы продолжили развитие сложной edtech-платформы без документации

Клиент:

Портал профессионального образования

Доработка и развитие образовательного портала.
Как мы продолжили развитие сложной edtech-платформы без документации

Введение

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

Мы помогли заказчику оперативно восстановить контроль над системой, наладить выпуск новых версий и обеспечить техническую устойчивость проекта, не начиная всё «с нуля».

Описание системы

Проект представляет собой масштабную edtech-платформу с широким функционалом:

  • управление курсами, видеоуроками и лекциями;
  • онлайн-экзамены и тестирования;
  • личные кабинеты студентов и преподавателей;
  • управление учебными группами, расписанием и ролевыми правами;
  • аналитика успеваемости и активности.

Архитектура построена по микросервисной модели:

  • 17 микросервисов на Laravel, взаимодействующих через REST API;
  • клиентская часть — Nuxt.js с SSR для высокой скорости и SEO-дружественности;
  • под каждый тип пользователя — кастомизированный интерфейс;
  • нагрузка до 600 RPS в пиковые часы;
  • 20 000+ активных пользователей;
  • интеграции с внешними сервисами видео и авторизации.
Инфографика архитектуры EdTech-платформы (на русском): греческий храм с шестью колоннами и функциями

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

Проблема: Полное отсутствие документации

Что было

Система работала, но была непрозрачна: десятки микросервисов, отсутствие схем и описаний, ноль документации. В архитектуре использовались нестандартные решения, а получить консультации от предыдущих разработчиков было невозможно.

Что сделали

  • Развернули проект в тестовой среде и провели аудит всех микросервисов;
  • Составили карту внутренних взаимодействий и API-вызовов;
  • Собрали внутреннюю документацию по логике работы ключевых сервисов;
  • Согласовали техническое описание с QA и DevOps-командами клиента;
  • Оценили узкие места и потенциальные риски в архитектуре.

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

Проблема: Работа с нестандартным Data Mapper

Что было

Проект не использовал привычный Eloquent. В основе — индивидуально разработанный Data Mapper, не основанный на общих библиотеках (Doctrine, Laravel DataMapper и др.). Кодовая база была сложной, без тестов и документации.

Что сделали

Менять реализацию ORM было бы слишком рискованно и затратно. Вместо этого команда сосредоточилась на изучении её работы путём практических экспериментов и поэтапного анализа:

  • разобрали реализацию Data Mapper вручную, через тестовые сценарии и попытки реконструкции логики;
  • создали справочные материалы для внутренних разработчиков;
  • обучили команду работе с Data Mapper через примеры, внутренние гайды и ревью;
  • сформировали набор рабочих паттернов, чтобы унифицировать подход к разработке в рамках существующего решения.

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

Результаты

Вошли в проект без онбординга и уже на второй день начали вносить первые изменения в кодовую базу;
Создали карту микросервисной архитектуры и API-взаимодействий;
Закрыли 14 фич и улучшений за первые 2 недели;
Сократили средний цикл задач с 2–3 дней до 6–8 часов;
Обеспечили команду внутренними материалами и паттернами работы с нестандартным Data Mapper;
Устранили риски, связанные с потерей знаний и техническим «долгом» прошлого подрядчика.

Заключение

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

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

Портфолио

Другие проекты

VPUT VPUT Как мы создали сервис аренды жилья в Болгарии и привели его к 1500 бронированиям за сезон.... Stooller Stooller Переезды без звонков: как мы создали сервис, который сам считает цену, собирает заявки и п... Trade Bot Trade Bot +100 сделок в минуту. В 20 раз быстрее трейдера. Полный контроль в Telegram. Wineship Wineship Сайт для винного бренда с умным фильтром, SEO-структурой и легким выбором среди 2000+ вин BeFamily BeFamily +50% к продажам. Дизайн по законам природы. Сайт в 2 раза быстрее. Ansy Ansy Работаем с клиентом 10+ лет. +300% к скорости загрузки. Примерка ковра онлайн. RiseX RiseX Как мы вывели криптобиржу на рынок: автоматическое обновление цен, безопасные P2P сделки и... BolgarskiyDom BolgarskiyDom Как риелторский сайт в Болгарии вышел из-под фильтров, увеличил органический трафик в 5 ра... Neweurofences Neweurofences Как интернет-магазин заборов увеличил видимость в поиске на 25% и улучшил конверсии с помо... Tetri’s Smile Tetri’s Smile Стоматологический бутик, предоставляющий VIP-услуги в Майами: увеличение ROI в 3 раза и ро... SoleaWellness SoleaWellness Салон в Майами. Перенос сайта на WordPress, SEO и маркетинг. Результат: ТОП-5, рост трафик... Solea Beauty Salon Solea Beauty Salon Как салон в Майами увеличил заявки в 3 раза и органический трафик на 250%. От 0 до 180+ за... Интернет-магазин очков Интернет-магазин очков Интернет-магазин оптики. Разработка сайта, SEO-оптимизация, маркетинг и интеграции. С 0 до... Кейс продвижения и разработки Svetlanadental Кейс продвижения и разработки Svetlanadental Svetlanadental – кейс продвижения и разработки сайта стоматологического кабинета в США. Кл... Кейс продвижения и разработки Холистик стоматологии Кейс продвижения и разработки Холистик стоматологии Advanced Dental Wellness Center – стоматология в Майами, Форт Лодердейл. Холистик стоматол... Кейс продвижения и разработки MyMoneyArt Кейс продвижения и разработки MyMoneyArt Перенос сайта MyMoneyArt на WordPress, SEO, UX-улучшения: +500% трафика, заявки ×6. Кейc продвижения и разработки Biomilk.ru Кейc продвижения и разработки Biomilk.ru Biomilk – дистрибьютор продуктов питания в Москве и регионах. +100% органического трафика... Sutton Advanced Cosmetic Dentistry Sutton Advanced Cosmetic Dentistry Продвижение VIP стоматологии на Манхэттене C 13 до 80 запросов в ТОП-10 Google за полгода Кейс продвижения маркетингового агентства Mates China Кейс продвижения маркетингового агентства Mates China Mates China – агентство digital-маркетинга, которое помогает продвигать бизнес в Китае чер... VPUT VPUT Как мы создали сервис аренды жилья в Болгарии и привели его к 1500 бронированиям за сезон.... Stooler Stooler Онлайн-сервис с автоматическим расчетом и +40% заказов сразу после запуска SoleaDentalSpa SoleaDentalSpa Стоматологическая клиника в городе Sunny Isles Beach - увеличили количество заявок в 3 раз...
Webdelo SEO Webdelo SEO Подробно о нашем SEO-подходе: от аналитики и аудита до контента, ссылок и рекламы. Узнайте... Кейс разработки магазина красок Nevapallete.cn Кейс разработки магазина красок Nevapallete.cn Разработали сайт художественных красок Nevapallete.cn для китайского рынка: хостинг в Гонк... WineShip WineShip Каталог вин с 2000+ бутылками, гибкими фильтрами и системой подбора по объёму и году. Удоб... Как мы продвигали салон красоты в Jacksonville, Florida Как мы продвигали салон красоты в Jacksonville, Florida Продвижение салона красоты Annazur во Флориде: увеличение трафика, локальное ранжирование,... Кейс сайта стоматологии Новая орбита Кейс сайта стоматологии Новая орбита SEO-кейс стоматологии: +50-80 целевых звонков/мес, топ по запросам, рост трафика с февраля... Berger 3D Design Berger 3D Design Сайт-визитка с каталогом WordPress для немецкого производителя B2B-системы хранения измери... SoleaBrickellSpa SoleaBrickellSpa Вы хотите, чтобы ваш сайт не просто существовал, а приносил реальных клиентов? Мы знаем, к... KidsJumpTech KidsJumpTech От сайта на грани коллапса до 40 заявок за выходные Alanta Clinic Alanta Clinic Как стоматология с одностраничным сайтом удвоила число пациентов из своего района Оптимизация автоматического подбора объявлений Оптимизация автоматического подбора объявлений Как мы избавили систему от лишней нагрузки и повысили надёжность операций Поиск по русскоязычным синонимам брендов Поиск по русскоязычным синонимам брендов Как мы ускорили выдачу и снизили нагрузку на систему поиска по сайту Webdelo для стоматологических клиник Webdelo для стоматологических клиник Digital-маркетинг для стоматологий: SEO, Google Maps и таргетированная реклама. Более 15 л... Webdelo Недвижимость Webdelo Недвижимость 10 лет в нише, 7 крупных проектов в РФ и Европе. Комплексное SEO: от архитектуры каталога... Оптимизация системы бронирований прыжков с парашютом Оптимизация системы бронирований прыжков с парашютом Как мы перевели 5 площадок из Excel в единую систему Редизайн и переезд интернет-магазина стоматологических материалов Редизайн и переезд интернет-магазина стоматологических материалов Мы обновили интернет-магазин стоматологических материалов, создав быструю платформу с точн... Оптимизация SQL-нагрузки Оптимизация SQL-нагрузки Сократили количество запросов с 16 685 до 24 за 1.5 часа Настроили сервис подбора объявлений – сэкономили 72% времени на изменения Настроили сервис подбора объявлений – сэкономили 72% времени на изменения Оптимизация автоматического подбора объявлений. Webdelo Dev Webdelo Dev Полный цикл разработки: от детального техплана и API-архитектуры до запуска и поддержки. П... Bonadomus Bonadomus BONADOMUS — это цифровая платформа для рынка недвижимости Дубая, разработанная с нуля как... Lackmann GmbH Lackmann GmbH Разработка мультиязычного лендинга для франшизы Lackmann Fleisch- und Feinkostfabrik GmbH... MRFIXUS (США) MRFIXUS (США) Спроектировали mobile-first интерфейс для работы с экстренными вызовами в Индианаполисе. П... Внутренняя ERP для управления командой Внутренняя ERP для управления командой Для компании на тридцать человек внутренняя ERP возвращает HR и бухгалтерии два-четыре пол...
cookies Мы используем Cookie

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

Необходимые (обязательные)

Обеспечивают работу сайта (навигация, доступ к защищённым разделам). Всегда включены и могут быть изменены только в настройках браузера.

Аналитические

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

Маркетинговые / Рекламные

Используются для показа персонализированной рекламы и измерения эффективности рекламных кампаний.

На этом сайте мы дополнительно используем пиксель OpenAI для ChatGPT Ads. Он сохраняет в браузере идентификатор __oppref. При отправке заявки ваш e-mail и номер телефона могут быть переданы в OpenAI в США в хешированном виде, чтобы связать заявку с рекламой, по которой вы перешли. В читаемом виде они не передаются.