Generator aplikacji mobilnych dla biletów KD

Bilety zakupione online na oficjalnej stronie Kolei Dolnośląskich nie mogą być przedstawione w aplikacji mobilnej.

Jest to szczególnie uciążliwe dla posiadaczy biletów okresowych, którzy muszą nosić ze sobą wydrukowane wersje lub przechowywać pliki PDF w telefonie.

Ten projekt rozwiązuje ten problem, generując dedykowaną aplikację mobilną na urządzenia Android z Twoim biletem.

Bilet Kolei Dolnośląskich z kodem Aztec

Prywatność

Twój plik biletu jest przesyłany na nasz bezpieczny serwer w celu wygenerowania aplikacji. Dane są usuwane co 24 godziny, aby zapewnić maksymalną prywatność.

Dostosowanie

Aplikacja automatycznie dostosowuje jasność ekranu i motywy na podstawie ustawień systemowych, zapewniając najlepsze doświadczenie użytkownika.

Open Source

Cały kod źródłowy jest otwarty i dostępny na GitHubie. Możesz samodzielnie hostować aplikację, jeśli masz obawy dotyczące prywatności.

Jak to działa?

  1. Prześlij plik PDF z biletem

    Wybierz plik PDF zawierający Twój bilet Kolei Dolnośląskich

  2. Przytnij obszar z kodem Aztec

    Użyj narzędzia do przycinania, aby zaznaczyć kod na bilecie

  3. Pobierz aplikację mobilną

    Zainstaluj wygenerowaną aplikację na swoim urządzeniu Android

  4. Gotowe!

    Teraz możesz przedstawiać swój bilet mobilnie - nawet offline

Dlaczego kod Aztec, a nie QR?

Choć wizualnie podobne, kody Aztec i QR różnią się technologią:

  • Kod Aztec ma charakterystyczny centralny wzór przypominający piramidę
  • Używany głównie w biletach kolejowych i lotniczych
  • Może przechowywać więcej danych na mniejszej powierzchni
  • Jest bardziej odporny na uszkodzenia

Koleje Dolnośląskie używają kodów Aztec ze względu na ich większą pojemność i niezawodność.

Uruchom na własnym urządzeniu

Co to jest open-source?

Open-source oznacza, że kod źródłowy projektu jest publicznie dostępny i każdy może go przeglądać, modyfikować oraz uruchamiać we własnym środowisku. Dzięki temu:

  • Możesz sprawdzić dokładnie, jak działa aplikacja
  • Masz pewność, że Twoje dane są bezpieczne
  • Możesz wprowadzić własne modyfikacje i ulepszenia
  • Społeczność może weryfikować i poprawiać bezpieczeństwo

Ten projekt jest w pełni open-source - wszystkie jego komponenty są dostępne na GitHub.

Uruchomienie z Docker

Docker to platforma, która pozwala uruchamiać aplikacje w izolowanych kontenerach, niezależnie od systemu operacyjnego. Aby uruchomić tę aplikację lokalnie:

git clone https://github.com/entervive/bilet-kd.git
cd bilet-kd
docker build -t bilet-kd .
docker run -p 5000:5000 bilet-kd

Aplikacja będzie dostępna pod adresem: http://localhost:5000/

Self-hosting daje Ci pełną kontrolę nad swoimi danymi i procesem generowania aplikacji.

Słowniczek techniczny


Kod źródłowy
Tekst programu napisany w języku programowania, który jest czytelny dla człowieka i może być modyfikowany.

Docker
Platforma do tworzenia, dystrybucji i uruchamiania aplikacji w kontenerach, co zapewnia izolację i przenośność między różnymi środowiskami.

Self-hosting
Praktyka uruchamiania oprogramowania na własnym serwerze lub komputerze, zamiast korzystania z usług zewnętrznych.

GitHub
Platforma hostingowa dla projektów open-source, umożliwiająca przechowywanie, śledzenie zmian i współpracę nad kodem źródłowym.

Flask
Lekki framework aplikacji webowych napisany w języku Python, wykorzystywany przez tę aplikację.

Często zadawane pytania

Tak, wygenerowana aplikacja mobilna działa całkowicie offline. Po zainstalowaniu nie wymaga połączenia z internetem do wyświetlania i weryfikacji biletu.

Aplikacja jedynie wyświetla bilet, który został legalnie zakupiony. Nie modyfikuje ani nie fałszuje danych biletu. Jest to po prostu alternatywny sposób prezentacji informacji z oryginalnego biletu PDF.

Wszelkie błędy lub propozycje ulepszeń można zgłaszać poprzez zakładkę "Issues" na repozytorium GitHub. Możesz również bezpośrednio stworzyć "Pull Request" z proponowanymi zmianami.