Написать документацию по дипломной работе

Rozwój Telegram Mini App (Bot + WebApp) do sprzedaży dóbr cyfrowych i walut w grach (Python / aiogram) Opis projektu: Wymagana jest разработка Telegram-bota z pełnoprawnym interfejsem WebApp do zautomatyzowanej sprzedaży dóbr cyfrowych (Telegram Stars, Telegram Premium, waluty w grach/donaty do PUBG Mobile, Steam i inne). Projekt nosi nazwę Aspect App. Główny nacisk kładzie się na szybkość działania, płynny UI/UX w stylu Web3/minimalizmu oraz pełną automatyzację wydawania towarów po dokonaniu płatności. Stos technologii: Backend: Python 3.10+, aiogram 3.x (FastAPI dla Webhook/API mile widziane). Baza danych: PostgreSQL / Redis (do sesji i cache'owania). Frontend (WebApp): React.js / Vue.js / Next.js (według uznania dewelopera, ważna jest szybkość i płynność animacji). Integracje: Telegram WebApp API. Główna funkcjonalność (MVP): 1. Część kliencka (Telegram Mini App): Główny ekran: Kategorie towarów (Aktywa Telegram, Donaty w grach). Siatka banerowa dla promocji. Katalog towarów: Karty towarów z wyborem objętości (na przykład: 50, 100, 500 Telegram Stars lub UC). Pola do wprowadzania danych gracza (Player ID do PUBG). Koszyk i Zamówienie: Szybki zakup w 2 kliknięcia. Moduł płatności: Integracja metod płatności (CryptoBot API / TON Connect / inne bramki fiatowe do uzgodnienia). Panel użytkownika: Historia zamówień, status realizacji, system poleceń (saldo wewnątrz aplikacji). 2. Panel administracyjny (wbudowany w WebApp lub oddzielny bot): Zarządzanie katalogiem (dodawanie/usuwanie towarów, zmiana cen). Monitorowanie zamówień i statystyki sprzedaży. System wysyłek do bazy użytkowników. 3. Logika automatyzacji (będzie plusem): Gotowość architektury do integracji z API dostawców (API do automatycznego zakupu Stars/UC). Na etapie MVP część towarów może być wydawana kodami z bazy danych. Co jest wymagane od wykonawcy: 1. Rozwój architektury bazy danych i backendu w Pythonie. 2. Wykonanie i integracja WebApp (projekt graficzny omówimy, ważny jest czysty styl Web3, Glassmorphism). 3. Ustawienie bezpiecznych transakcji i webhooków płatności. 4. Wdrożenie na serwer (Docker, Ubuntu, konfiguracja SSL). Wymagania dla kandydata: Doświadczenie w komercyjnej разработке Telegram WebApps od 1 roku. Posiadanie portfolio z uruchomionymi i działającymi Mini Apps (przesyłaj linki w odpowiedzi). Czysty, udokumentowany kod. Warunki pracy: Praca tylko przez Bezpieczną Transakcję (Sejf / Escrow) platformy. Płatność etapowa (dzielimy projekt na Sprint 1: Backend + Baza danych, Sprint 2: Frontend WebApp, Sprint 3: Integracja płatności i testy). Budżet: Do uzgodnienia z wybranym kandydatem (podaj swoją widełkę cenową i terminy w odpowiedzi)

Specyfikacja techniczna dla bota Telegram / mini platformy 1. Cel projektu Stworzyć bota Telegram i mini platformę do wyszukiwania specjalistów oraz składania zgłoszeń przez użytkowników. Użytkownik może złożyć zgłoszenie, specjalista może odpowiedzieć, administrator kontroluje publikacje, moderację, płatności i bezpieczeństwo. 2. Role użytkowników Użytkownik: może się zarejestrować; potwierdzić numer telefonu i email; stworzyć zgłoszenie; przeglądać specjalistów; otrzymywać odpowiedzi. Specjalista: może się zarejestrować; wypełnić formularz; podać usługi, ceny, miasto, doświadczenie; dodać zdjęcia wykonanych prac; odpowiadać na zgłoszenia. Administrator: może moderować zgłoszenia; sprawdzać specjalistów; rozpatrywać skargi; zarządzać reklamą; kontrolować płatności; blokować użytkowników. 3. Rejestracja Obowiązkowo: potwierdzenie numeru telefonu przez Telegram lub kod; potwierdzenie emaila za pomocą linku lub kodu; bez potwierdzenia telefonu i emaila zgłoszenie nie jest publikowane. 4. Zgłoszenia Użytkownik wypełnia: kategorię usługi; opis zadania; miasto/dzielnicę; termin realizacji; budżet; zdjęcie (w razie potrzeby); dane kontaktowe. Ograniczenia: nie więcej niż trzy zgłoszenia na dobę od jednego użytkownika. 5. Moderacja Wszystkie zgłoszenia najpierw trafiają do moderacji. Automatycznie blokować lub wysyłać do ręcznej weryfikacji: zdjęcia kategorii 18+; spam; obraźliwe wypowiedzi; podejrzane linki; powtarzające się zgłoszenia; masowe zgłoszenia z jednego konta. 6. Specjaliści Formularz specjalisty: imię; miasto; usługi; doświadczenie; ceny; portfolio; zdjęcie; opis; link; opinie; status weryfikacji. Ważne: platforma nie ponosi odpowiedzialności za jakość usług specjalisty. Powinno to być zaznaczone w umowie użytkownika. 7. Płatność Opcje monetyzacji: płatne umieszczanie formularza specjalisty; płatne podnoszenie formularza; płatny dostęp do zgłoszeń; reklama po uzgodnieniu z administratorem; subskrypcja dla specjalistów. Podłączyć płatności: Stripe / Przelewy24 / PayU / Fondy — w miarę możliwości dewelopera. 8. Panel administracyjny Konieczne jest stworzenie wygodnego panelu administracyjnego: lista użytkowników; lista specjalistów; zgłoszenia do moderacji; skargi; płatności; statystyki; blokowanie użytkowników; edycja kategorii; zarządzanie reklamą; ręczne zatwierdzanie lub odrzucanie publikacji. 9. Bezpieczeństwo Obowiązkowo: ochrona przed spamem; limit zgłoszeń; limit wiadomości; ochrona przed masowymi rejestracjami; logowanie działań; kopie zapasowe bazy danych; weryfikacja plików i zdjęć; CAPTCHA lub inny mechanizm ochrony przed spamem; blokowanie według numeru telefonu, adresu IP lub ID Telegram. 10. Odpowiedzialność W umowie użytkownika należy zaznaczyć: platforma nie jest pracodawcą; platforma nie ponosi odpowiedzialności za działania specjalistów; użytkownik samodzielnie podejmuje decyzję o współpracy; administracja ma prawo usunąć zgłoszenie lub formularz bez podawania przyczyny; reklama publikowana jest tylko po uzgodnieniu z administratorem; zabronione są spam, oszustwa, treści 18+ oraz wszelkie przejawy agresji.

Potrzebny DevOps / administrator Linux do wdrożenia bota Telegram na VPS. Potrzebna jest dokładnie konfiguracja serwera i produkcyjnego wdrożenia. Stos technologiczny projektu: Node.js 20+, Telegraf, Express, Prisma, PostgreSQL, Redis, Docker, Docker Compose, Telegram Mini Apps, OCR. Co należy zrobić: 1. Przygotować Ubuntu VPS. 2. Skonfigurować dostęp SSH za pomocą kluczy. 3. Skonfigurować zaporę sieciową. 4. Zainstalować Docker i Docker Compose. 5. Skonfigurować PostgreSQL. 6. Skonfigurować Redis. 7. Skonfigurować Nginx. 8. Podłączyć domenę i SSL Let’s Encrypt. 9. Skonfigurować production .env. 10. Uruchomić migracje Prisma. 11. Uruchomić aplikację Node.js. 12. Skonfigurować webhook Telegram. 13. Sprawdzić /health i /ready. 14. Skonfigurować backup PostgreSQL. 15. Zostawić instrukcję: jak zaktualizować, zrestartować, sprawdzić logi i przywrócić backup. Ważne: - Kod nie musi być przepisywany. - Należy dokładnie wdrożyć projekt na VPS. - Potrzebna osoba z doświadczeniem w Docker + Node.js + PostgreSQL + Redis + Nginx. - Preferowane pokazanie 2–3 podobnych projektów.

Projekt: YOKA ASSIST — inteligentny system diagnostyki i szkolenia dla sprzętu górniczego Opis projektu Wymagana jest opracowanie inteligentnego systemu YOKA ASSIST na bazie bota Telegram z wykorzystaniem sztucznej inteligencji. Głównym celem projektu jest stworzenie cyfrowego asystenta dla elektryków, mechaników, operatorów i personelu inżynieryjno-technicznego, który będzie pomagał w diagnostyce usterek, szkoleniu pracowników oraz przechowywaniu bazy wiedzy technicznej. Pierwszy etap projektu jest skierowany na sprzęt górniczy (koparki EKG, wiertnice SBSh i inne urządzenia), ale architektura powinna być uniwersalna i łatwo skalowalna. Podstawowa funkcjonalność Bot Telegram - Nowoczesny interfejs. - Menu z przyciskami. - Autoryzacja użytkowników. - Podział uprawnień (użytkownik, administrator, główny administrator). Sztuczna inteligencja Baza wiedzy Wymagana jest stworzenie systemu przechowywania wiedzy. Wsparcie: - PDF; - Word; - Excel; - zdjęcia; - schematy; - wideo; - instrukcje; - karty sprzętu; - dokumenty techniczne. Po dodaniu informacji przez administratora AI powinno ją wykorzystywać w odpowiedziach bez zmiany kodu programu. Diagnostyka sprzętu Wsparcie wyszukiwania: - według kodu błędu; - według nazwy zabezpieczenia; - według szafy; - według bloku; - według sprzętu; - według objawów. Dla każdej usterki pożądane jest przewidzenie: - opisu; - możliwych przyczyn; - kolejności sprawdzania; - zdjęć; - schematów; - materiałów wideo; - linków do powiązanych dokumentów. Dynamiczne przyciski Przyciski powinny być generowane automatycznie w zależności od sytuacji. Na przykład: - Sprawdź szafę. - Zobacz schemat. - Zobacz wideo. - Następny etap diagnostyki. - Wróć. Panel administracyjny Główny administrator powinien mieć możliwość: - dodawania sprzętu; - tworzenia nowych błędów; - dodawania dokumentów; - przesyłania zdjęć; - przesyłania wideo; - edytowania bazy wiedzy; - zarządzania użytkownikami; - wyznaczania administratorów poszczególnych działów. System QR Każda szafa, blok lub sprzęt może mieć własny kod QR. Po zeskanowaniu użytkownik od razu trafia do odpowiedniej sekcji bota Telegram. Dziennik napraw Wymagana jest realizacja dziennika wykonanych prac. Funkcje: - kto wykonywał naprawę; - data i czas; - sprzęt; - opis wykonanych prac; - użyte materiały; - komentarze; - historia napraw. Analiza Pożądane jest wdrożenie: - najczęstszych usterek; - statystyki napraw; - czasu usuwania usterek; - raportów dotyczących sprzętu; - raportów dotyczących pracowników. Skalowalność Architektura powinna pozwalać na dodawanie nowych rodzajów sprzętu; - nowe przedsiębiorstwa; - nowe działy; - nowe bazy wiedzy. Technologie Pożądane: - Python; - Telegram Bot API; - PostgreSQL lub SQLite (na pierwszym etapie dopuszczalne jest SQLite); - integracja z AI przez API; - architektura modułowa; - możliwość dalszego podłączenia panelu webowego. Czego oczekuje się od wykonawcy - Opracowanie w pełni działającego projektu. - Czysty i zrozumiały kod. - Udokumentowana struktura projektu. - Możliwość dalszego rozwoju bez całkowitej przeróbki. - Pomoc w początkowym wdrożeniu i konfiguracji projektu. Projekt jest długoterminowy. Po pomyślnym zakończeniu pierwszego etapu możliwe są dalsze poprawki i rozwój systemu.

Szukam doświadczonego programisty Python, który będzie w stanie przeprowadzić pełny audyt istniejącego projektu, usunąć błędy i doprowadzić go do całkowicie stabilnej pracy. W razie potrzeby dopuszczalna jest całkowita przebudowa architektury projektu lub napisanie nowej implementacji z zachowaniem całej niezbędnej funkcjonalności. Co zapewnię Źródło kodu obecnego bota. Film wideo z demonstracją, jak powinien działać bot. Pełne zadanie techniczne z logiką działania. Główne zadanie Należy przywrócić stabilną pracę bota i zagwarantować realizację pełnego scenariusza bez awarii. Jeśli obecna architektura nie może być jakościowo naprawiona, dopuszczalna jest całkowita przebudowa projektu. Głównym celem jest nie zachowanie istniejącego kodu, a uzyskanie w pełni działającego, stabilnego i wspieranego produktu. Co należy zrobić 1. Przeprowadzić audyt projektu Przed rozpoczęciem pracy należy: przeanalizować istniejący kod; określić przyczyny, dla których bot przestał działać; ocenić, co można naprawić, a co lepiej przepisać. 2. Przywrócić całą funkcjonalność Po zakończeniu prac bot powinien poprawnie realizować cały scenariusz: rejestracja nowego konta; potwierdzenie logowania kodem z e-maila; autoryzacja; realizacja scenariusza zgodnie z zadaniem technicznym; zakończenie pracy; przejście do następnego konta. Wszystkie etapy powinny działać automatycznie bez ręcznej interwencji. 3. Naprawić istniejące błędy Należy usunąć wszelkie błędy związane z: autoryzacją; uzyskiwaniem kodu potwierdzenia; niestabilną pracą; zawieszaniem się; nieoczekiwanym zakończeniem programu; błędami po aktualizacjach strony; nieprawidłowym przetwarzaniem wyjątków. 4. Uczynić projekt odpornym Bot powinien: poprawnie obsługiwać błędy; nie wchodzić w nieskończone pętle; automatycznie kończyć nieudane scenariusze; poprawnie kontynuować pracę po niekrytycznych błędach; prowadzić zrozumiałe logi. 5. Panel sterowania Należy zachować lub przebudować panel sterowania. Powinien on umożliwiać: uruchamianie i zatrzymywanie pracy; zmienianie niezbędnych ustawień; przeglądanie bieżącego statusu; przeglądanie dziennika pracy i błędów. Interfejs powinien być zrozumiały i stabilny. 6. Kod Wymagania dotyczące kodu: czytelna struktura projektu; podział logiki na moduły; możliwość dalszego wsparcia. 7. Kompatybilność Projekt powinien działać na nowoczesnej wersji Pythona. Wykonawca jest zobowiązany do dostarczenia pełnej listy zależności oraz instrukcji uruchomienia. 8. Weryfikacja wyniku Przed oddaniem projektu wykonawca jest zobowiązany do zaprezentowania w pełni działającego scenariusza na wideo: uruchomienie projektu; przejście pełnego cyklu; brak błędów; poprawna praca wszystkich funkcji. Co dostarczyć po zakończeniu źródło kodu; wszystkie zmienione pliki; instrukcje uruchomienia; lista zależności; wideo demonstracyjne pracy; krótkie opisane wprowadzone zmiany. Ważne Praca uznawana jest za zakończoną tylko po tym, jak cała funkcjonalność opisana w zadaniu technicznym i filmie demonstracyjnym będzie działać stabilnie bez krytycznych błędów. Jeśli w trakcie audytu okaże się, że obecny projekt nie może być jakościowo naprawiony, dopuszczalna jest jego całkowita przebudowa z zachowaniem całej niezbędnej funkcjonalności. Przy odpowiedzi proszę od razu podać: doświadczenie w pracy z Pythonem; doświadczenie w automatyzacji przeglądarek (Playwright, Selenium lub podobne narzędzia); doświadczenie w pracy z REST API; koszt pracy; orientacyjne terminy realizacji.