# OTÜCep — OSTİM Teknik Üniversitesi Öğrenci Uygulaması

> OSTİM Teknik Üniversitesi (OSTİM Technical University, Ankara) öğrencileri için resmi mobil ve web uygulaması. Yemekhane menüsü, ders programı, sınav takvimi, kütüphane doluluk, otopark araç kaydı, akademik takvim, kayıp eşya, anketler, sosyal ağ (OtüSocial), pazar (ikinci el ve ödünç), çalışma odası rezervasyonu, dijital cüzdan, danışman randevu sistemi ve OtuFix sorun bildirimi gibi tüm öğrenci ihtiyaçlarını tek çatı altında toplar. Android, iOS ve web platformlarında yayında.

OTÜCep (Türkçe: "OSTİM Teknik Üniversitesi Cep") — geliştirici Anıl Akpınar (akpinar.dev) tarafından üretim ortamı için Flutter (mobil + web) ve FastAPI (backend) ile geliştirildi. PostgreSQL veritabanı + Redis cache + Kubernetes altyapısı kullanır. Cloudflare Tunnel üzerinden dağıtılır.

## Erişim Noktaları

- [Ana web arayüzü](https://otucep.akpinar.dev/): Tüm uygulama özelliklerine tarayıcıdan erişim
- [Destek](https://otucep.akpinar.dev/destek): Kullanıcı desteği ve geri bildirim
- [Gizlilik politikası](https://otucep.akpinar.dev/privacy): KVKK uyumlu gizlilik bildirimi
- [Hesap silme](https://otucep.akpinar.dev/hesap-silme): Hesap silme talebi (Google Play / Apple App Store gerekliliği)
- [Pazarlama sayfası](https://otucep.akpinar.dev/uygulama): Uygulama özetleri ve ekran görüntüleri

## Mobil Uygulama Mağazaları

- Google Play Store: applicationId `dev.akpinar.otucep`
- Apple App Store: yayınlanmakta

## Özellikler (Detaylı)

### Akademik
- **Ders programı**: Haftalık ders takvimi, hoca ve sınıf bilgisi
- **Sınav takvimi**: Vize/final tarihleri, sınıf atamaları
- **Akademik takvim**: Üniversite resmi takvimi (önlisans, YDYO, azami süre, genel)

### Kampüs Hayatı
- **Yemekhane (Cafeteria)**: Günlük menü, puanlama, sipariş, askıda yemek sistemi, çoklu yemekhane operatörü
- **Otopark**: Plaka kaydı ile araç park sistemi
- **Kütüphane**: Doluluk tespiti (WiFi BSSID tabanlı, gerçek zamanlı), çalışma odası rezervasyonu
- **EGO Otobüs**: Kampüs çevresi durakları (20508, 20510, 20500, 20509, 20503, 21814) gerçek zamanlı

### Sosyal
- **OtüSocial**: Davet kodlu sosyal ağ, topluluklar, gönderiler, profil
- **Pazar (Marketplace)**: İkinci el ürün satışı, ödünç verme/alma sistemi
- **Etkinlikler ve duyurular**: Üniversite duyuruları ve etkinlikler

### Kişisel
- **Dijital cüzdan**: Yemekhane ve diğer harcamalar için dijital ödeme (EsnekPos entegrasyonu)
- **Randevu sistemi**: Danışman/akademisyen randevuları
- **Bildirimler**: Polling tabanlı push (Firebase yok)
- **Hava durumu**: Kampüs konumu için anlık hava durumu

### Destek ve Geri Bildirim
- **OtuFix**: Kampüs sorunlarını bildirme (soft delete, fotoğraflı)
- **Görüş ve öneri formu**: Genel geri bildirim
- **Anketler (Surveys)**: Öğrenci anketleri
- **Kayıp eşya (Lost & Found)**: Bulunan/kayıp eşya ilanları

## Geliştirici

- **Geliştirici**: Anıl Akpınar (4ni1ak) — DevOps Engineer & Full-Stack Developer
- **Geliştirici sitesi**: https://akpinar.dev
- **Üniversite resmi sitesi**: https://www.ostimteknik.edu.tr

## Teknik Altyapı (kamuya açık özet)

- Frontend: Flutter (Dart) — Android, iOS, Web tek kod tabanı
- Backend: FastAPI (Python), PostgreSQL 18, Redis
- Auth: Google OAuth, Microsoft OAuth (WebView), Apple Sign-In
- Deployment: Kubernetes (kubeadm), NGINX Ingress, Cloudflare Tunnel
- CI/CD: GitHub Actions