Mühendislik notları

• Eğitim amaçlı bir kum havuzu değil, gerçek bir motor: fizik, yıkım, dinamik ışıklandırma ve akışkan simülasyonu; hepsi kod yazmadan kurgulanıyor
• Tek platformda 2D ve 3D; böylece bir proje başka bir yerde yeniden kurulmadan kapsamını büyütebiliyor
• Varlıklar, mantık ve sahneler için şirket içi atölyeler. Üretim hattının tamamı ürünün içinde yaşıyor; asıl rekabet avantajı da bu
• Platformu tek bir görselleştiriciye bağlamak yerine, tek bir düzenleyicinin arkasına entegre edilmiş iki 3D motoru: Three.js ve Babylon.js
• Eğitim → Deneme alanı → Yayımla → Paylaş; böylece tam bir acemi, ilk oturumunu oynanabilir ve bağlantıyla paylaşılabilir bir şeyle bitiriyor
• Ön imzalı yükleme adresleri üzerinden S3 varlık depolamasıyla birlikte Clerk tabanlı kimlik doğrulama
• Yazılı hata raporu olarak yürütülen kalite süreci; her sorun kök nedeni, çözümü ve doğrulama durumuyla birlikte takip ediliyor

Mühendislik notları

• JustTheMic. Yayıncı sesini ayrı kanallar hâlinde yayımlar (mikrofon, oyun, müzik, konuklar) ve her izleyici kendi dengesini tarayıcıda kendisi kurar. Oyunun sesini kısın, müziği susturun, konuşmayı bırakın. İzleyiciye miksi kontrol ettiren başka kimse yok.
• Canlı altyazı, her izleyici için çevrilmiş hâliyle. OBS eklentisi altyazıları gerçek zamanlı olarak yerelde üretir, platform bunları aktarır, uzantı da o izleyicinin konuştuğu dile çevirir. Tek bir dilde yayın yapan bir yayıncı, hiçbir şeyi farklı yapmadan tüm dillerdeki izleyiciye ulaşır.
• Yerel bir eklenti, bir bulut aktarıcısı ve bir tarayıcı uzantısı, tek bir düşük gecikmeli hat oluşturuyor: üç dağıtım kanalı, üç yayın süreci, tek bir ürün
• Ayrı ayrı herkese açık, teknik ve şirket içi değişiklik kayıtlarıyla 37 numaralı geliştirme aşaması. Yayın süreci sonradan akla gelen bir şey değil, bir sistem
• Sapma geçmişi tutan, elle yazılmış Postgres göç aracı; böylece şema değişiklikleri geri alınabilir ve denetlenebilir
• tmi.js üzerinden gerçek zamanlı Twitch IRC akışı ve bir Discord ses köprüsü; ikisi de yeniden bağlanmalara ve istek sınırlarına dayanıyor
• Üçüncü taraf OAuth belirteçleri için @noble/ciphers ile şifrelenmiş kimlik bilgisi saklama

Mühendislik notları

• Gerçek bir şirket için geliştirildi ve orada kullanıma alındı. Aylık araç giderini ~15.000 $'dan ~500 $'a indiren TutorMax yığınının parçasıydı
• Kullanıcı başına lisanslamayı tamamen ortadan kaldırır. 200. kullanıcıyı eklemenin maliyeti, 20.'yi eklemekle aynıdır
• Kendi sunucunuzda çalıştığı için şirket içi konuşmalar, şirketin sahip olduğu altyapının dışına hiç çıkmaz
• Tek kimlik doğrulama kapısı olarak Firebase Auth; sunucu tarafında Admin SDK ile doğrulanıyor
• Yaşam döngüsü sunucu tarafında yönetilen Daily.co sesli odaları; böylece istemciler hiçbir zaman API kimlik bilgisi tutmuyor
• Web istemcisinin yanında bir Android uygulaması da çıkıyor; böylece ekibe masa başı dışında da ulaşılabiliyor, üstelik ikinci bir kullanıcı başına fatura eklemeden
• Başlangıçta Matrix üzerine kurulmuştu. Ürünün buna ihtiyacı olmadığı netleşince federasyon protokolü tamamen söküldü. Kapsamı daraltmak, batık maliyeti savunmayı yendi.

Mühendislik notları

• Tarayıcıda çalışan Havok fizik simülasyonu; yarış durumunda son sözü sunucu söylüyor
• Tek bir simülasyona iki denetim yolu: sohbetle yönlendirilen yapay zekâ ajanları ve insan sürücülerden gelen canlı WebSocket girdisi
• Oyun istemcisini, API sunucusunu ve paylaşılan tipleri ayıran pnpm çalışma alanı monoreposu
• Babylon sahnesini besleyen özel pist ve doku hattı

Mühendislik notları

• Tek kod tabanı, iki uzantı platformu: Chromium ve Firefox sürümleri tek bir esbuild hattından üretiliyor
• Düşük gecikmeli eş zamanlı dinleme sesi için bir içerik betiğinin içinde çalışan LiveKit WebRTC istemcisi
• Barındıran sayfayı bozmadan, denetlemediği üçüncü taraf bir DOM'a enjekte edilen altyazı ve bindirme çizimi
• Yayıncı denetimindeki özellikler: izleyiciler yalnızca yayıncının açtığını görür

