Документация Fin Boost

Техническая документация системы AI-коллекторинга.

Начало работы

Обзор системы, диаграммы архитектуры, быстрый старт и справочник конфигурации.

Начало работы

Ядро системы

AI движок, менеджер диалогов, архитектура промптов, 8 инструментов, память и RAG поиск.

Ядро системы

Инфраструктура

Split-топология, Docker сервисы, удалённый сервер, воркеры и система прокси.

Инфраструктура

Телеграм

Пул из 20 аккаунтов Pyrogram, 3-фазный прогрев, анти-бан стратегия, GoIP и эмулятор.

Телеграм

API и Web

FastAPI REST API (109 эндпоинтов), React SPA дашборд, центр оператора и админ бот.

API и Web

База данных

28 ORM моделей, Alembic миграции, паттерн Repository и аналитика коммуникаций.

База данных

Операции

CI/CD пайплайн (6 задач), pytest, структурированное логирование, watchdog мониторинг.

Операции

Справочник

Каталог функций, архитектурные решения, открытые проблемы, changelog и аудит.

Справочник

---

Система на один взгляд

graph LR
    subgraph Remote["Удалённый сервер (fin-boost.com)"]
        nginx[nginx :443] --> api[FastAPI :8000]
        api --> db[(PostgreSQL + pgvector)]
        api --> redis[(Redis)]
    end

    subgraph Local["Локальный сервер"]
        orch[Оркестратор диалогов] -->|asyncpg| db
        orch -->|aioredis| redis
        admin[Админ бот] -->|pub/sub| redis
        celery[Celery воркеры] -->|broker| redis
        beat[Celery Beat] --> celery
    end

    orch -->|Pyrogram MTProto| tg((Telegram))
    api -->|обслуживает| spa[React SPA]

    style Remote fill:#f0f9ff,stroke:#0284c7
    style Local fill:#f0fdf4,stroke:#059669

Компонент	Технология	Кол-во
Telegram аккаунты	Pyrogram / MTProto	20
AI провайдер	Anthropic SDK (Claude)	основной
API эндпоинты	FastAPI	109
ORM модели	SQLAlchemy 2.0	28
Celery задачи	Beat + on-demand	22
Docker сервисы	compose	8