Mühendislik · ArbeitszeitCheck
Çevrimdışı bir damganın anatomisi
Saat 12:07, bir şantiye kapısı, çekim sıfır. İşçi yine de mesaiye giriş yapıyor. İşte o damganın zaman kayıtlarına inmeden önce geçtiği her şey ve işlerin nerede ters gidebileceği.
Sıfırıncı dakika: telefon sunucuya ulaşamıyor
Mobil uygulama körü körüne yeniden denemiyor ve başarıyı taklit etmiyor. Damga, cihaz üzerindeki şifreli bir FIFO kuyruğuna gidiyor, AsyncStorage'da AES-GCM şifreli metin, veri anahtarı SecureStore'da tutuluyor. Bu son detayın gerçek bir nedeni var: SecureStore, Android'de değerleri kabaca iki kilobaytla sınırlıyor. Yani bariz tasarım (kuyruk SecureStore'da, tamam) hiçbir zaman mümkün olmadı. Kuyruğun kendisi 32 kayıtla sınırlı, sonsuz bir vaat değil, sınırlı bir tampon. İyimser durum işçiyi anında “mesaiye girmiş” gösteriyor. Kuyruk, kapsama geri döndüğünde boşalıyor.
Boşaltma kasıtlı olarak titiz: uygulama kuyruğun bir mutex altında anlık görüntüsünü alır, ağ işini kilidin dışında yapar, sonra sonucu geri birleştirir, böylece boşaltma sırasında kuyruğa giren bir damga, birleştirme tarafından ezilmez. Bu, ancak eşzamanlı yazmalar konusunda paranoyak davranarak bulunan hata sınıfıdır.
Yeniden gönderim: değiştirmeden önce sahiplen
Damga sonunda sunucuya ulaştığında, normal bir damganın taşımadığı iki şeyi taşır: bir clientRequestId ve bir occurredAt zaman damgası. Sunucu onu doğrudan uygulamaz. Önce bir claim satırı yazar: “bu istek kimliği artık benim, sonuç beklemede.” Ancak ondan sonra zaman kayıtlarını değiştirir. İki yeniden deneme yarışırsa, ikincisi claim'in zaten alınmış olduğunu bulur ve çift damga yerine ilk denemenin sonucunu alır.
Claim satırı bir payload_hash taşır: aksiyon ve normalize edilmiş girdileri üzerinden sha256. Farklı bir payload taşıyan aynı istek kimliği, sessiz bir üzerine yazma değil, 409 yanıtı alır: “mesaiye gir”i yeniden deneyip yanlışlıkla “mesaiden çık”ı tekrar gönderen bir istemci, bozulmuş veri değil, görebileceği bir hata alır. 300 saniyeden uzun süre bekleyen claim'ler geri alınır. Yeniden gönderim penceresinin tamamı yedi gündür, ardından bir temizlik işi satırları siler.
Hangi saat sayılır
Telefon saatleri kayar ve kasıtlı olarak geriye alınabilir. Bu yüzden uyum, varış anında değil code'ta, işçinin gerçekte damgaladığı anda, değerlendirilir. Sunucunun bu zaman damgasına ne kadar güveneceği sınırlı bir yönetici ayarıdır: geçmişe doğru 24 ile 72 saat arasında yapılandırılabilir sapma, geleceğe doğru beş dakika. Tavan kasıtlıdır. “geçen perşembeden” bir damganın ona inanan bir algoritmaya değil, ona bakan bir insana ihtiyacı vardır.
Kiosk yolu aynı sözleşmeyi kendi incelikleriyle alır: şifreli bir NFC kart önbelleği (yedi günlük TTL, 500 kayıtla sınırlı), böylece bodrum kattaki bir koridor terminali kesinti sırasında hâlâ doğru aksiyon ekranını açar ve başarılı bir boşaltma, yeni durumu o önbelleğe geri yazar. Aksi halde bir sonraki kesinti işçiye zaten yanlış olan aksiyonlar sunar.
Kayıtlara geçen: hâlâ eksik olanlar
İki boşluk. Kalıcı olarak başarısız olan bir damga, kuyrukta code olarak işaretlenmiş kalır, kullanıcı bir toast görür ama henüz satır başına yeniden deneme arayüzü yok. Ve yeni alanları tanımayan eski uygulama sürümleri yalnızca çevrimiçi damgalar. Hiçbir şey bozulmaz, sadece özelliği kaybederler. İkisi de karar dokümanına yazıldı çünkü en kötü sınırlama türü, kimsenin dokümante etmediğidir.
Kilit sıralaması ve temizlik işi dahil tam karar kaydı, AGPL'nin okumanızı garanti ettiği depoda duruyor. Bu yazının cevabının diğer yarısı da bu: kuyruk yalnızca ölü bölgeyi atlatacak şekilde mühendislenmedi, bunun böyle olduğunu denetleyebilmeniz için dokümante edildi.