Архитектура монорепозитория для VK Mini Apps: от хаоса к управляемости

Особенно, если речь идёт о нескольких мини-приложениях, общей аналитике, авторизации и серверной логике. Решение? Монорепозиторий.

В этой статье мы, как команда, разрабатывающая VK Mini Apps, делимся практическим подходом к построению архитектуры монорепы. Все примеры и инструменты — исключительно на российских и self-hosted решениях.

📦 Что такое монорепа и зачем она нужна

Монорепозиторий (или просто «монорепа») — это структура, в которой всё находится в одном репозитории:

1. frontend-клиенты;
2. backend-сервисы;
3. библиотеки, утилиты и bridge-обёртки;
4. UI-компоненты;
5. документация и DevOps-скрипты.

Такой подход позволяет синхронизировать разработку, обновлять зависимости централизованно и упростить CI/CD. Особенно это важно в VK Mini Apps, где часто создаются разные приложения (например, пользовательский интерфейс, партнёрский доступ, админка) с едиными бизнес-правилами и логикой.

🧰 Пример структуры монорепы для VK Mini Apps

/miniapp-monorepo

├── apps

│ ├── user-client # основное мини-приложение

│ ├── partner-client # интерфейс для партнёров

│ └── admin-panel # админка для модераторов

├── packages

│ ├── shared-ui # кнопки, темы, модалки

│ ├── vk-bridge-kit # обёртки для VK Bridge

│ ├── auth-core # логика авторизации

│ ├── analytics-kit # клиентская аналитика

│ └── i18n # локализация

├── backend

│ ├── auth-service

│ ├── core-api

│ └── notification-worker

├── scripts

│ ├── build

│ └── deploy

├── .gitlab-ci.yml

└── README.md

🇷🇺 Инструменты, которые мы используем

Поскольку мы придерживаемся политики полной независимости от западных сервисов, в нашем стек входят только российские и self-hosted решения:

1. Turborepo или NX — управление зависимостями и кэширование сборок.
2. pnpm — быстрый и компактный пакетный менеджер.
3. GitLab Community Edition — CI/CD сервер, хостится в РФ.
4. Yandex Cloud — хостинг, контейнеры, базы данных.
5. VK Cloud — для обработки событий, авторизации и масштабируемых функций.
6. ClickHouse — быстрая аналитика и логирование.
7. PostgreSQL — основная база данных для всех сервисов.

🔄 Преимущества монорепозитория

1. Централизация кода Все компоненты доступны из одного места. Вы меняете интерфейс кнопки в shared-ui — и она обновляется в трёх приложениях одновременно.
2. Ускорение разработки Новый мини-апп запускается за день: копируете шаблон, подключаете общие пакеты, и готово.
3. Масштабируемость команды Новые разработчики быстро включаются в работу — единый кодстайл, общий линтинг, одна среда.
4. Автоматизация CI/CD Один .gitlab-ci.yml, разделённый на шаги. Изменили только analytics-kit? Собирается только то, что от него зависит.
5. Аналитика и логика в одном стиле Вынос аналитики в отдельный пакет даёт предсказуемость, чистоту и независимость от конкретного проекта.

📊 Что даёт бизнесу

1. Быстрые релизы. Новые функции доступны сразу во всех приложениях.
2. Устойчивость. Меньше багов за счёт переиспользуемых компонентов.
3. Прозрачность. Единая история, аналитика и документация.
4. Снижение затрат. Меньше ресурсов уходит на поддержку и обновление.
5. Безопасность. Всё на российских платформах, с полной изоляцией.

🔚 Заключение

Монорепа — это не просто технический выбор. Это решение, которое влияет на скорость, стабильность и будущее продукта. В контексте VK Mini Apps, где важна скорость разработки, консистентность интерфейсов и жёсткие ограничения по размеру — монорепа даёт предсказуемость и гибкость.

Наша команда внедряет архитектуру монорепозитория в каждом серьёзном проекте внутри VK. Это позволяет нам быстрее развёртывать новые мини-приложения, оперативно масштабировать команду и обеспечивать высокое качество продукта с первого дня.