Mühendislik notları

• OBS eklenti API'si üzerine C++; web yığınından farklı bir disiplin ve araç zincirinin bir sınır olmadığının kanıtı
• CMake profilleri ve GitHub Actions ile yeniden üretilebilir, platformlar arası derlemeler
• Dosya yığını ve talimat dolu bir README olarak değil, gerçek bir kurulum dosyası olarak teslim ediliyor

Mühendislik notları

• Herhangi bir oyun motoruna bağlanmadan önce tasarım sorularını yanıtlamak için önce oynanabilir bir tarayıcı prototipi geliştirildi
• İşi, oyun her aşamanın sonunda oynanabilir olacak şekilde sıralayan bir üretim planı
• Temel döngüyü, ekonomiyi ve geri alması pahalı olan kararları kapsayan yazılı tasarım belgeleri

Mühendislik notları

• Bölgeye duyarlı ödeme: hangi ödeme sağlayıcılarının görüneceği alıcının nerede olduğuna bağlı
• Katalog, ödeme ve işlem akışlarının tamamında eksiksiz İngilizce/Türkçe uluslararasılaştırma
• Uluslararası kargo kurallarıyla birlikte çok para birimli fiyatlandırma
• Tek portal, iki farklı kitle: müşterinin sipariş geçmişi ve yönetim CRM'i aynı kabuğun arkasında

Mühendislik notları

• Ortak veri üzerinde, talep eden ve yerine getiren için ayrı akışlara sahip çift taraflı pazar yeri
• Doğrulama ve ödeme adımlarında yönetici hakemliği bulunan kampanya durum makinesi
• Ücretli işi kimin kabul edebileceğini belirleyen üretici doğrulama hattı

Mühendislik notları

• Fiş fotoğraflarından toplamları çıkarmak için Google Cloud Vision OCR ve yerel bir Tesseract yolu
• Kazanç analitiğini besleyen vardiya takibi: saatlik ücret, en iyi vardiyalar, zaman içindeki eğilim
• Stripe üzerinden faturalanan ücretsiz ve ücretli paketler
• Sahanın gerçek iş akışından yola çıkılarak geliştirildi. Kullananlar vardiyanın ortasında, tek elle ve acele hâlde

Mühendislik notları

• Aylık ~14.500 $ işletme giderinden çıkarıldı, yılda yaklaşık 174.000 $; kiralık araçların yerine şirketin tamamen sahibi olduğu yazılım konularak
• Toplantılar kendiliğinden talebe dönüştü. Yapay zekâ, haftalık müşteri görüşmesi dökümlerini Fathom API'si üzerinden çekiyor, gerçekten neyin konuşulduğunu okuyor, dile getirilen sorunları tespit ediyor ve kimse not tutmadan teknik destek için talep açıyordu.
• Bilgi tabanı kendi kendini yazdı. Aynı işlem, konuşma sırasında ortaya çıkan ama hiç belgelenmeyen çözümleri ve bağlamı çıkarıp bilgi tabanına işliyordu; böylece cevabın var olduğu ama yalnızca birinin aklında durduğu sorun çözüldü.
• Şirket içi belgelerle eğitildi; böylece ürettiği çıktı, şirketin kendi sistemlerini gerçekte nasıl anlattığıyla örtüşüyordu
• Her departmana bağlanmış şirket içi bir sinir ağı: sistemlerin tamamı şirkete ait olduğu için tek bir model toplantıları, sohbeti, talepleri, görüşmeleri, satışı ve muhasebeyi aynı anda okuyabiliyordu. İki ila üç aylık öğrenme döneminin ardından üst yönetimin sorularını istendiğinde yanıtladı ve yönetimin hiç haberdar olmadığı tekrar eden sorunları gün yüzüne çıkardı.
• Model kendiliğinden yukarı taşıyordu: bir kez dile getirilen şikâyet not ediliyor, tekrarlayan şikâyet gündeme getiriliyor, şirket içi araçlarda mevcut bir çözüm var mı diye kontrol ediliyor ve yoksa talep olarak açılıyordu
• Çift kitleli Kanban: müşteriler kendi taleplerinin ilerlemesini izliyor, yorum yapıyor ve sorun kendiliğinden çözüldüğünde kapatıyordu; bu sırada şirket içi teknik tartışma gizli kalıyor, genel müdür ise her iki görünümün gözetimini elinde tutuyordu
• Tek bir içerik modelinden ayrı şirket içi ve dışa açık bilgi tabanları; böylece bir kez yazılan çözüm hem teknik ekibe hem müşteriye hizmet ediyordu
• Alan adına göre yönlendirme: portal.*, help.* ve ana alan adı, tek bir kod tabanı ve tek bir dağıtımdan tamamen farklı rota kümeleri ve kimlik doğrulama düzenleri sunuyordu

Mühendislik notları

• React istemcisini Express 5 API'sinden ayıran, Node 24 üzerinde pnpm çalışma alanı monoreposu
• Yemek yaparken adımlar arasında gezinmek için sesli kontrol
• Alışveriş listelerini otomatik oluşturmak için kiler durumunun tarif gereksinimleriyle karşılaştırılması