System CRM Telegram (FastAPI, aiogram, PostgreSQL, Alembic, Redis)

BotLead — system CRM dla małych firm

BotLead — to kompleksowa platforma CRM do automatyzacji przetwarzania zgłoszeń z mediów społecznościowych oraz zarządzania sprzedażą. System jest skierowany do małych i średnich firm i pozwala na centralne zarządzanie klientami, zgłoszeniami oraz komunikacją za pomocą bota Telegram z wygodnym interfejsem webowym.

Główne możliwości

Zbieranie zgłoszeń przez bota Telegram z automatycznym tworzeniem leadów

Zarządzanie leadami w lejku sprzedażowym (pipeline) ze zmianą statusów

Przydzielanie odpowiedzialnych menedżerów do zgłoszeń

Wbudowana komunikacja z klientami bezpośrednio w Telegramie

Webowy dashboard do przeglądania i analizy efektywności sprzedaży

System przypomnień i powiadomień dla menedżerów

Model ról dostępu (administrator, menedżer)

Dziennik zdarzeń i logowanie działań użytkowników

Architektura i stos technologiczny
Komponent Technologia Wersja
Backend API FastAPI 0.109
Bot Telegram aiogram 3.3
Baza danych PostgreSQL 16
ORM SQLAlchemy 2.0
Migracje Alembic 1.13
Cache/Kolejka wiadomości Redis 7
Frontend React + TypeScript 18
Stylizacja UI Tailwind CSS 3.4
Autoryzacja JWT (PyJWT) 2.8
Walidacja Pydantic 2.6
Kontenery Docker + Docker Compose 3.9
Zrealizowana funkcjonalność
Backend

Rozwój REST API z pełną dokumentacją przez Swagger i OpenAPI

Asynchroniczne przetwarzanie zapytań

Autoryzacja i uwierzytelnianie przez JWT

Jasny model ról dostępu

Cache i przetwarzanie zadań w tle z użyciem Redis

Walidacja danych przez Pydantic

Pełne wsparcie migracji bazy danych z Alembic

Pisanie własnych middleware i wstrzykiwanie zależności

Bot Telegram

Asynchroniczny bot na aiogram 3.x

Rejestracja zgłoszeń przez użytkowników

Komunikacja między menedżerami a klientami

System przypomnień i aktualizacji statusów

Podział zgłoszeń między menedżerami

Przetwarzanie zapytań callback i logika FSM dialogów

Frontend

Interfejs SPA na React z TypeScript

Interaktywny dashboard pipeline

Wyświetlanie statystyk sprzedaży

Zarządzanie zgłoszeniami i menedżerami

Moduł autoryzacji i ochrona tras

Responsywne układanie z Tailwind CSS

Infrastruktura

Konteneryzacja Docker wszystkich usług

Docker Compose do lokalnego uruchamiania projektu

Konfiguracja kontenerów PostgreSQL i Redis

Konfiguracja środowisk dla development i production

Przygotowanie usług do wdrożenia na VPS

Osobisty wkład

Projektowanie architektury całego systemu

Rozwój bota Telegram od podstaw

Tworzenie backendu na FastAPI

Pełna konfiguracja bazy danych i ORM

Realizacja mechanizmów autoryzacji i bezpieczeństwa

Integracja frontendu z API

Konteneryzacja projektu i przygotowanie do wdrożenia

Repozytorium

Kod projektu dostępny na GitHubie:

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

Jeśli potrzebujesz, mogę:

skrócić opis do formatu CV lub GitHub README;

przetłumaczyć tekst na język angielski;

przygotować opis prezentacyjny dla klientów lub platform freelancowych;

opracować techniczny case study z diagramami i schematami.