Techniczne zadanie na rozwój bota Telegram
Cel: stworzyć bota Telegram do automatyzacji interakcji między klientami, wykonawcami a administracją. Bot ma być prosty, wygodny, mieć autoryzację za numer telefonu, system ról oraz możliwość skalowania. Dokument jest przeznaczony do obliczenia kosztów i terminów rozwoju.
1. Główne role
Klient — tworzy zgłoszenie, dodaje uczestników, otrzymuje statusy.
Wykonawca — dodaje pozycje, komentuje i oznacza wykonanie.
Konsultant / projektant — załącza materiały i komentarze.
Dostawca / logistyk — potwierdza wykonanie i terminy.
Administrator — zarządza użytkownikami i zgłoszeniami.
2. Główna funkcjonalność
Powitalna wiadomość i wybór roli użytkownika.
Tworzenie i edytowanie zgłoszeń.
Dodawanie uczestników (wykonawców, konsultantów itp.).
Edytowanie i potwierdzanie pozycji.
System powiadomień o nowych zgłoszeniach i zmianach statusów.
Integracja z Google Sheets lub Airtable.
Panel administracyjny z filtrowaniem według ról i statusów.
Wsparcie dla wielu języków (ukraiński, rosyjski).
3. Przykłady scenariuszy dialogu
Użytkownik: 'Stworzyć zgłoszenie' → Bot: 'Podaj miasto i typ zadania' → po wypełnieniu bot tworzy kartę i powiadamia administratora.
Wykonawca: 'Dodać pozycję' → Bot proponuje wprowadzenie nazwy i ilości → zapisuje dane w tabeli.
Klient: 'Sprawdzić status' → Bot pokazuje aktualny etap realizacji zgłoszenia.
4. System powiadomień i raportowania
Powiadomienia w Telegramie przy tworzeniu lub zmianie zgłoszenia.
Raporty w formie tabel (Google Sheets / Excel).
Automatyczne codzienne lub cotygodniowe podsumowanie aktywności.
5. Interfejs i UX
Menu z przyciskami i emotikonami.
Nie więcej niż 3 poziomy zagnieżdżenia.
Przełączanie języka komendą.
Paleta kolorów: węglowo-szary, nefrytowo-zielony, złoty, biały.
Minimalistyczny design bez przeciążenia tekstem.
6. Wymagania techniczne
Telegram Bot API.
Python (Aiogram / FastAPI) lub Node.js (Telegraf).
Baza danych PostgreSQL / Firebase / Google Sheets.
Autoryzacja za numer telefonu (Telegram ID).
Skalowalna architektura.
Adaptacja pod urządzenia mobilne i interfejs WebApp.
7. Etapy rozwoju
1. Opracowanie scenariuszy i interfejsu (UX, struktura dialogów).
2. Rozwój MVP (klient + wykonawca + administrator).
3. Podłączenie dodatkowych ról i integracji.
4. Testowanie, konfiguracja powiadomień i uruchomienie.
5. Wsparcie i skalowanie.
8. Wsparcie techniczne i przekazanie projektu
Po uruchomieniu przewidziano tydzień testowania z możliwością poprawek. Kod źródłowy ma być skomentowany i uzupełniony krótką instrukcją instalacji i konfiguracji.
Dokument można wykorzystać do oceny kosztów i terminów rozwoju. Cel — stworzyć niezawodne, z
zrozumiałe i skalowalne narzędzie interakcji.