Przepisanie kodu z Pythona na Kotlin

Krótko opisz projekt, jego cel oraz obecną architekturę.

 • Projekt: NFCGate relay-serwer

 • Obecny stos technologiczny: Python 3.x, server.py z oficjalnego repozytorium NFCGate, Protocol Buffers 3.x, połączenie TCP na porcie 5566

 • Środowisko: Windows 11 na VPS (RDP), Gradle, Kotlin

Cel

Przepisanie serwerowej części NFCGate z Pythona na Kotlin, zachowując całą istniejącą funkcjonalność oraz wskaźniki wydajności, z uwzględnieniem przyszłego rozszerzania i wsparcia.

Zadania i zakres pracy

 1. Analiza i dokumentacja

 • Zapoznać się z obecnym kodem Python‑owym (server.py), wyodrębnić moduły, logikę wymiany wiadomości, obsługę błędów oraz format danych protobuf.

 • Sporządzić diagram architektury (moduły, interakcje, porty sieciowe).

 2. Rozwój w Kotlin

 • Wybrać framework: Ktor lub Spring Boot (za zgodą).

 • Zaimplementować odbiór przychodzących połączeń TCP na porcie 5566.

 • Zintegrować Protocol Buffers: wygenerować klasy Kotlin z plików .proto, zapewnić serializację/deserializację.

 • Zapewnić logikę relay: kierować ruch pomiędzy dwoma podłączonymi klientami.

 • Zaimplementować obsługę błędów, logi i metryki (przez slf4j/logback lub wbudowane środki Ktor/Spring).

 3. Testowanie

 • Testy jednostkowe dla każdego kluczowego modułu (z użyciem JUnit5/kotest).

 • Testy integracyjne: symulacja dwóch klientów, sprawdzenie poprawności przesyłania protobuf‑owych wiadomości.

 • Testy obciążeniowe (np. Apache JMeter) w celu sprawdzenia odporności przy szczytowych połączeniach.

 4. Dokumentacja i wdrożenie

 • Przygotować instrukcję budowania i uruchomienia (Gradle).

 • Dockerfile (opcjonalnie) do konteneryzacji.

 • Skrypty lub kroki wdrożeniowe na Windows 11 VPS (pakietowa kompilacja, konfiguracja usługi/demona).

Wymagania wobec specjalisty

 • Języki i frameworki: Kotlin, Ktor lub Spring Boot, Gradle

 • Programowanie sieciowe: doświadczenie z TCP-socketami

 • Protocol Buffers: generacja i użycie w Kotlin

 • Testowanie: JUnit5 / kotest, umiejętność pisania testów jednostkowych i integracyjnych

 • CI/CD (opcjonalnie): znajomość GitHub Actions, GitLab CI lub podobnych

Niefunkcjonalne wymagania

 • Wydajność: opóźnienie nie większe niż obecne ~60 ms (ping do VPS)

 • Niezawodność: odporność na zerwania połączenia, automatyczne ponowne łączenie klientów

 • Logowanie: poziom konfigurowalny (INFO, DEBUG, ERROR), rotacja logów

 • Bezpieczeństwo: ochrona przed podstawowymi atakami sieciowymi (DoS, niepoprawne pakiety)

Kryteria akceptacji

 1. Pełne przeniesienie funkcjonalności serwera Python na Kotlin bez regresji.

 2. Przejście wszystkich testów jednostkowych i integracyjnych.

 3. Dokumentacja dotycząca składania i uruchomienia zweryfikowana na czystym Windows 11 VPS.

 4. Wydajność odpowiada lub przewyższa obecne wskaźniki.

Terminy i etapy

Etap Opis Termin (dni robocze)

Analiza i projekt Zapoznanie z kodem, diagramy 3

Rozwój MVP Podstawowa logika relay 5

Integracja protobuf Generacja + testy 2

Testowanie Testy jednostkowe, integracyjne, obciążeniowe 3

Dokumentacja i wdrożenie Instrukcje, Docker (jeśli potrzebne) 2

Komunikacja

 • Narzędzie: Telegram/Slack/Email

 • Raporty: codzienne stand-upy, demonstracja pośrednia (po MVP i testach)

 • Code-review: przez GitHub Pull Requests

Jeśli trzeba coś wyjaśnić lub dodać, daj znać!