готов

AI Funnel Ecosystem

Воронка лидов, Telegram AI-бот и mini-CRM с outbox-воркером — от хита на лендинге до менеджера в Telegram.

Роль
Продукт и бэкенд
Год
2026
Стек
Python 3.12 · FastAPI · SQLAlchemy · SQLite · aiogram 3 · Alembic · Docker
Статус
готов

Задача

Один стек от хита на лендинге до менеджера: диалог /api/chat, Telegram-бот с квалификацией, mini-CRM (фильтры, заметки, timeline, soft-delete, CSV) и исходящие webhook / notify без потери при падении процесса.

Решение и архитектура

Landing и бот пишут в FastAPI. Данные в SQLite. Outbox копит jobs; отдельный worker шлёт webhook и Telegram менеджеру. HTML CRM поверх того же API.

LandingTG botFastAPISQLiteOutboxWorkerWebhookTG managerHTML CRM
Landing / bot → FastAPI → SQLite + outbox worker → webhook / Telegram; CRM читает API
Панель заявок с четырьмя счётчиками, фильтром статуса и поиском
Мини-CRM: счётчики заявок и фильтры до поступления первого лида.

Инженерные решения

Dedupe по телефону. Нормализованный номер ищет существующий лид; поля дополняются, пишется activity dedupe_merge, дубликат не создаётся.

# src/aifunnel/services/leads.py
if data["phone_normalized"]:
    existing = await find_by_phone(session, data["phone_normalized"], include_deleted=False)
    if existing:
        # Dedupe: enrich the existing lead instead of inserting a duplicate
        merged = False
        for key in (
            "name",
            "email",
            "need",
            "budget_note",
            "telegram_id",
            "telegram_username",
            "tags",
        ):
            val = data.get(key)
            if val and not getattr(existing, key):
                setattr(existing, key, val)
                merged = True

Circuit breaker для AI. После порога failures — OPEN, через recovery_timeout — HALF_OPEN; success возвращает CLOSED.

# src/aifunnel/reliability/circuit_breaker.py
def allow(self) -> bool:
    if self.state == CircuitState.CLOSED:
        return True
    if self.state == CircuitState.OPEN:
        if time.monotonic() - self.opened_at >= self.recovery_timeout:
            self.state = CircuitState.HALF_OPEN
            return True
        return False
    return True

Outbox worker. Цикл claim → process; ошибка — mark_failed с retry, пауза 2 с между тиками.

# src/aifunnel/worker/main.py
while not _stop.is_set():
    async with SessionLocal() as session:
        jobs = await outbox.claim_pending(session, limit=25)
        for job in jobs:
            try:
                await outbox.process_job(session, job)
            except Exception as exc:
                await outbox.mark_failed(session, job, str(exc), retry=True)
    try:
        await asyncio.wait_for(_stop.wait(), timeout=2.0)
    except TimeoutError:
        continue

Стек

Python 3.12, FastAPI, SQLAlchemy async, SQLite, aiogram 3, Alembic, Redis (optional), Docker — из README.

Что бы улучшил дальше

Вынести claim outbox на FOR UPDATE SKIP LOCKED под Postgres, если уйду от SQLite по умолчанию. Сейчас Redis опционален только для общего rate-limit — для нескольких инстансов API это стоит сделать обязательным в prod-профиле.

Ссылки

Репозиторий: github.com/blessed-bless/ai-funnel-ecosystem. Публичного demo нет — локальный CRM на 127.0.0.1:8080/crm/login.