Четвёртая статья из цикла об ИИ-ассистированной разработке для Битрикс24 посвящена BI-коннектору — open-source сервису, который открывает порталу доступ к внешним базам данных. Без него аналитика в Битрикс24 ограничена собственными данными платформы: сделками, клиентами, задачами. С коннектором можно подтянуть любую стороннюю БД и строить отчёты прямо в разделе «BI-конструктор».
Архитектура сервиса устроена в три слоя. Первый — установочный: класс Application.php принимает install-событие от портала, сохраняет авторизационные данные и регистрирует два коннектора — MySQL и PostgreSQL. Второй слой обрабатывает входящие HTTP-запросы: public/index.php вместе с ConnectorRequestHandler.php читают параметры action и connection_type, валидируют тело запроса и вызывают нужное действие. Третий слой — работа с базой данных: BiConnector.php управляет подключением и получением структуры таблиц, а QueryBuilder.php собирает SQL с учётом фильтров, выборки полей и лимитов и возвращает данные в JSON-формате, который ожидает портал.
Агент Codex получил задачу проанализировать репозиторий github.com/bitrix24/bi-connector и составить план работы. Он нашёл четыре основные точки входа, описал поток запроса от портала до базы данных и обозначил слабые места: отсутствие внешней доступности для локального деплоя, недостаточное покрытие тестами и отсутствие нормализации данных перед передачей в портал.
Агент Codex проанализировал репозиторий и выделил 4 точки входа: Application.php, index.php, BiConnector.php и QueryBuilder.php.
Первая задача оказалась инфраструктурной. Битрикс24 — облачный сервис, и он не может обращаться к localhost разработчика напрямую. Решение — туннель через CloudPub: после регистрации и получения токена сервис получает публичный HTTPS-адрес вида something.cloudpub.ru, который прописывается в переменную APP_DOMAIN в файле .env. Именно от этого адреса строятся все endpoint, которые портал регистрирует при установке приложения: проверка подключения, список таблиц, структура схемы, выгрузка данных. Агент самостоятельно внёс правки в конфигурацию и добавил нужные переменные окружения.
Вторая задача — безопасность и тесты. Codex усилил валидацию входных данных, добавил проверки на уровне HTTP-обработчика и написал тестовое покрытие для ключевых сценариев. Третья задача — функциональная: в проект добавили автомаппинг полей. Это означает, что данные нормализуются ещё на стороне коннектора — в портал попадают уже подготовленные, приведённые к нужному формату значения, а не сырые строки из базы.
Подход, описанный в цикле, показывает рабочую модель ИИ-ассистированной разработки: агент не просто генерирует код по запросу, а сначала изучает существующий проект, выявляет пробелы и предлагает последовательный план. Разработчик при этом формулирует задачи на естественном языке и проверяет результат. Итоговый репозиторий опубликован на GitHub по адресу github.com/igorrosliakov-bitrix24/Bitrix24-BIConnector и может служить отправной точкой для тех, кто хочет подключить собственные базы данных к аналитике Битрикс24.
