Паспорт проекта · ПП-02/2026Передаточный документ

· База Воронок

Платформа аналитики продаж недвижимости: собирает лиды, сделки и переходы по стадиям из Битрикс24, приводит разные воронки к единой модели и раздаёт результат в дашборды, Google-таблицы и Telegram — по каждому жилому комплексу.

Платформа
«База Воронок»
Статус
Промышленная эксплуатация
Дата паспорта
12 июля 2026
Подключено
3 застройщика (Природа, Аура, ГорСтрой)
Стек
Python / FastAPI · Supabase (PostgreSQL) · Docker
Витрины
Дашборд · Google Sheets · Telegram · Metabase
01

Назначение

У каждого застройщика в Битрикс24 своя реальность: свои воронки, свои названия стадий, свои поля и правила. У «Природы» — 82 стадии в шести воронках; у «Ауры» — агентские продажи, минующие лидов; у каждого — собственные определения MQL, SQL и выручки.

«База Воронок» превращает этот разнобой в единую аналитическую модель. Данные стекаются в общее хранилище в момент изменения сделки, приводятся к каноническим стадиям воронки — и дальше любая витрина, от дашборда до Telegram-отчёта, работает с одной правдой, одинаково устроенной для всех клиентов.

Ключевой принцип: подключение нового застройщика — это конфигурация, а не разработка. Маппинг стадий, определения метрик, каналы продаж и исключения задаются настройками клиента, ядро остаётся общим.
02

Возможности

Сбор

Данные в реальном времени

Роботы Битрикс24 присылают изменения сделок и лидов за секунды; ежечасная фоновая сверка подбирает всё, что могло потеряться. Даты переходов по стадиям берутся из истории CRM — настоящие, а не время обработки.

Модель

Каноническая воронка

Десятки разнородных стадий каждого клиента отображаются в единый набор канонических: обращение, MQL, SQL, встреча, бронь, оформление, договор, выручка. Сравнимость между проектами и готовые формулы конверсий.

Модель

Настройки клиента

Правила каждого застройщика — в его конфигурации: как определять проект, что считать MQL и SQL, какие воронки исключить, как делить продажи на собственные и агентские, что входит в выручку.

Витрины

Двусторонний обмен с Google Sheets

Планы читаются из привычной таблицы клиента; факт ежедневно записывается в неё же — по менеджерам и каналам, не задевая формулы. Таблица остаётся живым рабочим документом клиента.

Витрины

Дашборд и Telegram

Веб-дашборд план/факт по дням, каналам и менеджерам. Telegram-боты присылают визуальные карточки-отчёты и алерты мониторинга. Metabase — для произвольных срезов аналитиком.

Надёжность

Справочники и наблюдаемость

Менеджеры, стадии и статусы синхронизируются из CRM автоматически. Каждая операция фиксируется в журнале событий; каждое архитектурное решение задокументировано с обоснованием.

03

Архитектура

Битрикс24CRM клиента: лиды, сделки, история стадий
Коннекторприём вебхуков, часовая сверка, справочники
База ВоронокPostgreSQL: изолированная база на клиента, каноническая модель, 20+ витрин-представлений
Дашбордплан/факт онлайн
Google Sheetsплан ↔ факт ежедневно
Telegramотчёты и алерты
Metabaseсвободная аналитика

Каждый клиент живёт в изолированной базе со своими ролями доступа — данные застройщиков не пересекаются. Ядро (модель, представления, миграции) едино: улучшение для одного клиента становится доступно всем.

04

Состав системы

КомпонентРольСтатус
КоннекторПриём вебхуков Битрикс24, часовой сбор, синхронизация справочников (менеджеры, стадии, статусы лидов)работает
ХранилищеSupabase / PostgreSQL: базы клиентов, каноническая модель, REST-доступ, edge-функцииработает
Sheets-синкЧтение планов и запись факта в таблицы клиентов, Telegram-алерты об ошибкахработает
ДашбордВеб-интерфейс план/факт по каждому ЖКработает
Telegram-ботыЕжедневные визуальные отчёты, мониторинг каждые 30 минутработает
ОнбордингСкрипт развёртывания клиента, анкеты интегратору, runbook подключения к Sheets-режимуготов
05

Ключевые цифры

3застройщика в промышленной эксплуатации
82 → 11стадий CRM сведены к каноническим ключам воронки
±1точность сверки с ручными отчётами клиента (посделочная выверка)
0регрессий у действующих клиентов при 28+ миграциях ядра

Формулы метрик выверены с клиентами эмпирически — до совпадения с их собственными отчётами: обращения, MQL, SQL, брони, договоры и выручка сходятся строка в строку с точностью до часового пояса.

06

Подключение нового застройщика

  1. Анкета интегратору

    Клиентский Битрикс24: входящий вебхук на чтение, роботы на события сделок и лидов, справка о структуре воронок. Готовая инструкция — 2–4 часа на стороне клиента.

  2. Развёртывание

    Скрипт создаёт изолированную базу, роли, каноническую модель и конфигурацию клиента одной командой.

  3. Маппинг воронки

    Стадии клиента сопоставляются каноническим ключам; определения MQL/SQL, каналы и исключения фиксируются в настройках.

  4. Витрины

    Подключаются дашборд, таблица планов и Telegram-бот — по потребности клиента.

  5. Выверка

    Контрольная сверка цифр с отчётом клиента за прошедший месяц — до совпадения. После этого система в бою.

07

Направления развития

НаправлениеСодержаниеСтатус
Мониторинг данныхАвтоматический контроль свежести: алерт, если данные клиента не обновлялись дольше порогаплан
Realtime-витриныМгновенное обновление дашборда при изменении сделки (push вместо опроса)план
Деплой-контурВерсионирование миграций и автоматизация выкладки взамен ручных операцийплан