Bot CRM Telegram
**CRM-system w formacie bota Telegram + panel administracyjny dla małych firm.** Zarządzanie kontaktami, transakcjami, zadaniami i dokumentami bezpośrednio z komunikatora.
### Możliwości
* **Kontakty i transakcje:** tworzenie/edycja/wyszukiwanie, paginacja. Lejek sprzedażowy z etapami, powiązanie z kontaktami, historia zmian.
* **Zadania:** priorytety, terminy, powiązanie z transakcjami/kontaktami. Filtr „moje/wszystkie”, automatyczne przypomnienia.
* **AI/OCR:** zdjęcie wizytówki/faktury/paragonu → OpenAI Vision wyodrębnia dane → w 1 kliknięcie tworzy się kontakt lub transakcja.
* **Raporty:** eksport do Excel i PDF (wsparcie dla cyrylicy), wykresy. Integracja z Google Sheets (eksport/import).
* **Tryb inline:** szybkie wyszukiwanie kontaktów i transakcji z dowolnego czatu Telegram.
* **Automatyzacja:** poranny przegląd, przypomnienia o zadaniach, automatyczne czyszczenie plików.
* **Panel administracyjny:** SQLAdmin z autoryzacją do zarządzania danymi przez przeglądarkę + dokumentacja klienta.
* **Role (4 poziomy):** Użytkownik → Menedżer → Administrator → Super Administrator.
* **Śledzenie:** powiadomienia Telegram przy odwiedzinach panelu administracyjnego i dokumentacji.
### Stos
Python 3.12, aiogram 3.24, FastAPI, SQLAlchemy 2 (async), Alembic, PostgreSQL 16, Redis 7, OpenAI Vision API, Docker Compose, Nginx, SSL, VPS.
### Bezpieczeństwo
Walidacja danych, ograniczenie liczby zapytań, pooling połączeń, ochrona przed warunkami wyścigu, nagłówki bezpieczeństwa, Docker bez uprawnień roota, strukturalne logowanie, scentralizowany handler błędów.
### Możliwości
* **Kontakty i transakcje:** tworzenie/edycja/wyszukiwanie, paginacja. Lejek sprzedażowy z etapami, powiązanie z kontaktami, historia zmian.
* **Zadania:** priorytety, terminy, powiązanie z transakcjami/kontaktami. Filtr „moje/wszystkie”, automatyczne przypomnienia.
* **AI/OCR:** zdjęcie wizytówki/faktury/paragonu → OpenAI Vision wyodrębnia dane → w 1 kliknięcie tworzy się kontakt lub transakcja.
* **Raporty:** eksport do Excel i PDF (wsparcie dla cyrylicy), wykresy. Integracja z Google Sheets (eksport/import).
* **Tryb inline:** szybkie wyszukiwanie kontaktów i transakcji z dowolnego czatu Telegram.
* **Automatyzacja:** poranny przegląd, przypomnienia o zadaniach, automatyczne czyszczenie plików.
* **Panel administracyjny:** SQLAdmin z autoryzacją do zarządzania danymi przez przeglądarkę + dokumentacja klienta.
* **Role (4 poziomy):** Użytkownik → Menedżer → Administrator → Super Administrator.
* **Śledzenie:** powiadomienia Telegram przy odwiedzinach panelu administracyjnego i dokumentacji.
### Stos
Python 3.12, aiogram 3.24, FastAPI, SQLAlchemy 2 (async), Alembic, PostgreSQL 16, Redis 7, OpenAI Vision API, Docker Compose, Nginx, SSL, VPS.
### Bezpieczeństwo
Walidacja danych, ograniczenie liczby zapytań, pooling połączeń, ochrona przed warunkami wyścigu, nagłówki bezpieczeństwa, Docker bez uprawnień roota, strukturalne logowanie, scentralizowany handler błędów.