Телеграм CRM система (FastAPI,aiogram, PostgreSQL,Alembic,Redis)

BotLead — CRM-система для малого бізнесу

BotLead — це повноцінна CRM-платформа для автоматизації обробки заявок із соціальних месенджерів та керування продажами. Система орієнтована на малий та середній бізнес і дозволяє централізовано керувати клієнтами, заявками та комунікаціями через Telegram-бот із зручним веб-інтерфейсом.

Основні можливості

Збір заявок через Telegram-бот з автоматичним створенням лідів

Керування лідами у воронці продажів (pipeline) зі зміною статусів

Призначення відповідальних менеджерів на заявки

Вбудована комунікація з клієнтами безпосередньо в Telegram

Веб-дашборд для перегляду й аналізу ефективності продажів

Система нагадувань та сповіщень для менеджерів

Рольова модель доступу (адміністратор, менеджер)

Журнал подій та логування дій користувачів

Архітектура та технологічний стек
Компонент Технологія Версія
Backend API FastAPI 0.109
Telegram Bot aiogram 3.3
Database PostgreSQL 16
ORM SQLAlchemy 2.0
Migrations Alembic 1.13
Cache/Message Queue Redis 7
Frontend React + TypeScript 18
UI Styling Tailwind CSS 3.4
Authentication JWT (PyJWT) 2.8
Validation Pydantic 2.6
Containers Docker + Docker Compose 3.9
Реалізований функціонал
Backend

Розробка REST API з повною документацією через Swagger та OpenAPI

Асинхронна обробка запитів

Авторизація та автентифікація через JWT

Чітка рольова модель доступу

Кешування та обробка фонових задач із використанням Redis

Валідація даних через Pydantic

Повна підтримка міграцій бази даних з Alembic

Написання власних middleware та dependency-інʼєкцій

Telegram-бот

Асинхронний бот на aiogram 3.x

Реєстрація заявок користувачами

Комунікація між менеджерами та клієнтами

Система нагадувань та статусних оновлень

Розподіл заявок між менеджерами

Обробка callback-запитів та FSM-логіка діалогів

Frontend

SPA-інтерфейс на React з TypeScript

Інтерактивний pipeline-дашборд

Відображення статистики продажів

Управління заявками та менеджерами

Модуль авторизації та захист маршрутів

Адаптивна верстка з Tailwind CSS

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

Docker-контейнеризація всіх сервісів

Docker Compose для локального запуску проєкту

Налаштування PostgreSQL та Redis контейнерів

Конфігурація середовищ для development та production

Підготовка сервісів до деплою на VPS

Особистий внесок

Проєктування архітектури всієї системи

Розробка Telegram-бота з нуля

Створення бекенду на FastAPI

Повне налаштування бази даних та ORM

Реалізація механізмів авторизації та безпеки

Інтеграція фронтенду з API

Контейнеризація проєкту та підготовка до розгортання

Репозиторій

Код проєкту доступний на GitHub:

https://github.com/Yegor10/crm-new

Якщо потрібно, можу:

скоротити опис під формат резюме або GitHub README;

перекласти текст англійською мовою;

підготувати презентаційний опис для клієнтів або бірж фрилансу;

оформити технічний кейс-стаді з діаграмами та схемами.