jstanbul / Mühendislik el kitabı
İlk konuşmadan yayın sonrasına kadar kararları, teknik tercihleri ve sorumlulukları görünür kılan çalışma biçimimiz.
İyi bir dijital deneyim, güzel bir ekranla bitmez. Doğru problem, anlaşılır bir arayüz ve güvenilir bir sistem aynı kararın parçalarıdır.
İhtiyacı anlarız
İşinizi, hedef kitlenizi ve ziyaretçinin yapmak istediği işi konuşuruz. Var olan siteyi, içerikleri ve teknik bağımlılıkları inceleriz. Başarıyı yalnızca görünüşle tarif etmeyiz: bulunabilirlik, anlaşılma, dönüşüm ve işletilebilirlik de brief’in parçasıdır. Ölçemeyeceğimiz bir vaadi başarı kriteri diye yazmayız.
Belirsizliği azaltırız
Sayfalar, içerikler, entegrasyonlar, teslimler, revizyonlar ve takvim teklifte açıkça yer alır. Bir veri kaynağı veya API henüz incelenmemişse uygunluğunu varsaymayız. İlk yıl bakım, alan adı, barındırma ve model kullanım ücretlerini birbirine karıştırmayız. Yeni bir istek bütçeyi veya takvimi değiştiriyorsa uygulamadan önce etkisini konuşuruz.
Sistemi kurarız
Bilgi mimarisi, sayfa hiyerarşisi, tipografi, renk, durumlar ve farklı ekran boyutları birlikte tasarlanır. Formun hata vermesi, içeriğin uzaması veya bir görselin yüklenmemesi de tasarım problemidir. Hareket kullanırsak bir kararı açıklamalı ya da geri bildirim vermelidir; içerik animasyonun bitmesini beklemez. Geri bildirimleri tek bir karar listesinde toplamak, tasarımla geliştirmeyi aynı yönde tutar.
Ürüne dönüştürürüz
Arayüzü yeniden kullanılabilir bileşenlerle geliştirir, semantik HTML ve erişilebilir etkileşimleri temelden kurarız. İçerik yönetimi gerekiyorsa verinin kim tarafından, nereden ve nasıl güncelleneceğini belirleriz. Sunucu işlemlerinde girdiyi doğrular, hata durumunu kullanıcıya anlaşılır gösteririz. Bir AI veya 3D katmanı gerekiyorsa veri, cihaz ve entegrasyon koşullarını önce doğrular; teknoloji seçimini buna göre yaparız.
Kontrol ederiz
Masaüstü ve telefonda düzeni, klavyeyle kullanımını, odak sırasını, formları ve başarısızlık durumlarını inceleriz. Azaltılmış hareket tercihini, görsel yüklenmesini, iki dilde metinleri ve bağlantıları kontrol ederiz. Bu sitenin geliştirme kapısı TypeScript, ESLint, çeviri kontrolü, otomatik testler ve derlemeden oluşur; projeye uygun tarayıcı senaryolarıyla kritik akışları ayrıca doğrularız.
Devrederiz
Alan adı, ortam değişkenleri, yayın erişimleri, analitik onayı ve geri dönüş yolu yayından önce gözden geçirilir. İçerik ve form akışını canlı ortamda doğrularız. Müşteriye hangi hesabın ve içeriğin kimde olduğunu, bakımın neleri kapsadığını ve yeni özelliklerin nasıl ele alınacağını anlatırız. Üçüncü taraf aboneliklerini proje fiyatından ayrı gösteririz.
Basılı el kitabımızdan / Teknoloji ve çalışma biçimi
Araçlar ve gerekçeleri
Tek bir teknoloji listesini her müşteriye uygulamıyoruz. Aşağıdaki araçlar bu sitede kullandığımız veya uygun projede kapsamlandırdığımız seçeneklerdir; her karar ihtiyaç, veri ve hedef cihazlarla başlar.
React bileşenleri tekrar eden kararları tutarlı kılar; Next.js sayfa sunumu, rotalar ve metadata için temel sağlar. Semantik HTML, responsive görseller ve iki dilli içerik kullanıcıya ve arama motoruna aynı açıklığı sunar.
React · Next.js · TypeScript · next-intl
Kısa durum değişimleri CSS ile çözülür. Birden fazla öğenin birlikte hareket ettiği anlatılarda GSAP kullanırız. Hareket kapatıldığında içerik ve işlem aynı kalır.
CSS · GSAP · reduced motion
İçerik yönetimi, formlar ve kalıcı kayıtlar gerçek iş akışına göre kurulur. Bu sitede sunucu rotaları girdiyi doğrular; Supabase bazı kalıcı verileri tutar. CMS veya başka bir servis ancak yönetilecek veri ve yetki modeli netleşince seçilir.
Server routes · doğrulama · Supabase
Gerçek mekânı Gaussian splatting ile tarayıcıda gezilebilir bir sahneye dönüştürüyoruz. Çekim planı, sahne temizliği, cihaz performansı ve bilgi noktaları deneyimin parçasıdır. Sahne yüklenemezse temel bilgi ve aksiyonlara erişim korunur.
Gaussian splatting · çekim · alternatif görünüm
Asistan, arama ve öneri akışları kullanıcı niyetini gerçek veriyle buluşturmalıdır. Veri erişimini ve araç yetkilerini sınırlarız; cevabın işe yaramadığı veya servis erişilemediği durumları da tasarlarız. Bu sitedeki iç mekân denemesi önceden hazırlanmış konseptleri gösterir, canlı model çıktısı üretmez.
Hazır veri · sınırlı yetki · açık hata durumu
Derleme, test, yayın ve gözlem aynı teslim zinciridir. Bu sitede Vercel üzerinde yayın ve performans gözlemi kullanıyoruz; analitik kullanıcı iznine bağlıdır. Başka bir projede altyapıyı erişim, maliyet ve bakım sorumluluğuna göre seçeriz.
Vercel · testler · izinli analitik
Kalite kapıları
Anlamlı yapı, okunur kontrast, klavye erişimi, görünür odak ve hareket alternatifi temel kontroldür.
Görsellerin boyutunu, yükleme sırasını ve gereksiz istemci kodunu inceleriz. Gerçek cihaz davranışı karar verir.
Tipler, lint, çeviriler, testler ve derleme kontrol edilir. Kritik kullanıcı akışları tarayıcıda denenir.
Erişimler, bağımlılıklar, içerik güncelleme yolu ve yayın sorumluları teslimde açık olmalıdır.
Şeffaflık
Süre, entegrasyon ve bakım kapsamı projeye göre değişir. Keşiften önce kesin performans sonucu, hazır olmayan API bağlantısı veya sınırsız revizyon sözü vermeyiz. Kararları ve ek giderleri çalışmaya başlamadan önce yazarız.