Polski system monitorowania sprzętu vendingowego oparty na API chińskiego serwera

🔹 Opis projektu

Mamy dostęp do gotowego chińskiego systemu chmurowego do monitorowania sprzętu:

https://server.happy-ti.com/

Interfejs jest w pełni w języku chińskim, a deweloperzy odmówili lokalizacji (PL / EN / RU) w swoim aplikacji.

Zamiast tego udostępnili oficjalną dokumentację API, na podstawie której dozwolone jest:

✅ Opracowanie własnego serwera

✅ Połączenie z ich API

✅ Uzyskiwanie danych z ich systemu

✅ Wysyłanie poleceń z powrotem

✅ Stworzenie własnego panelu sterowania na polskim serwerze

🔹 Cel projektu

Zadanie Wykonawcy:

Opracowanie własnego europejskiego systemu monitorowania, umieszczonego na serwerze w Polsce, który będzie w pełni współpracować z chińską platformą przez API, ale mieć własny niezależny interfejs w języku polskim, angielskim i (opcjonalnie) rosyjskim.

✅ Działa przez API chińskiego serwera

✅ W pełni zastępuje chiński interfejs

✅ Wspiera europejskie języki

✅ Zapewnia pełną zdalną kontrolę sprzętu

🔹 Co już jest

✅ Gotowa dokumentacja API (PDF, 99 stron)

✅ Działający chiński serwer

✅ Dostępy (zostaną przekazane po wyborze wykonawcy)

✅ Zrozumienie logiki całego systemu

✅ Gotowość do uruchomienia naszego serwera w Polsce (Linux + VPS)

3. Architektura systemu

System powinien składać się z następujących komponentów:

3.1 Backend (serwer-proxy)

• Połączenie z API chińskiego serwera

• Autoryzacja przez appid

• Obsługa wszystkich zapytań

• Cache'owanie danych

• Logowanie zapytań i błędów

• Walidacja danych wejściowych

• Ochrona przed przekroczeniem limitów (100 zapytań/minutę)

3.2 Baza danych

Przechowywanie:

• Użytkowników

• Urządzeń

• Historii operacji

• Płatności

• Statusów sprzętu

• Błędów i awarii

• Logów API

3.3 Panel sterowania

Interfejs administracyjny dla operatorów.

4. Wymagania funkcjonalne

4.1 Zarządzanie urządzeniami

• Uzyskiwanie listy urządzeń

• Status online / offline

• Uzyskiwanie szczegółowych informacji:

  
  

  • Numer seryjny

  • Lokalizacja

  • Wydajność

  • Błędy

  • Parametry

• Zdalne polecenia:

  
  

  • Włącz/wyłącz

  • Blokada

  • Zdalne zatrzymanie

  • Ustawienie parametrów

4.2 Moduł finansowy

• Historia transakcji

• Historia płatności

• Statystyki przychodów

• Filtrowanie według daty

• Eksport do Excel / CSV

4.3 Karty i klienci (w razie potrzeby)

• Zarządzanie kartami

• Saldo

• Historia operacji

• Blokada / odblokowanie w przypadku braku płatności przez klienta za monitoring

4.4 Powiadomienia i błędy

• Awarie

• Utrata połączenia

• Usterki

• Logi błędów API

4.5 Użytkownicy i dostęp

• Role:

  • Administrator

  • nowy nabywca sprzętu. stworzenie mu konta login/hasło

• Rozgraniczenie praw dostępu

5. Języki interfejsu

Obowiązkowo:

✅ Polski (PL)

Preferowane:

✅ Angielski (EN)

Opcjonalnie:

✅ Rosyjski (RU)

6. Wymagania technologiczne

Dozwolone są następujące technologie:

Backend:

• Node.js / NestJS

• PHP (Laravel)

• Python (FastAPI / Django)

Frontend:

• React

• Vue

• Dowolny nowoczesny framework SPA

Baza danych:

• MySQL / MariaDB

• PostgreSQL

Serwer:

• VPS, Linux, hosting w Polsce

7. Bezpieczeństwo

✅ HTTPS

✅ Ochrona kluczy API

✅ Ograniczenie IP

✅ Logi dostępu

✅ Ochrona przed SQL injection

✅ Ochrona przed XSS / CSRF

🔹 Technologie (można proponować własne)

✅ Backend: Node.js / PHP / Python / Laravel

✅ Frontend: React / Vue / dowolny nowoczesny framework

✅ Baza danych: MySQL / PostgreSQL

✅ Serwer: Linux (VPS, Polska)

🔹 Wymagania obowiązkowe

✅ Doświadczenie w integracjach API

✅ Doświadczenie w IoT / vendingu / zdalnym zarządzaniu sprzętem — będzie dużym plusem

✅ Umiejętność czytania dokumentacji API w języku angielskim lub chińskim

✅ Jasna architektura

✅ Bezpieczeństwo danych

✅ Czysty kod

✅ Dokumentacja projektu

proszę wskazać w odpowiedzi, czy mieliście (wasz zespół):

✅ Przykład podobnych projektów?

✅ Jakie technologie będziecie używać

✅ Przybliżony czas

✅ Przybliżoną cenę

✅ Jak będzie zapewnione bezpieczeństwo