TEKNOLOJİLER / MİMARİ

Mimari,
moda değil.

Teknoloji seçimlerimizi trendlere göre değil; operasyonun hızına, bağlantı koşullarına ve bakım maliyetine göre yapıyoruz.

TASARIM İLKELERİ

04katman

01ortak sözleşme

0gereksiz soyutlama

Küçük ekipler için tasarlanmış bir mimari: anlaşılabilir sınırlar, öngörülebilir davranış ve düşük operasyon yükü.

01 / YAKLAŞIM

Sistem, bağlantı koptuğunda
çalışmaya devam etmeli.

Ürünlerimizin çoğu; kalabalık bir salon, hareket halindeki bir danışman veya dalgalı bir ağ bağlantısı gibi öngörülemez koşullarda çalışır. Bu yüzden dayanıklılığı sonradan eklenen bir özellik değil, ilk mimari karar olarak ele alıyoruz.

Flutter istemciler, Python/FastAPI servisleri ve cihaz üzerinde çalışan SQLite kuyrukları; aynı olay sözleşmesi etrafında birleşir. Ağ yoksa deneyim devam eder, ağ dönünce sistem kaldığı yerden senkronize olur.

02 / RUNTIME HARİTASI

Dört katman, tek akış.

Her katman kendi sorumluluğunu taşır; üst katmanlar alttaki karmaşıklığı görmez. Bu, hem geliştirmeyi hem de arıza ayıklamayı sadeleştirir.

Deneyim

Flutter, kiosk arayüzü, web konsolu

FlutterAlpine.jsTailwind

→

Edge

API sözleşmesi, oturum, canlı olay yayını

FastAPIWebSocketJWT

→

Servisler

Kuyruk, kimlik, yönlendirme, bildirim

PythonPydanticDomain

→

Veri

Yerel kuyruk, olay günlüğü, delta senkronizasyon

SQLiteWALOutbox

Contract-first Offline-first Observable by design MDR RUNTIME / v1.4

03 / MÜHENDİSLİK

Dört karar disiplini.

Mimari, diyagramlardan çok günlük kararlarda yaşar. Bu dört disiplin, kodun nasıl evrileceğini belirler.

Sözleşme önce gelir

API şeması, olay isimleri ve hata kodları kod yazılmadan önce netleşir. İstemciler aynı sözleşmeyi konuşur.

OpenAPI · Pydantic

Çevrimdışı varsayılan

Kritik yazma işlemleri yerelde tamamlanır; ağ döndüğünde idempotent biçimde sunucuya taşınır.

Outbox · Delta sync

Gözlemlenebilir tasarım

Her kritik akış, bir olay kaydı ve ölçülebilir bir metrik bırakır. Arıza, kullanıcıdan önce sistem tarafından görülür.

Structured logs · Health

Güvenli varsayılanlar

Secret'lar koddan ayrılır; erişim rollerle sınırlanır; hassas işlemler değiştirilemez kayıt bırakır.

RBAC · Audit trail

04 / STACK MATRİSİ

Araçlar değil,
sorumluluklar.

Her katmanın birincil teknolojisi ve neden seçildiği. Yeni bir araç ancak mevcut sınırı daha iyi taşıyorsa eklenir.

contract / queue.snapshot200 OK

{
  "ticket": "A—104",
  "state": "called",
  "eta_seconds": 480,
  "location": "ist-01"
}

KatmanAraçlarNeden

İstemciFlutter · Dart · Material 3Tek kod tabanı, güçlü yerel performans

WebJinja · Alpine.js · TailwindHafif, sunucu odaklı, hızlı yüklenen yüzeyler

ServisPython · FastAPI · PydanticTip güvenliği, hız ve net sözleşmeler

Canlı veriWebSocket · REST fallbackAnlık kuyruk, kopan bağlantıya dayanıklılık

VeriSQLite / WAL · olay günlüğüGömülü, taşınabilir, çevrimdışı hazır

OperasyonDocker · Uvicorn · health checksTekrarlanabilir dağıtım, hızlı teşhis

KaliteOpenAPI · type hints · contract testsKırılmaları erken yakalayan sözleşmeler

05 / GÜVENLİK & DAYANIKLILIK

Kritik sistemler için
sakin varsayılanlar.

Güvenlik bir özellik değil, çalışma biçimidir. Kimlik doğrulama, yetkilendirme ve denetim izi; ürünün ilk sürümünden itibaren tasarımın parçasıdır.

Teknik detayları konuşalım ↗

Rol bazlı erişim

Her işlem, rol ve kapsam üzerinden doğrulanır.

Secret ayrımı

Kimlik bilgileri koddan ve istemciden ayrı tutulur.

Idempotent akışlar

Tekrarlanan istekler veri çoğaltmaz; senkronizasyon güvenlidir.

Denetim izi

Kritik değişiklikler değiştirilemez olay kayıtları bırakır.

Mimari,moda değil.

Sistem, bağlantı koptuğunda çalışmaya devam etmeli.