FiloHub — Araç Kiralama Yönetim Sistemi
Kiralama yaşam döngüsünü, filo ve finans operasyonlarını yönetim paneli + saha mobil uygulamasıyla uçtan uca dijitalleştiren rent a car platformu
Proje ne yapıyor?
FiloHub, araç kiralama firmalarının uçtan uca operasyonlarını dijitalleştiren monorepo bir platformdur. Üç ana yüzeyi var: ofis/yönetici için Vue yönetim paneli (kiralama oluşturma, müşteri & filo yönetimi, fiyatlandırma, raporlama, finans), saha personeli için Flutter mobil uygulaması (teslim/iade, fotoğraf, sözleşme imzası, aktif kiralama takibi) ve her iki istemciye hizmet veren iki ayrı Go API.
Kiralama yaşam döngüsü dört aşamalıdır: Taslak (müsait araç seçimi, sürücü ekleme, fiyatlandırma, depozito) → Aktif (km/yakıt kaydı ve 4 zorunlu fotoğrafla teslim, uzatma, ek masraf) → İade (km aşımı, yakıt farkı ve gecikme hesaplaması, fotoğraflar, sözleşme) → Kapanış (finansal özet, fatura, raporlama). Ayrıca şube & transfer, müşteri skor tablosu/kara liste, filo uyarıları, bakım takvimi, sezonluk fiyatlandırma, kasa/tahsilat ve çoklu rapor modülleri bulunur.
Problem ve Çözüm
Kiralama süreçleri — müsaitlik, teslim/iade, fiyat hesabı, sözleşme, depozito, filo takibi — çoğu firmada dağınık araçlarla veya manuel yürütülür. Saha ile ofis arasında veri kopukluğu yaşanır; mevcut sistemlerde API yanıtları yavaştır.
FiloHub tüm akışı tek platformda topladı: panel ve mobil, pkg/rentalops altındaki ortak iş kurallarını paylaşır; teslim/iade fotoğrafları, dijital imza, otomatik ücret hesabı ve sözleşme üretimi süreçle birlikte ilerler. E-posta, SMS ve bildirimler RabbitMQ ile arka planda işlenir — proje dokümantasyonunda API yanıt süresinin 2–5 saniyeden ~110 ms'ye indiği, bağlantıların PgBouncer ile 25 havuzlanmış bağlantıda sabitlendiği raporlanmıştır.
Mimari — 3 Bileşen
Yönetim Paneli
Vue 3.4 + Vite 5 + PrimeVue + Vuex 4. Kiralama oluşturma, müşteri & filo yönetimi, sezonluk fiyatlandırma, kasa/tahsilat, faturalar ve çoklu rapor: kârlılık, şube karşılaştırma, müşteri segmentasyonu.
Saha Uygulaması
Flutter/Dart 3.7+ (Riverpod, GetIt, GoRouter, Dio). Teslim ve iadede km/yakıt kaydı, 4 zorunlu fotoğraf, sözleşme imzası; aktif kiralamaların saha personeli tarafından takibi.
API'ler & Ortak Katman
Ayrı Panel API (/panel) ve Mobil API (/api): Go 1.23+ + Fiber v2 + Bun ORM. Paylaşılan model/, repository/, pkg/rentalops/ (iş kuralları) ve pkg/contract/ (sözleşme) katmanları; PgBouncer, RabbitMQ, ClickHouse.
Teknolojiler
| Mobil API | Go 1.23+, Fiber v2, Bun ORM |
|---|---|
| Panel API | Go 1.23+, Fiber v2, Bun ORM |
| Mobil uygulama | Flutter/Dart 3.7+, Riverpod, GetIt, GoRouter, Dio |
| Yönetim paneli | Vue 3.4, Vite 5, PrimeVue, Vuex 4, Axios |
| Veritabanı | PostgreSQL (PgBouncer ile connection pooling) |
| Mesaj kuyruğu | RabbitMQ — e-posta, SMS, bildirim (asenkron) |
| Audit / analitik | ClickHouse |
| Altyapı | Docker, Nginx reverse proxy, Portainer |
| Paylaşılan katman | model/, repository/, pkg/rentalops/ (iş kuralları), pkg/contract/ (sözleşme) |
Ölçülebilir Sonuçlar
Önceki sisteme göre
Uçtan uca
Taslak → Aktif → İade → Kapanış: fotoğraf, imza, otomatik ücret hesabı ve sözleşme üretimi tek akışta
4 fotoğraf
Zorunlu teslim/iade fotoğraflama — hasar ihtilaflarında kanıt
~110 ms
Dokümante edilen API yanıt süresi — 2–5 saniyeden (RabbitMQ async + PgBouncer)
Raporlama
Kârlılık, şube karşılaştırma, müşteri segmentasyonu; skor tablosu ve kara liste
Aklınızdaki projeyi birlikte hayata geçirelim
Mobil uygulamadan (iOS & Android) web panellerine, Go ile ölçeklenebilir backend ve API geliştirmeden saha çözümlerine kadar uçtan uca yazılım geliştiriyorum. Yeni bir ürün, mevcut bir sistemin yenilenmesi ya da tek bir modül — freelance ve proje bazlı çalışmaya uygunum.