ZarST
Цифровая система городского водоканала.
Простыми словами
- Что это
- Рабочая система городского водоканала: учёт абонентов и квартир, водопроводной сети, заявок и работы выездных бригад.
- Для кого
- Сотрудникам водоканала — около 220 человек в 15 отделах, от диспетчеров до бригад на выезде.
- Что это даёт
- То, что раньше было на бумаге и в разных отделах, теперь в одной системе. Бригады получают заявки в телефоне, и приложение работает даже в подвале без связи. Заявки поступают и через Telegram-ботов.
ZarST — цифровая платформа управления муниципальным водоканалом. Она объединяет предприятие, его абонентов, водопроводную сеть и полевой персонал в одной системе — с веб-, мобильными и Telegram-интерфейсами, ГИС-картами и GPS-трекингом.
Бизнес-контекст
Suv taʼminot — городской водоканал Зарафшана: ≈220 сотрудников в 15 отделах, водопроводная сеть на весь город и тысячи абонентов. До внедрения системы работа велась на бумаге, по телефону и в разрозненных файлах Excel.
Проблема
Водоканал обслуживает физическую инфраструктуру целого города, но знания о ней часто разбросаны по бумажным записям, отделам и людям в поле. Без единой системы сложно видеть сеть, координировать бригады и быстро обслуживать абонентов.
Решение
Единая ERP с консолью управления на Next.js, полевыми приложениями на React Native, которые продолжают работать без связи, Telegram-ботами и интерактивным ГИС-слоем. Активы, абоненты, сотрудники и полевые работы опираются на единый источник истины.
Что я сделал
Единственный разработчик в водоканале — архитектура, код и продакшен. Требования приходили от отделов предприятия.
Архитектура
- Структура по DDD: Domain, Application, Infrastructure, Interfaces
- Ролевая модель с 80+ правами, разделёнными по отделам и руководителям
- Offline-first синхронизация между полевым приложением и бэкендом
Backend
- API на Laravel 13 / PHP 8.4 для консоли, мобильного приложения и трёх Telegram-ботов
- Диспетчерские заявки, реестр домов и квартир, юридические абоненты, скважины, HR и склад
- Водный баланс «подано → начислено → потери» по 200 000+ строкам биллинга
Frontend и приложения
- Консоль управления на Next.js 16 с GIS-картами и GPS-мониторингом
- Полевое приложение на React Native 0.85: GPS-смены, фотоотчёты, объекты с привязкой к карте
API и интеграции
- Городская платформа заявок через API
- Обмен данными с биллинговой системой
- Терминалы Hikvision на входе через ISAPI для биометрического учёта рабочего времени
- Три Telegram-бота
База данных
- MySQL: 464 дома, 22 000 квартир, 557 юридических абонентов, 845 скважин
- Серверная пагинация, отсутствие N+1-запросов, кеширование по ETag — ключевые экраны быстрее в 3–15 раз
Безопасность
- Закрыты находки аудита безопасности: открытый файл с секретами, отсутствие авторизации на HR-эндпоинтах, токены в localStorage
- Все секреты ротированы; CSP и аутентификация через HttpOnly-cookie
- Сквозной журнал аудита и мониторинг ошибок
Выпуск и эксплуатация
- ~900 тестов бэкенда и 130+ тестов фронтенда, PHPStan как обязательная проверка
- Развёртывание в продакшене и поддержка
- Релиз в Google Play: подпись AAB, политика конфиденциальности, обоснование фоновой геолокации
Инженерный разбор: Офлайн-синхронизация полевых данных
- Полевой сотрудник начинает смену с GPS-трекингом, делает фотоотчёты и добавляет объекты на карту.
- Без связи всё остаётся в очереди на устройстве — в подвалах и колодцах ничего не теряется.
- Когда сеть появляется, приложение отправляет накопленный пакет в API синхронизации.
- Слой Interfaces аутентифицирует сотрудника и проверяет права по ролевой модели.
- Правила Domain валидируют данные; они сохраняются в MySQL и записываются в журнал аудита.
- Руководители видят бригады на карте GPS-мониторинга и в отчётах в консоли на Next.js.
Технические решения и компромиссы
- Слои DDD — Бизнес-правила живут в Domain и Application; HTTP, хранение и адаптеры остаются снаружи. (Компромисс: Кода больше, чем в обычном MVC, — но правила меняются, не затрагивая транспортный слой, и тестируются изолированно.)
- Один бэкенд, три типа клиентов — Консоль, полевое приложение и боты используют один API и одну модель прав. (Компромисс: Изменения API должны оставаться совместимыми с версиями приложения, уже установленными на телефонах.)
- Очередь на устройстве — Полевые данные сначала записываются локально и синхронизируются, когда появляется сеть. (Компромисс: Офис видит полевые данные с задержкой — зато ничего не теряется, когда бригады под землёй.)
- Сначала измерить, потом оптимизировать — Медленные экраны профилировались и исправлялись в корне: серверная пагинация, отсутствие N+1-запросов, кеширование по ETag. (Компромисс: Оптимизации добавляют ветки кода, корректность которых нужно поддерживать; их охраняют тесты и PHPStan.)
Основные модули
- Управление предприятием
- Управление абонентами
- Управление водной инфраструктурой
- Управление сотрудниками
- ГИС и интерактивные карты
- Управление полевым персоналом
- GPS-трекинг
- Мобильные приложения
- Offline-first-сценарии
- Telegram-боты
- Разработка цифрового двойника
Результаты
- ≈220 сотрудников из 15 отделов работают в одной системе
- Оцифрованы ~1000 заявок, 464 дома, 22 000 квартир и 845 колодцев
- Импортировано 200 000+ строк биллинга — водный баланс считается автоматически
- Ключевые экраны быстрее в 3–15 раз (архив заявок 328 → 44 мс)
- ~900 backend- и 130+ frontend-тестов, PHPStan как гейт
- Полевое приложение опубликовано в Google Play
- Данные на ноябрь 2026 года, из моего резюме
zarst.uz
Boburbek