Bilet-KD

📝 Spis treści

• O projekcie
• Jak to działa
• Wymagania
• Instalacja
• Funkcjonalności
• Technologie
• Współpraca
• Licencja

🧐 O projekcie

Bilet-KD to aplikacja webowa stworzona głównie dla pracowników Kolei Dolnośląskich, umożliwiająca łatwą konwersję biletu rocznego sieciowego na aplikację mobilną. Projekt powstał w odpowiedzi na brak możliwości zakupu tych biletów w popularnych aplikacjach takich jak Koleo, co utrudniało korzystanie z biletu w formie cyfrowej.

Aplikacja automatycznie przetwarza bilet w formacie PDF, ekstrahuje niezbędne dane oraz kod Aztec, a następnie generuje dedykowaną aplikację mobilną na system Android, która służy jako cyfrowy bilet.

⚙️ Jak to działa

1. Użytkownik przesyła plik PDF zawierający bilet roczny sieciowy
2. System automatycznie:
   • Wyodrębnia dane o właścicielu
   • Identyfikuje daty ważności biletu
   • Rozpoznaje typ biletu
   • Konwertuje PDF na obrazy
3. Użytkownik przycina kod Aztec z biletu za pomocą interaktywnego interfejsu
4. System generuje aplikację mobilną Android zawierającą wszystkie niezbędne dane i kod Aztec
5. Użytkownik może pobrać gotową aplikację APK i zainstalować ją na swoim urządzeniu

📋 Wymagania

• Docker

🔧 Instalacja

Za pomocą Dockera

# Klonowanie repozytorium
git clone https://github.com/entervive/bilet-kd.git
cd bilet-kd

# Budowanie i uruchomienie kontenera Docker
docker build -t bilet-kd .
docker run -p 5000:5000 bilet-kd

🎯 Funkcjonalności

• Przetwarzanie PDF - automatyczna ekstrakcja danych z biletów
• Inteligentne rozpoznawanie - wykrywanie danych właściciela, dat ważności i typu biletu
• Interaktywne przycinanie - przyjazny interfejs do precyzyjnego wyodrębnienia kodu Aztec
• Generowanie aplikacji - tworzenie dedykowanej aplikacji Android w czasie rzeczywistym
• Monitoring postępu - śledzenie procesu kompilacji przez WebSocket
• Automatyczne czyszczenie - usuwanie tymczasowych plików po 24 godzinach

🛠️ Technologie

• Backend: Python, Flask, Flask-SocketIO
• Frontend: HTML, CSS, JavaScript
• Przetwarzanie PDF: PyPDF2, pdf2image
• Aplikacja mobilna: Android SDK, Gradle
• Komunikacja w czasie rzeczywistym: WebSocket
• Konteneryzacja: Docker

👨‍💻 Współpraca

Wszelkie ulepszenia i zmiany w projekcie są mile widziane! Jeśli masz pomysł jak ulepszyć aplikację, nie wahaj się stworzyć pull request lub zgłosić issue.

1. Zrób fork repozytorium
2. Stwórz swoją gałąź funkcji (git checkout -b feature/amazing-feature)
3. Zatwierdź zmiany (git commit -m 'Dodaj nową funkcję')
4. Wypchnij do gałęzi (git push origin feature/amazing-feature)
5. Otwórz Pull Request

📜 Licencja

Ten projekt jest dostępny na licencji MIT. Zobacz plik LICENSE dla szczegółów.

---

Projekt stworzony z myślą o pracownikach Kolei Dolnośląskich ❤️