Blog Yazısı Özeti
Offline saha servis uygulaması, eski ekranı önbellekten göstermekten fazlasıdır. Teknisyenin yeni kaydını cihazda kalıcı saklamalı, gönderim durumunu açıkça göstermeli ve merkezde aynı kayıt değiştiğinde hangi bilginin geçerli olacağını belirlemelidir.
Hazırlayan: Busana. Kaynak kontrolü: 6 Ekim 2026.
Fotoğraf: Pexels. Temsili görsel.
Teknisyen bodrumdaki cihazın bakımını bitirir. Notları, kullanılan parçaları ve fotoğrafları girer. Çıkışta bağlantı gelir, uygulama oturumu yenilemek ister ve form kaybolur. Ekranın internet yokken açılmış olması, uygulamanın gerçekten çevrimdışı çalıştığı anlamına gelmemiştir.
Offline-first yaklaşımda ekran hangi veriyi okur?
Android'in resmi mimari rehberi, offline-first veri katmanında yerel ve ağ kaynaklarının birlikte ele alınmasını ve uygulamanın temel okuma ihtiyaçlarının ağ bağlantısı olmadan karşılanmasını anlatıyor. Buradaki önemli ayrım, kullanıcı arayüzünün yalnızca başarılı bir API yanıtını bekleyen yapıdan çıkmasıdır. Android offline-first rehberi.
Uygulama açısından yerel kayıt görüntülemenin dayanağı olabilir; iş emrinin kurumsal olarak kesinleşmesi açısından sunucu yetkili kalabilir. Bu iki “doğru kaynak” farklı katmanlara aittir. Cihazdaki “kaydedildi” ifadesi, merkezde “onaylandı” anlamında kullanılmamalıdır.
Önerilen durumlar açık ve ayrı olsun: cihazda kayıtlı, gönderim bekliyor, merkeze aktarıldı, çakışma nedeniyle inceleme gerekiyor. Kullanıcı hangi işin tamamlandığını anlayabilsin.
Her alan aynı yöntemle birleştirilemez
İki teknisyen aynı iş emrine not ekleyebilir. Bu notlar ayrı olaylar olarak korunabilir. Ancak aynı işin durumunu biri “tamamlandı”, diğeri “ek parça bekliyor” yaptığında son geleni otomatik kabul etmek iş kaybına yol açabilir.
- Servis notu: Önerilen başlangıç yaklaşımı: Kimlikli, eklenen olay kaydı. Dikkat edilecek nokta: Sonradan düzeltmenin geçmişi.
- İş emri durumu: Önerilen başlangıç yaklaşımı: Sürüm kontrolü ve iş kuralı. Dikkat edilecek nokta: Geçersiz durum geçişi.
- Parça tüketimi: Önerilen başlangıç yaklaşımı: Tekil stok hareketi talebi. Dikkat edilecek nokta: Negatif stok ve tekrar kayıt.
- Fotoğraf: Önerilen başlangıç yaklaşımı: Ayrı yükleme kuyruğu. Dikkat edilecek nokta: Eksik dosya ve yanlış iş emri ilişkisi.
- Müşteri ana bilgisi: Önerilen başlangıç yaklaşımı: Yetkili güncelleme veya inceleme. Dikkat edilecek nokta: Cihazdaki eski bilginin merkezi ezmesi.
Bu tablo evrensel bir senkronizasyon standardı değildir; iş sürecine göre uyarlanacak tasarım başlangıcıdır. Özellikle stok, ödeme veya sözleşme etkisi olan işlemlerde çevrimdışı kabulün sınırları açıkça belirlenmelidir.
Aynı kayıt üç kez gönderilirse ne olmalı?
Telefon yanıtı almadan bağlantı kopabilir. Sunucu işlemi tamamlamış olsa bile uygulama bunu bilemez ve yeniden deneyebilir. Her denemeye yeni işlem kimliği üretmek, aynı parça tüketiminin iki kez yazılmasına neden olabilir.
İşlem kimliğini kullanıcı eylemi oluştuğunda üretip kalıcı saklayın. Aynı eylemin tekrarlarında bu kimliği kullanın. Sunucu kimliği uygun şirket ve kullanıcı kapsamında tanısın; işlem kaydıyla iş etkisini atomik olarak ilişkilendirsin. Yalnızca mobil tarafta tekrar düğmesini kapatmak yeterli değildir.
Giden işlemler kuyruğu uygulama kapandığında kaybolmamalıdır. Yeniden denemeler kontrollü aralıklarla yapılmalı, kalıcı doğrulama hataları sonsuz döngüye sokulmamalıdır. Kullanıcıya düzeltilebilir hata ile geçici bağlantı sorunu farklı gösterilmelidir.
Fotoğraf yüklemesi form gönderimiyle aynı iş değildir
Büyük fotoğraflar zayıf bağlantıda en kolay aksayan parçadır. İş emri metnini ve medya dosyalarını ayrı durumlarla izlemek, tek bir dosya yüzünden bütün kaydın belirsiz kalmasını önler.
Dosya boyutu ve türünü doğrulayın; iş emri ilişkisini sunucuda kontrol edin. Aynı dosyanın tekrar yüklenmesini tanımak için içerik özeti kullanılabilir, fakat erişim yetkisi kontrolünün yerini tutmaz. Yarım kalan yükleme temizliği ve cihaz depolama sınırı belirlenmelidir.
İşin kapanması için belirli fotoğraflar zorunluysa, bütün ekler sunucuda doğrulanmadan “tamamlandı” durumuna geçirmeyin. Fotoğrafın bulunduğu yolun kaydedilmiş olması, dosyanın gerçekten erişilebilir olduğu anlamına gelmez.
Oturum süresi bitince teknisyenin emeği silinmemeli
Çevrimdışı cihaz, kullanıcının merkezdeki yetkisinin değiştiğini anında öğrenemeyebilir. Bu sınıra ürün kararı gerekir: hangi veriler cihazda kalabilir, ne kadar süre çevrimdışı işlem yapılabilir ve yeniden bağlantıda hangi kontroller zorunludur?
Yerel hassas veriyi koruyun; cihaz kaybı, paylaşımlı kullanım ve yedekleme davranışını değerlendirin. Yeniden giriş gerektiğinde bekleyen kayıtları sessizce silmeyin. Öte yandan yetkisi kaldırılmış kullanıcının bekleyen bütün işlemlerini kontrolsüz biçimde uygulamayın. Sunucu işlemleri güncel yetkiyle yeniden değerlendirip sonucu açıklamalıdır.
Kabul testini uçak modundan ileri taşıyın
İş emrini indirin, bağlantıyı kesin, kayıt oluşturun, uygulamayı kapatıp açın. Ardından başka cihazdan aynı iş emrini değiştirin ve ilk cihazı yeniden bağlayın. Bu test, gerçek çakışmayı gösterir.
Ayrıca süresi dolmuş oturum, dolu depolama, yarım fotoğraf yüklemesi ve aynı işlemin tekrarı test edilmelidir. Ölçülecek sonuçlar: kaybolan kayıt, mükerrer stok hareketi, çözülemeyen çakışma ve bekleyen işlemin yaşıdır. “İnternetsiz açılıyor” kabul kriteri olarak yetersizdir.
Busana'nın mobil geliştirme ve API entegrasyonu kapsamını değerlendirirken bağlantısız kalınan süreyi, cihazları ve servis kapanış kurallarını paylaşın. Saha akışını birlikte inceleyelim; teknoloji seçimi bu kuralları izlesin.
