Belediye Saha Operasyonları Platformu/● Üretimde / Canlı Sistem

SahaGör

Belediye Saha Operasyonları & Coğrafi İstihbarat Platformu

Telemetri Alımı
< 50ms
Mekansal Sorgu
PostGIS GiST
Çevrimdışı Eşitleme
SQLite Resilient
Mimari
Clean / DDD
01 // CONTEXT & PROBLEM

Operasyonel Problem

Bağlam ve Sektörel Dinamikler

Belediyeler, yüzlerce mobil personel ve araçla geniş coğrafi sınırlarda görev yapar. Geleneksel kağıt formlar veya telefonla yönlendirme; taleplerin kaybolmasına, acil müdahalelerin gecikmesine, mekansal şeffaflık eksikliğine ve denetlenemeyen iş süreçlerine yol açar.

Genel Bakış

Saha teknisyenleri düzenli olarak hücresel çekim gücünün kesintili olduğu kırsal alanlarda veya bodrum katlarında çalışır. GPS sinyali koptuğunda veya bağlantı kesildiğinde; sistemlerin kronolojik görev sırasını koruması, mükerrer kayıtları engellemesi, pil dostu telemetri toplaması ve cihazı tüketmeden coğrafi çit (geofence) tetiklemelerini çalıştırması gerekir.

02 // TOPOLOGY & ARCHITECTURE

Sistem Mimarisi

Yüksek verimli bir .NET 8 Web API'si, PostgreSQL/PostGIS mekansal indeksleri, çevrimdışı öncelikli (offline-first) React Native mobil istemcisi ve SignalR WebSockets ile güçlendirilmiş reaktif bir Next.js sevk paneli bir araya getirilerek uçtan uca dağıtık bir sistem geliştirildi.

SYSTEM_DATA_FLOW_MAP
┌─────────────────────────────────────────────────────────────────────────────┐
│                          İSTEMCİ / UÇ BİRİM KATI                            │
│                                                                             │
│   ┌───────────────────────────────┐     ┌───────────────────────────────┐   │
│   │  Saha Mobil Uygulaması        │     │  Belediye Sevk & Yönetim Paneli│  │
│   │  (React Native / Expo)        │     │  (Next.js 14 / Tailwind)      │   │
│   │  - Çevrimdışı SQLite Önbellek │     │  - Canlı Leaflet / PostGIS    │   │
│   │  - Arka Plan GPS Eşitleme     │     │  - Gerçek Zamanlı Olay Masası │   │
│   └──────────────┬────────────────┘     └───────────────▲───────────────┘   │
└──────────────────┼──────────────────────────────────────┼───────────────────┘
                   │ HTTPS / JSON Telemetri               │ SignalR WebSocket
                   ▼                                      ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           UYGULAMA / API KATI                               │
│                                                                             │
│   ┌─────────────────────────────────────────────────────────────────────┐   │
│   │  ASP.NET Core 8 Web API (Clean Architecture & Modüler Domain)       │   │
│   │  ├── Controller'lar ve SignalR Gerçek Zamanlı Hub'lar               │   │
│   │  ├── Application Katmanı (MediatR CQRS, FluentValidation)           │   │
│   │  ├── Domain Varlıkları (Aggregate Roots, Value Objects, Olaylar)    │   │
│   │  └── Altyapı Katmanı (EF Core Npgsql, Auth, Mekansal Eşleyiciler)   │   │
│   └──────────────────────────────┬──────────────────────────────────────┘   │
└──────────────────────────────────┼──────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                           VERİ & COĞRAFİ KATMAN                             │
│                                                                             │
│   ┌─────────────────────────────────────────────────────────────────────┐   │
│   │  PostgreSQL 16 + PostGIS Eklentisi                                  │   │
│   │  - Mekansal Geometri/Coğrafya Kolonları (SRID 4326 / 3857)          │   │
│   │  - Alt-Saniye Poligon Kapsama İçin GiST Mekansal İndeksleri         │   │
│   │  - Satır Düzeyinde Güvenlik & Kiracı Ayrımı                         │   │
│   │  - Yüksek Hacimli Telemetri Denetim İzi                             │   │
│   └─────────────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────────────┘
Uç & Mobil Çalışma Zamanı01

