Телеграм 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;

перевести текст на английский язык;

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

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