Главное о кейсе
Единая цифровая система управления строительными объектами: дефекты отмечаются прямо на интерактивных схемах помещений, назначаются виды работ и сотрудники, ведутся рабочие смены с фотофиксацией, автоматически рассчитываются прогресс объекта и потребность в материалах и инструментах.
Система полноценно работает без интернета (offline-first): сотрудник начинает и завершает смену, добавляет работы, фиксирует прогресс и фотографии — данные сохраняются на устройстве и синхронизируются после восстановления связи без потерь и дублей.
Результат: подготовка исполнительной схемы, которая раньше могла занимать несколько дней, теперь в ряде сценариев занимает около получаса. По оценке заказчика первоначальная задача проекта реализована на 100%: состояние объектов контролируется в реальном времени, объём ручной коммуникации существенно сокращён. Это действующая production-система, используемая на реальных объектах.
Как проект изменил жизнь пользователей
Раньше, чтобы понять состояние объекта, руководителю приходилось звонить сотрудникам и вручную уточнять, какие дефекты выявлены, какие работы выполнены, что осталось и какой общий прогресс. Информация собиралась из разных источников, фотографии передавались отдельно, а подготовка исполнительных схем и итоговых материалов могла занимать несколько дней.
Сейчас сотрудник открывает объект и работает непосредственно со схемой помещения: отмечает дефекты, указывает их объём, фиксирует выполнение работ и добавляет фотографии во время смены. Если на объекте нет интернета, данные сохраняются на устройстве и синхронизируются после восстановления связи.
Руководитель в это же время видит актуальное состояние объекта: общий прогресс, выполненные и оставшиеся работы, данные по сотрудникам и историю выполнения. А после завершения работ информация уже собрана в системе и используется для подготовки исполнительной документации — в ряде сценариев около получаса вместо нескольких дней.
Бизнес-задача и ее решение
Задача. Работа на строительных объектах во многом контролировалась вручную: статус объекта руководитель узнавал через звонки сотрудникам, дефекты и выполненные работы фиксировались разрозненно, подготовка исполнительных схем занимала до нескольких дней. Требовалось перенести работу с объектами в единую систему: фиксировать дефекты прямо на схемах, назначать работы, вести смены, отслеживать прогресс и сохранять результаты по мере выполнения работ.
Решение. Разработана система VLK Group, объединяющая:
— ведение объектов, помещений, схем и дефектов;
— визуальную работу с дефектами непосредственно на плане объекта;
— назначение видов работ и сотрудников;
— проведение и завершение рабочих смен;
— фиксацию объёмов выполненных работ;
— фотографии дефектов и результатов выполнения;
— offline-режим с последующей синхронизацией;
— аналитику производительности по объектам, сотрудникам, дефектам и видам работ;
— расчёт прогресса объекта;
— расчёт необходимых материалов и инструментов;
— справочники материалов, инструментов, дефектов и видов работ;
— сортировку и фильтрацию объектов и схем;
— переход из смены непосредственно к нужному дефекту на схеме;
— раздел с инструкциями по работе и установке PWA-приложения.
Крафт (мастерство), реализация, технические детали
Ключевые инженерные решения:
— Offline-first архитектура: локальное выполнение рабочих операций (начало и завершение смен, назначения сотрудников, добавление работ, фиксация прогресса, учёт материалов) с локальной базой данных на устройстве и очередью изменений. После восстановления связи зависимые операции синхронизируются в корректном порядке — с помощью временных идентификаторов и механизмов сопоставления локальных и серверных данных.
— Контроль конфликтов при синхронизации: сервер проверяет соответствие операции актуальному состоянию данных и при расхождении возвращает информацию о конфликте вместо безусловной перезаписи. Предусмотрены контроль повторного создания смен и последовательности зависимых операций — это снижает риск потери и дублирования данных.
— Интерактивный редактор схем помещений на
Konva.js: геометрические элементы, привязка, история изменений и отмена действий; связь с дефектами, работами и заметками через отдельный интеграционный слой, разделяющий геометрию и бизнес-логику.
— Автоматизированное преобразование PDF-чертежей в редактируемые схемы: извлечение графических элементов из PDF, преобразование в промежуточное представление, анализ и фильтрация геометрии, формирование структурированной модели для редактора.
— Изоляция пользовательских данных: разделение обычного кеша приложения и хранилища offline-медиа, контроль принадлежности данных пользовательской сессии, очистка при смене пользователя; сохранение и восстановление состояния приложения.
— Фоновые задачи: обработка и генерация схем из PDF, автоматическое резервное копирование схем вместе со связанными дефектами, работами и прогрессом, отправка уведомлений и служебных писем; транзакции и блокировки для согласования параллельных изменений.
Стек: Vue 3, TypeScript, Vite, Pinia, Vue Router, PWA / Service Worker, IndexedDB,
Konva.js,
Chart.js, Firebase. Backend: Python, Django, Django REST Framework, PostgreSQL, Redis, Celery, Pytest, Docker. Архитектура: REST API, модульное разделение по предметным областям, автоматические тесты ключевых областей (смены, офлайн-синхронизация, дефекты, импорт PDF, восстановление схем), часть проверок автоматизирована через GitHub Actions.
Инсайты, гипотезы, процесс создания и взаимодействия с заказчиком
Работа строилась поэтапно. Вместе с заказчиком разбирали реальные процессы на строительных объектах и переводили их в пользовательские сценарии. Для каждой крупной функции прорабатывали требования и прототипы, после чего задачи оценивались и передавались в разработку. Готовые изменения проходили тестирование сначала на тестовом стенде, затем выпускались на production.
После релизов заказчик активно использовал систему на реальных объектах и присылал обратную связь. По видео и конкретным кейсам команда воспроизводила ситуации, находила причины и дорабатывала логику.
Отдельное внимание уделяли сохранению исторических данных: если в справочнике меняются связи между типами дефектов и видами работ, изменения не должны нарушать уже выполненные работы, старые смены, фотографии и отчёты.
Самые сложные задачи проекта: совместить сложный интерфейс со схемами и дефектами с offline-режимом (работа без связи с корректной последующей синхронизацией без потерь и дублей) и корректно учитывать в прогрессе, аналитике и истории связь между дефектом и работами — один дефект может включать несколько видов работ, выполняемых разными сотрудниками.
Прочая информация о кейсе
Это действующая production-система, которой заказчик пользуется на реальных объектах. Основной функционал по объектам, схемам, дефектам, сменам, прогрессу, фотографиям, расчётам и аналитике реализован и продолжает развиваться; команда регулярно выпускает небольшие улучшения по обратной связи пользователей.
По оценке заказчика первоначальная задача проекта реализована на 100%: система позволяет контролировать состояние объектов в реальном времени и существенно уменьшает объём ручной коммуникации.
Следующий этап развития — единый медиаархив фотографий и видео с возможностью предоставлять заказчикам и подрядчикам доступ к материалам конкретного объекта по публичной ссылке, а также дальнейшая автоматизация процессов.
Текущая доступность работы
Действующая production-система: используется заказчиком на реальных строительных объектах, команда регулярно выпускает улучшения по обратной связи пользователей.