🎓 MyUZ Android

Aplikacja mobilna dla studentów Uniwersytetu Zielonogórskiego


Zarządzaj swoim życiem studenckim na UZ w jednej aplikacji ✨

---

📋 O aplikacji

MyUZ Android to mobilna aplikacja stworzona specjalnie dla studentów Uniwersytetu Zielonogórskiego.

🎯 Cel projektu

Aplikacja powstała z potrzeby stworzenia kompleksowego narzędzia do zarządzania życiem studenckim. Zamiast korzystać z wielu różnych platform, kalendarzy i notatników - wszystko masz w jednym miejscu, zawsze pod ręką.

💡 Dlaczego MyUZ?

🎓 Dedykowana dla UZ Stworzona z myślą o specyfice Uniwersytetu Zielonogórskiego	📱 Zawsze pod ręką Twój plan, oceny i zadania w telefonie	☁️ Synchronizacja Dostęp do danych z dowolnego urządzenia
🎨 Nowoczesny design Intuicyjny interfejs oparty na Material Design 3	🔒 Prywatność Dane przechowywane lokalnie i szyfrowane w chmurze	⚡ Szybka i responsywna Zbudowana na najnowszych technologiach Android

🌟 Co wyróżnia tę aplikację?

• ✅ Wszystko w jednym - Plan, oceny, frekwencja i zadania w jednej apce
• ✅ Offline-first - Działa bez internetu, synchronizuje gdy jest połączenie
• ✅ Automatyczne obliczenia - Średnie ważone, statystyki, procenty frekwencji
• ✅ Personalizacja - Jasny/ciemny motyw, konfigurowalne powiadomienia
• ✅ Clean Architecture - Stabilna, skalowalna i łatwa w utrzymaniu
• ✅ 100% Kotlin - Nowoczesny kod napisany w całości w Kotlinie

---

✨ Funkcje

📅 Plan zajęć ✓ Przejrzysty kalendarz z harmonogramem wszystkich zajęć ✓ Widok tygodniowy i dzienny ✓ Szczegóły zajęć: sala, prowadzący, godziny ✓ Synchronizacja z chmurą Supabase	📊 Oceny ✓ Śledzenie wszystkich ocen z przedmiotów ✓ Automatyczne obliczanie średniej ważonej ✓ Szczegółowe informacje o każdym przedmiocie ✓ Wizualizacja postępów w nauce
🚫 Nieobecności ✓ Monitoring frekwencji na zajęciach ✓ Procentowa frekwencja dla każdego przedmiotu ✓ Historia wszystkich nieobecności ✓ Ostrzeżenia o przekroczeniu dopuszczalnego limitu	✅ Zadania (To-Do) ✓ Lista zadań domowych i projektów ✓ Integracja z kalendarzem zajęć ✓ Ustawianie priorytetów i terminów ✓ Oznaczanie wykonanych zadań
⚙️ Ustawienia i personalizacja ✓ Jasny i ciemny motyw aplikacji ✓ Edycja danych studenta (imię, nazwisko, nr albumu) ✓ Konfiguracja powiadomień ✓ Zarządzanie danymi i synchronizacją

---

📲 Instalacja

Wymagania

• Android: 7.0 (API 24) lub nowszy
• Pamięć: ~50 MB

Opcja 1: Pobierz gotowe APK (najłatwiejsza)

Uwaga: Jeśli nie ma jeszcze żadnego release, sprawdź GitHub Actions - tam znajdziesz automatycznie zbudowane APK z ostatniego commita.

Kroki:

1. Przejdź do zakładki Releases
2. Pobierz najnowszy plik APK
3. Na telefonie włącz Instalację z nieznanych źródeł:
   • Ustawienia → Zabezpieczenia → Nieznane źródła (lub podobnie)
4. Otwórz pobrany plik APK i zainstaluj

Opcja 2: Zbuduj z kodu źródłowego

Wymagania:

• Android Studio Hedgehog (2023.1.1) lub nowsze
• JDK 17+
• Android SDK (API 24+)

Kroki:

# 1. Sklonuj repozytorium
git clone https://github.com/lifeoverthinker/my_uz_android.git

