Переробка коду з python на kotlin

Коротко опишіть проект, його мету та поточну архітектуру.

 • Проект: NFCGate relay-сервер

 • Поточний стек: Python 3.x, server.py з офіційного репозиторію NFCGate, Protocol Buffers 3.x, TCP-з'єднання на порту 5566

 • Середовище: Windows 11 на VPS (RDP), Gradle, Kotlin

Ціль

Переписати серверну частину NFCGate з Python на Kotlin, зберігши всю існуючу функціональність та показники продуктивності з урахуванням подальшого розширення та підтримки.

Завдання та обсяг роботи

 1. Аналіз та документування

 • Вивчити поточний Python‑код (server.py), виділити модулі, логіку обміну повідомленнями, обробку помилок та формат даних protobuf.

 • Скласти діаграму архітектури (модулі, взаємодії, мережеві порти).

 2. Розробка на Kotlin

 • Вибрати фреймворк: Ktor або Spring Boot (за згодою).

 • Реалізувати прийом вхідних TCP з'єднань на порту 5566.

 • Інтегрувати Protocol Buffers: згенерувати Kotlin-класи з .proto-файлів, забезпечити серіалізацію/десеріалізацію.

 • Забезпечити логіку реле: маршрутизувати трафік між двома підключеними клієнтами.

 • Реалізувати обробку помилок, логи та метрики (через slf4j/logback або вбудовані засоби Ktor/Spring).

 3. Тестування

 • Юніт-тести для кожного ключового модуля (з використанням JUnit5/kotest).

 • Інтеграційні тести: симуляція двох клієнтів, перевірка коректності пересилання protobuf-повідомлень.

 • Тестування навантаження (наприклад, Apache JMEter) для перевірки стійкості при пікових з'єднаннях.

 4. Документація та деплой

 • Підготувати інструкцію зі збирання та запуску (Gradle).

 • Dockerfile (опційно) для контейнеризації.

 • Скрипти або кроки розгортання на Windows 11 VPS (пакетна збірка, налаштування служби/демона).

Вимоги до фахівця

 • Мови та фреймворки: Kotlin, Ktor або Spring Boot, Gradle

 • Мережеве програмування: досвід роботи з TCP-сокетами

 • Protocol Buffers: генерація та використання в Kotlin

 • Тестування: JUnit5 / kotest, вміння писати юніт- та інтеграційні тести

 • CI/CD (опціонально): знайомство з GitHub Actions, GitLab CI або аналогами

Нефункціональні вимоги

 • Продуктивність: затримка не більше поточних ~60 мс (пінг до VPS)

 • Надійність: стійкість до обривів з'єднання, автоматичне перепідключення клієнтів

 • Логування: рівень, що настроюється (INFO, DEBUG, ERROR), ротація логів

 • Безпека: захист від базових атак мережі (DoS, некоректні пакети)

Критерії приймання

 1. Повне перенесення функціональності Python-сервера на Kotlin без регресій.

 2. Проходження всіх юніт- та інтеграційних тестів.

 3. Документацію зі складання та запуску перевірено на чистій Windows 11 VPS.

 4. Продуктивність відповідає чи перевищує поточні показники.

Терміни та етапи

Етап Опис Термін (робочі дні)

Аналіз та дизайн Ознайомлення з кодом, діаграми 3

Розробка MVP Базова логіка реле 5

Інтеграція protobuf Генерація + тести 2

Тестування Юніт, інтеграційні, навантаження 3

Документація та деплой Інструкції, Docker (якщо потрібно) 2

Комунікація

 • Інструмент: Telegram/Slack/Email

 • Звіти: щоденні стендапи, проміжна демонстрація (після MVP та після тестів)

 • Код-рев'ю: через GitHub Pull Requests

Якщо потрібно щось уточнити чи додати, дайте знати!