Fin Boost Documentation¶

Technical documentation for the AI-powered debt collection system.

Getting Started¶

System overview, architecture diagrams, quick start guide and configuration reference.

Getting Started

Core System¶

AI engine, dialog manager, prompt architecture, 8 tools, per-client memory and RAG search.

Core System

Infrastructure¶

Split-topology deployment, Docker services, remote server, workers and proxy system.

Infrastructure

Telegram¶

20-account Pyrogram pool, 3-phase warming pipeline, anti-ban strategy, GoIP and emulator.

API & Web¶

FastAPI REST API (109 endpoints), React SPA dashboard, operator center and admin bot.

API & Web

Database¶

28 ORM models, Alembic migrations, repository pattern and communication analytics.

Database

Operations¶

CI/CD pipeline (6 jobs), pytest, structured logging, watchdog monitoring and commands.

Operations

Reference¶

Functions catalog, architecture decisions, open issues, changelog and codebase audit.

Reference

System at a Glance¶

graph LR
    subgraph Remote["Remote Server (fin-boost.com)"]
        nginx[nginx :443] --> api[FastAPI :8000]
        api --> db[(PostgreSQL + pgvector)]
        api --> redis[(Redis)]
    end

    subgraph Local["Local Server"]
        orch[Dialog Orchestrator] -->|asyncpg| db
        orch -->|aioredis| redis
        admin[Admin Bot] -->|pub/sub| redis
        celery[Celery Workers] -->|broker| redis
        beat[Celery Beat] --> celery
    end

    orch -->|Pyrogram MTProto| tg((Telegram))
    api -->|serves| spa[React SPA]

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

Component	Tech	Count
Telegram accounts	Pyrogram / MTProto	20
AI provider	Anthropic SDK (Claude)	primary
API endpoints	FastAPI	109
ORM models	SQLAlchemy 2.0	28
Celery tasks	Beat + on-demand	22
Docker services	compose	8