# 2. Przejdź do katalogu
cd my_uz_android

# 3. Otwórz w Android Studio
# File → Open → wybierz folder my_uz_android

4. Poczekaj na synchronizację Gradle (może potrwać kilka minut)
5. Podłącz telefon lub uruchom emulator
6. Kliknij Run ▶️ (lub Shift + F10)

Opcja 3: Buduj z terminala

# Debug APK
./gradlew assembleDebug

# Release APK (wymaga podpisania)
./gradlew assembleRelease

# APK znajdziesz w:  app/build/outputs/apk/debug/ lub app/build/outputs/apk/release/

---

🛠️ Technologie

Aplikacja została zbudowana z wykorzystaniem nowoczesnych technologii Android:

📦 Tech Stack
├── 🎨 UI
│   ├── Jetpack Compose (100%)
│   └── Material Design 3
├── 🏗️ Architektura
│   ├── MVVM Pattern
│   └── Clean Architecture
├── 💾 Baza danych
│   └── Room Database
├── ☁️ Backend
│   └── Supabase
├── ⚡ Asynchroniczność
│   ├── Kotlin Coroutines
│   └── Flow
└── 🔧 Inne
    ├── 100% Kotlin
    └── Manual DI

---

📖 Jak korzystać

Pierwsze uruchomienie

1. Zaloguj się - podaj swoje dane studenta UZ
2. Uzupełnij profil - imię, nazwisko, kierunek, rok studiów
3. Zsynchronizuj dane - aplikacja pobierze Twój plan zajęć

Nawigacja

Aplikacja posiada dolny pasek nawigacji z głównymi sekcjami:

🏠 Główna       - Dashboard z podsumowaniem
📅 Kalendarz    - Plan zajęć
📊 Oceny        - Twoje wyniki
🚫 Nieobecności - Frekwencja
✅ Zadania      - Lista to-do
⚙️ Ustawienia   - Konfiguracja

Dodawanie danych

• Oceny: Kliknij + w zakładce Oceny → wybierz przedmiot → wpisz ocenę
• Zadania: Kliknij + w zakładce Zadania → wpisz tytuł i termin
• Nieobecności: Automatycznie śledzone lub dodaj ręcznie

Synchronizacja

Dane są automatycznie synchronizowane z chmurą Supabase po każdej zmianie. Możesz korzystać z aplikacji na wielu urządzeniach.

---

❓ FAQ

❓ Czy aplikacja jest oficjalna?

Nie, to nieoficjalny projekt studencki dla UZ.

🔒 Czy dane są bezpieczne?

Tak, dane są przechowywane lokalnie (Room) i opcjonalnie w Supabase z szyfrowaniem.

📡 Czy mogę używać offline?

Tak, wszystkie dane są dostępne offline. Synchronizacja następuje gdy pojawi się internet.

🔄 Jak zaktualizować aplikację?

Pobierz nową wersję z zakładki Releases i zainstaluj na istniejącą.

🐛 Gdzie zgłosić błąd?

W zakładce Issues tego repozytorium.

📦 Gdzie znajdę APK jeśli nie ma Releases?

Sprawdź GitHub Actions - workflow automatycznie buduje APK przy każdym pushu. Kliknij w najnowszy workflow run i pobierz artifact.

---

🔧 Rozwiązywanie problemów

❌ Aplikacja nie chce się zainstalować

• Upewnij się, że masz Androida 7.0+
• Włącz "Instalację z nieznanych źródeł" w ustawieniach
• Sprawdź czy masz wystarczająco miejsca (~50 MB)

🔑 Nie mogę się zalogować

• Sprawdź połączenie z internetem
• Upewnij się, że wprowadzasz poprawne dane UZ

☁️ Dane się nie synchronizują

• Sprawdź połączenie z internetem
• Sprawdź ustawienia synchronizacji w aplikacji
• Spróbuj wylogować się i zalogować ponownie

---

Autor: @lifeoverthinker

Stworzone z ❤️ dla studentów UZ przy użyciu Kotlin & Jetpack Compose

⭐ Przydatna aplikacja? Zostaw gwiazdkę!