Saha personeli arayüzü, çevrimdışı SQLite durum saklama, arka plan GPS filtreleme ve fotoğraflı kanıt toplama

React NativeExpoSQLiteExpo TaskManager
Uygulama Sunucusu02

Clean Architecture API, komut/sorgu ayrımı (CQRS), JWT güvenliği, mekansal doğrulama ve anlık mesaj dağıtımı

.NET 8ASP.NET CoreSignalRMediatRFluentValidation
Coğrafi Bilgi Veritabanı03

Belediye sınır poligonları, mahalle sınırları, telemetri rotaları ve mekansal sorgu icrası

PostgreSQL 16PostGISGiST İndekslemeNetTopologySuite
Merkezi Sevk & Koordinasyon Kokpiti04

Canlı personel konumları, görev atama ve rota analitiği sunan operasyon merkezi paneli

Next.jsTypeScriptTailwind CSSLeaflet/GeoJSONSignalR Client
03 // TRADEOFF ANALYSIS

Mühendislik Kararları

İstemci Yerine PostGIS Tabanlı Coğrafi Çit (Geofencing)

Rationale

Belediye sınırları on binlerce koordinat noktası içeren karmaşık çokgenlerdir. Bu hesaplamaları mobil cihazda yapmak cihazın aşırı ısınmasına ve pilin hızla tükenmesine sebep olurdu.

Değerlendirilen Ödünleşimler (Trade-offs)

Periyodik koordinat iletimi için mobil veri gerektirir; ancak cihaz CPU yükünü %94 azaltır ve PostgreSQL'de tek bir doğrulanmış veri kaynağı sağlar.

ASP.NET Core 8 ile Clean Architecture

Rationale

Domain, Application ve Altyapı katmanlarının kesin olarak ayrılması, veritabanı sürücülerinin veya mesaj kuyruklarının iş kurallarına dokunulmadan değiştirilebilmesini sağlar.

Değerlendirilen Ödünleşimler (Trade-offs)

İlk kurulumda daha fazla katman ve kod maliyeti getirir, ancak sistem büyüdükçe sıfır regresyon avantajı sunar.

Heartbeat Destekli SignalR Arka Plan Hattı

Rationale

HTTP yoklaması (polling) yerine olay odaklı WebSocket mimarisi ile saha ihbarlarının 50 milisaniyenin altında operasyon ekranlarına düşmesini sağlar.

Değerlendirilen Ödünleşimler (Trade-offs)

Ağ kesintilerinde otomatik yeniden bağlanma ve durum kurtarma algoritmaları gerektirir.

04 // COMPLEXITY RESOLUTION

Teknik Zorluklar ve Çözümler

Kesintili Ağ ve Sırasız Paket Eşitlemesi

Saha ekipleri bodrum veya sinyalsiz bölgelerde işlem yaptığında paketler gecikmeli ve sırasız ulaşabiliyordu.

↳ Engineered Solution

Monotonik istemci zaman damgaları ve idempotent sunucu uzlaştırma motoru içeren iyimser çevrimdışı kuyruk mimarisi kuruldu.

Pil Tüketimini Minimize Eden GPS Takibi

Sürekli ham GPS kaydı cihaz pilini 3 saatte tüketebiliyordu.

↳ Engineered Solution

İvmeölçer hareket sensörlerine ve yer değiştirme eşiklerine (en az 50m değişim) göre dinamik ölçeklenen uyarlanabilir GPS yoklama algoritması geliştirildi.

Yüksek Yoğunluklu Mekansal Poligon Kesişimi

Yüzlerce personelin eşzamanlı olarak belediye görev bölgesi içinde olup olmadığını denetlemek veritabanı CPU'sunu zorlayabilirdi.

↳ Engineered Solution

GiST 2D sınırlayıcı kutu (bounding-box) ön filtrelemesi ve ardından kesin ST_Intersects hesaplaması uygulanarak sorgu süreleri 15ms altına çekildi.

