https://github.com/erendogan6/unilist
Türkiye'deki üniversiteler hakkında bilgi sağlayan bir mobil uygulama
https://github.com/erendogan6/unilist
android coroutines hilt jetpack-android kotlin mvvm okhttp paging3 retrofit room solid
Last synced: about 2 months ago
JSON representation
Türkiye'deki üniversiteler hakkında bilgi sağlayan bir mobil uygulama
- Host: GitHub
- URL: https://github.com/erendogan6/unilist
- Owner: erendogan6
- License: mit
- Created: 2024-04-23T12:00:21.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-26T21:59:24.000Z (about 2 years ago)
- Last Synced: 2025-04-05T01:41:58.747Z (about 1 year ago)
- Topics: android, coroutines, hilt, jetpack-android, kotlin, mvvm, okhttp, paging3, retrofit, room, solid
- Language: Kotlin
- Homepage:
- Size: 8.09 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Uni List - Üniversite Listeleme Uygulaması
## Proje Hakkında
UniList, Türkiye'deki üniversiteler hakkında bilgi sağlayan bir mobil uygulamadır. Kullanıcılar, üniversiteleri keşfetmek, favorilere eklemek ve çeşitli üniversite bilgilerine hızlı erişim sağlamak için bu uygulamayı kullanabilirler.
## Kullanım Videosu
[](https://www.youtube.com/watch?v=rE5Q879b0PA "UniList Kullanım Videosu")
## Özellikler
- **Üniversite Listeleme:** Türkiye'deki tüm üniversitelerin bir listesini gösterir.
- **Detaylı Bilgi:** Her bir üniversitenin detaylı bilgilerine (telefon, faks, web sitesi, adres ve rektör bilgileri) erişim sağlar.
- **Favoriler:** Kullanıcılar, beğendikleri üniversiteleri favorilere ekleyebilir.
- **Lazy Loading:** Üniversite listeleri sayfalama yapısı ile yüklenir, böylece kullanıcılar listeyi aşağı doğru çekerek yeni üniversiteleri görebilir.
- **Responsive Tasarım:** Uygulama hem dikey hem yatay modda sorunsuz çalışacak şekilde tasarlanmıştır.
- **Harita Entegrasyonu:** Üniversitelerin adreslerine tıklandığında, konumları Google Maps üzerinde gösterilir.
- **WebView Entegrasyonu:** Üniversitelerin web siteleri doğrudan uygulama içinde bir WebView aracılığıyla erişilebilir.
- **Arama Entegrasyonu:** Üniversitelerin telefon numarasına tıklandığında, aramaya hazır bir halde çağrı ekranı açılır.
## Kullanılan Teknolojiler
- Kotlin
- MVVM (Model, View, Viewmodel) Architect
- SOLID Principles
- Coroutine
- Android Jetpack (Navigation, LiveData, ViewModel, Room Database, Paging)
- Hilt Dependency Injection
- UI/UX
- Fragment
- View Binding
- Recycler View
- Material Design Components
- Singleton Design Pattern
- OkHTTP
- Retrofit
- API (Invio)
- Paging Adaptor
## Test Edilen Sürümler
- Android 9.0
- Android 11.0
- Android 13.0
- Android 14.0
## Kurulum
- Uygulamayı kullanmak için öncelikle Android Studio'yu bilgisayarınıza kurmanız gerekmektedir. Daha sonra aşağıdaki adımları takip edebilirsiniz:
- Bu repoyu yerel makinenize klonlayın:
```bash
git clone https://github.com/erendogan6/UniList.git
```
- Android Studio'yu açın ve "Open an existing project" seçeneğini kullanarak indirdiğiniz projeyi seçin.
- Projeyi açtıktan sonra gereken bağımlılıkların indirilmesini bekleyin.
- Uygulamayı bir Android cihazda veya emülatörde çalıştırın.
- Uygulamayı doğrudan Android cihazınızda çalıştırabilmek için "UniList.apk" dosyasını indirip uygulamayı cihazınıza kurabilirsiniz.
# UniList Kullanım Kılavuzu
## Başlarken
Uygulamayı ilk açtığınızda, ana ekran sizleri karşılayacaktır. Ana ekran, çeşitli üniversitelerin listelendiği bir arayüzü içerir.
### Ana Sayfa
- Ana sayfada, üniversiteler bir liste halinde gösterilir.
- Her bir üniversite kartı, üniversitenin adını, şehir bilgisini ve favorilere ekleme ikonunu içerir.
- Üniversite adına tıklayarak üniversitenin detay sayfasına erişebilirsiniz.
### Üniversite Detayları
- Detay sayfasında üniversitenin adresi, telefon numarası, faks numarası, web sitesi ve rektör bilgileri yer alır.
- Adres üzerine tıkladığınızda, konum Google Haritalar üzerinden açılır ve üniversitenin yerini görebilirsiniz.
- Telefon numarasına tıkladığınızda, cihazınızın arama ekranı açılır ve numara otomatik olarak çevrilmeye hazır hale gelir.
- Web sitesi linkine tıkladığınızda, uygulama içi bir tarayıcıda üniversitenin web sitesi açılır.
### Favoriler
- Ana sayfada, favori ikonuna tıklayarak üniversiteleri favorilerinize ekleyebilirsiniz.
- Favorilere eklenen üniversiteler, Favoriler sayfasında görüntülenir.
- Favoriler sayfasına erişmek için, ana sayfanın üst kısmındaki favori ikonuna tıklayınız.
## Katkıda Bulunma ##
Projeye katkıda bulunmak isteyenler için katkı kuralları ve adımları CONTRIBUTING.md dosyasında açıklanmıştır.
## Lisans ##
Bu proje MIT Lisansı altında lisanslanmıştır.