PuzzleRoster в научно-образовательном центре
Контекст и проблема
После начала работы в научно-образовательном центре физики и химии я обнаружил, что организация работает на тяжёлой системе, построенной на базе Excel. Она постоянно падала, зависала под нагрузкой и делала ежедневные операционные изменения крайне болезненными и подверженными ошибкам.
Масштаб операционной нагрузки:Именно поэтому я решил создать систему, которая позволила бы сделать управление расписанием и ресурсами более надёжным и предсказуемым. В свободное от основной работы время я разработал собственную систему PuzzleRoster, а в середине августа, перед началом нового учебного года, бесплатно развернул и настроил отдельную копию системы для учебного центра, чтобы упростить ежедневную работу коллег.
Опыт работы с реляционными базами данных сформировал основной архитектурный принцип проекта: изменения расписания и ресурсов должны обрабатываться как транзакции, а не как простое редактирование таблиц.
Контроль целостности был вынесен на уровень СУБД, история изменений сделана неизменяемой через Audit Log, а архитектура позволяет безопасно восстановить состояние расписания на конкретный день.
Моя роль
- Архитектура системы и базы данныхразработал мультисхемную архитектуру БД, ролевую модель доступа, гибкую логику разрешения конфликтов (замена учителя, перенос урока в другой кабинет), развёртывание годового расписания из недельного шаблона с автоматическим подбором кабинетов по заданным правилам, вынес все ключевые бизнес-инварианты на уровень БД (интервалы GiST, предотвращающие двойное бронирование), транзакционные снапшоты сессий редактирования и очереди событий.
- Интеграция каталога оборудованияинтегрировал интерактивный каталог оборудования, благодаря чему заказ учителя прослеживается через всю систему на каждом этапе обработки (dashboard учителя, dashboard лаборанта, на панели администратора и в письмах-уведомлениях).
- UX и дизайн интерфейсаспроектировал простой, интуитивно понятный пользовательский интерфейс.
- Табло в реальном времениспроектировал табло для учеников и для учителей (табло учителей показывает дополнительную служебную информацию).
- Развёртывание и эксплуатацияконтейнеризация в Docker, Nginx, деплой AWS EC2 + Cloudflare Tunnel, автоматические бэкапы в S3, транзакционный pipeline отправки писем через Resend (с возможностью динамического изменения бизнес-правил через админ-панель).
- Disaster Recoveryразработал и протестировал схему восстановления после полного краха системы (крах был смоделирован по следующей схеме: полностью снёс инстанс, создал новый (обновил систему, установил необходимые компоненты), деплой новой копии из GitHub + накатывание последнего backup базы). По результатам была написана пошаговая инструкция восстановления системы.
Обзор системы
ERP-система управления расписанием и операционной деятельностью:
- Годовой шаблон + генерируемое годовое расписание
- Редактирование расписания на уровне дня с freeze / unfreeze / rollback
- Замены учителей
- Отмены и переносы уроков
- Создание новых уроков и дополнительных занятий
- Процесс заказа лабораторного оборудования
- Очередь заявок (принцип «одного окна»)
- Email-уведомления по всем ключевым событиям — изменения расписания, смена кабинета, назначение замены учителя, отмена урока, заказы оборудования, одобрение заявок, а также служебные уведомления для админов
- Гранулярный ролевой доступ
- Коридорные ТВ-табло для учителей и учеников
- Полностью неизменяемый audit log
Технологический стек:
- PostgreSQL — выбран ради нативной поддержки EXCLUDE USING GIST. Это позволяет на уровне движка СУБД обеспечить отсутствие пересечений временных интервалов и автоматически исключать race conditions при параллельных запросах.
- Логика в БД — перенос инвариантов в СУБД обеспечил единый источник правды и целостность данных независимо от точки подключения (API, фоновые скрипты или прямые админ-сессии).
- Node.js + Express — тонкий stateless-шлюз (Thin API Gateway), ограниченный задачами авторизации и транзита запросов без дублирования бизнес-логики.
- Vue 3 + PrimeVue — сократил time-to-market за счёт готовой экосистемы сложных UI-компонентов для административных экранов.
- Cloudflare Tunnel — изолировал инфраструктуру по принципу Zero Trust, полностью исключив необходимость публикации публичного IP и открытия входящих портов.
Структура проекта:
Система в реальной жизни:
Интерфейс системы
Нажмите на любой скриншот, чтобы открыть его в полном размере.
Инженерная культура — код и документация
Один из ключевых принципов проекта: логика и решения объясняются прямо в коде — не только что делает функция, но и зачем она нужна и что сломается, если нарушить инвариант.
1. Чёткое разделение структуры и бизнес-логики
2. Подбор кабинетов с явными бизнес-правилами
3. Контроль качества и проверка инвариантов
391 автоматизированная регрессионная проверка (уровни API и БД) перед каждым деплоем — покрывает цепочки согласования заявок, замены учителей, заморозку/откат дня, предотвращение конфликтов расписания (EXCLUDE USING GIST), заказы оборудования и матрицу правил рассылки.
4. Эксплуатационная дисциплина релизов
Каждый из ~20 релизов на прод за 9 месяцев проходит по одному и тому же протоколу: репетиция
миграции на свежей копии прод-базы, Docker-образы с тегом :rollback перед
пересборкой, бэкап непосредственно перед накатом и письменный журнал деплоя на сервере.
Реальное окно переключения контейнеров — от 13 до 55 секунд.
План восстановления после полного отказа проверен не на бумаге: полный цикл (снос volume → чистая инициализация с нуля → восстановление реального prod-дампа во временную базу) прогнан целиком, а ключевые таблицы (сотрудники, уроки, заявки, права) сверены с живой БД построчно.
5. Внедрение и управление изменениями
Чтобы переход с устаревшего Excel прошёл гладко, я выстроил постепенную стратегию внедрения:
- Раннее вовлечение и демонстрации. На этапе разработки я регулярно показывал коллегам работающие прототипы, объясняя на конкретных примерах, как система избавит их от ежедневной рутины и путаницы. Начальное безразличие быстро сменилось искренним ожиданием релиза.
- Плавная адаптация за 2 недели до старта. Я внимательно наблюдал за реакцией сотрудников и оценивал их открытость к изменениям. Когда я увидел, что большинство настроено позитивно, я пришёл к директору с предложением: не усложнять переход лишней параллельной работой в двух системах, так как двойной ввод только нервировал бы коллектив. Система объективно получилась намного проще и удобнее прежней, поэтому я предложил начинать учебный год сразу на ней, и директор согласился. Чтобы команда успела освоиться, в середине августа всем сотрудникам был открыт доступ в «песочницу», где каждый мог спокойно покликать интерфейс и изучить свои кабинеты. Одновременно новая сетка расписания была выведена на все коридорные экраны центра — за две недели до 1 сентября, чтобы коллектив визуально свыкся с новым форматом.
- Практическое обучение. Было проведено несколько раундов практического обучения для преподавателей и лаборантов: как устроен личный кабинет, как в пару кликов заказать оборудование в лабораторию, запросить перенос урока и отслеживать статус своей заявки в реальном времени.
- Уважение к привычкам и бумажным заметкам. Я учёл, что части лаборантов и преподавателей привычнее работать с листом в руках — отмечать карандашом подготовленные опыты, делать пометки на полях. Этот функционал (отметка готовности оборудования, комментарии к уроку) заложен и в самой системе — кто-то вносит это прямо в интерфейс, а кто-то сначала на бумаге, а потом переносит в систему. Поэтому я предусмотрел возможность выгрузки в Excel для последующей печати отображаемой на экране информации.
- Результат. Благодаря интуитивному интерфейсу даже самая консервативная часть коллектива освоила систему практически без вопросов. Уже к концу сентября (первый месяц учебного года) система полностью и бесшовно влилась во все ежедневные рабочие процессы научного центра.
Результаты
- Система успешно работает в продакшене с сентября 2026
- Выдерживает реальную ежедневную операционную нагрузку центра
- Критические инварианты (конфликты расписания, права доступа, аудит) обеспечиваются на уровне базы данных
- Полная неизменяемая история всех значимых действий
- В системе ежедневно работают ~50 сотрудников