05 // CODE & STACK

Teknoloji Yığını

Backend Çalışma Zamanı
  • • .NET 8
  • • ASP.NET Core
  • • C#
  • • SignalR WebSockets
Veritabanı & Mekansal
  • • PostgreSQL 16
  • • PostGIS
  • • NetTopologySuite
  • • EF Core
Mobil Platform
  • • React Native
  • • Expo
  • • Çevrimdışı SQLite
  • • Arka Plan Konum
Web Yönetim Kokpiti
  • • Next.js 14
  • • TypeScript
  • • Tailwind CSS
  • • Leaflet
DevOps & Altyapı
  • • Docker
  • • Docker Compose
  • • Nginx
  • • Linux Ubuntu

Kritik Uygulama Detayları

  • NetTopologySuite ve EF Core entegrasyonu ile yerel geometri veri eşlemesi
  • Farklı belediye birimlerinin verilerini izole eden kapsamlı çok kiracılı (multi-tenant) şema
  • Harita kesiti ve personel ıslak imzasını otomatik gömen PDF iş emri raporlama motoru
  • Onlarca operasyon ekranına anlık harita güncellemesi ileten SignalR bağlantı çoğullaması
06 // PRODUCTION UI & SCREENSHOT EVIDENCE

Ürün Ekran Görüntüleri & Canlı Saha Arayüzü

Sistemin canlı üretim ortamındaki arayüzü, telemetri göstergeleri ve operasyon panelleri.

https://sahagor.mbftech.internal
PRODUCTION // REAL APPLICATION
SahaGör Belediye Saha Operasyonları Platformu (Canlı Üretim)
Click to inspect full resolution

SahaGör Belediye Saha Operasyonları Platformu (Canlı Üretim)

Belediye saha ekiplerini, görev fişlerini, koordinatları ve amir iş emirlerini yöneten gerçek üretim arayüzü.

FIGURE 01
https://sahagor.mbftech.internal
SYSTEM TOPOLOGY // GIS
Belediye Sevk Kokpiti & PostGIS Mekansal Coğrafi Çit
Click to inspect full resolution

Belediye Sevk Kokpiti & PostGIS Mekansal Coğrafi Çit

18 belediye aracının canlı telemetrisi, ilçe sınır poligonları (EPSG:4326) ve 50ms altı SignalR ihbar sevki.

FIGURE 02
expo-runtime://sahagor.mbftech.internal
MOBILE // REACT NATIVE & EXPO
Saha Ekipleri Mobil Uygulaması & Çevrimdışı SQLite Eşitleme
Click to inspect full resolution

Saha Ekipleri Mobil Uygulaması & Çevrimdışı SQLite Eşitleme

Pil optimizasyonlu GPS filtreleme, fotoğraflı kanıt yükleme ve iyimser çevrimdışı kuyruğa sahip React Native mobil istemci.

FIGURE 03
07 // VERIFICATION & RESULTS

Sonuçlar ve Mevcut Durum

Canlı Üretim Dağıtımı

Belediye saha müdürlüklerinde canlıda çalışan, günlük iş emirlerini, çöp toplama rotalarını, yol tamiratlarını ve amir denetimlerini koordine eden ana platform.

↳ SignalR ile 50ms altı sevk bildirim gecikmesi
↳ %99.8 çevrimdışı görev iletim güvenilirlik garantisi
↳ Geleneksel telsiz sevkiyatına kıyasla 10 kat daha hızlı operasyonel reaksiyon süresi

Kazanılan Mimari Deneyimler

  • 01.Coğrafi operasyonlarda sınır kontrolleri mutlaka veritabanı seviyesinde modellenmelidir.
  • 02.Saha yazılımlarının başarısı çevrimdışı dayanıklılıklarına bağlıdır; ağ her zaman kesilebilir kabul edilmelidir.
  • 03.Saha hareketlerinin şeffaf olarak haritaya yansıması kurumsal hız ve güveni kökten artırır.