Mimari

Mühendislik ilkelerimiz, olduğu gibi.

Bu sayfa kullandığımız araçların bir logo listesi değil. Her teknik iddianın nerede durduğunu — üretimde mi, geliştirmede mi, yoksa henüz bir tasarım ilkesi mi — açıkça işaretliyoruz.

Üç etiket, tek kural: abartmayız.

Aşağıdaki her madde bu üç etiketten biriyle işaretlenir. Bir teknoloji burada geçiyorsa, bugün hangi olgunlukta olduğunu gizlemeyiz.

Üretimde
Bugün gerçekten çalışıyor ve üzerine güveniliyor.
Aktif geliştirmede
Şu anda inşa ediliyor; henüz tamamlanmadı veya her yerde kullanılmıyor.
Tasarım ilkesi
Doğru bulduğumuz ve inşa ettiğimiz yön; henüz teslim edilmiş bir garanti değil.

Dokuz alan, tek disiplin.

Mimarimizi dokuz alanda anlatıyoruz. İsimler bilinçli olarak genel tutulur — iç proje kod adları değil, yetenek katmanları.

Sözleşme katmanı

Bileşenler arasındaki teknik anlaşmalar kod olarak değil, okunabilir belgeler olarak tutulur.

  • Tasarım ilkesi

    Bileşenler arası teknik sözleşmeler; sürümlü, makine-okunur belgeler (Markdown + JSON Schema) olarak yazılır ve açık kabul kriterleri taşır.

Ajan çalışma zamanı

Bir ajanın ne yapabileceği, açık uçlu değil, tanımlı sınırlar içindedir.

  • Aktif geliştirmede

    Ajanlar, açık uçlu sistem erişimi yerine sınırlandırılmış, tanımlı bir araç kümesiyle çalışır.

  • Tasarım ilkesi

    Yürütme izole oturumlarda gerçekleşir; bileşenler arası yönlendirme tanımlı kurallarla yapılır.

Yönetişim

Kritik eylemler boşlukta değil, tanımlı bir onay ve kayıt katmanından geçer.

  • Aktif geliştirmede

    Bileşenler arası her istek, harekete geçmeden önce merkezi bir onay katmanından geçer.

  • Aktif geliştirmede

    Onay ve red kararları, sonradan incelenebilecek biçimde değiştirilemez bir kayda yazılır.

  • Aktif geliştirmede

    Kritik veya geri dönüşü olmayan eylemler, ayrı bir insan-onayı adımından geçer.

Bilgi erişimi

Kararların ve bağlamın kaybolmaması, yalnızca sohbet geçmişine bırakılmaz.

  • Aktif geliştirmede

    Vektör arama, graf ilişkileri ve anahtar kelime (BM25) aramasını birleştiren hibrit bir erişim yaklaşımı, paylaşılan bir bilgi hizmeti olarak geliştiriliyor.

  • Aktif geliştirmede

    Karar geçmişi ve mimari bağlam, yapılandırılmış bir hafıza olarak tutulmaya çalışılıyor.

Doğrulama

Bir değişikliğin "bitti" sayılması için tanımlı bir doğrulama beklentisi vardır.

  • Tasarım ilkesi

    Değişikliklerin, tamamlanmış sayılmadan önce deterministik ve tekrarlanabilir testlerden geçmesi beklenir.

  • Tasarım ilkesi

    Bir değişikliği yazan oturum ile onu inceleyen oturum ayrı tutulur.

  • Tasarım ilkesi

    Gizli veya "golden" test kümeleri yalnızca gerçekten kullanıldığı projelerde devreye alınır; evrensel bir uygulama olarak sunulmaz.

Platform

Üretim yükleri tek bir sunucuya değil, ortak bir platform katmanına dayanır.

  • Üretimde

    Arka uç servisleri Go ile, arayüz gerektiren yerlerde TypeScript/React ile yazılır.

  • Üretimde

    PostgreSQL standart veri deposu olarak kullanılır; üretim yükleri Kubernetes üzerinde çalışır.

  • Aktif geliştirmede

    Paylaşılan bir mesajlaşma ve gözlemlenebilirlik katmanı geliştiriliyor — henüz her üründe aynı biçimde kullanılmıyor.

Dağıtım seçenekleri

Nerede çalıştığınız tek bir kalıba zorlanmaz.

  • Tasarım ilkesi

    UAIS ürünleri; özel bulut, kendi barındırılan (self-hosted) ortamlar ve yerel çıkarım dahil farklı dağıtım modellerini destekleyecek şekilde tasarlanır. Bir ürünün bugün hangi modeli gerçekten desteklediği, bu sayfada değil ilgili ürünün kendi sayfasında belirtilir.

Güvenlik duruşu

Yetki varsayılan olarak dar tutulur; geniş erişim istisnadır, norm değil.

  • Tasarım ilkesi

    Erişim, varsayılan olarak en az yetki ilkesiyle sınırlandırılır; geniş kapsamlı kalıcı erişim norm değil, istisna olarak ele alınır.

  • Tasarım ilkesi

    Kiracı (tenant) ve çalışma alanı sınırları, yumuşak bir kural değil, sert bir sınır olarak tasarlanır.

  • Tasarım ilkesi

    Kimlik bilgileri ve anahtarlar, servisler arasında çoğaltılmak yerine tek, denetlenebilir bir noktadan yönetilir.

  • Tasarım ilkesi

    Veri, olağan akışın bir parçası olarak şifrelenmesi ve yedeklenmesi beklenen bir varlık olarak ele alınır.

Mimarimiz hakkında daha derin bir teknik konuşma mı istiyorsunuz?

Bu sayfadaki her etiketin arkasında ne olduğunu ve belirli bir ürün için ne anlama geldiğini birebir konuşabiliriz.

Teknik görüşme talep edin