Booking Timeout ve UNKNOWN Outcome Recovery

Booking create request'inin timeout olması booking'in başarısız olduğunu kanıtlamaz. Transport failure ile business outcome'u ayırmak, duplicate booking'i önleyen en kritik kurallardan biridir.

Recovery state machine

UNKNOWN booking recovery

Mermaid source (.mmd)

Timeout sınıfları

Ayrıştırın:

• connect timeout: request provider'a hiç gitmemiş olabilir,
• read timeout: provider request'i işlemiş olabilir,
• connection reset: outcome belirsiz,
• client timeout: backend işlemeye devam ediyor olabilir,
• business timeout: provider booking hala processing olabilir.

Hepsini FAILED yapmak yanlıştır.

Recovery key'leri

Lookup için mümkün olan identity'leri kaydedin:

• client reference,
• idempotency key,
• provider session/token,
• traveler + itinerary/property fingerprint,
• payment reference,
• request correlation ID.

Safe retry gate

Create retry ancak şu koşullarda yapılmalı:

1. previous attempt terminal FAILED,
2. provider duplicate protection sağlıyor veya önceki create'in oluşmadığı authoritative olarak doğrulandı,
3. aynı BookingIntent için retry policy izin veriyor.

UNKNOWN iken blind retry yok.

Reconciliation algorithm

if providerReference exists:
  lookup by providerReference
else if clientReference supported:
  lookup by clientReference
else:
  query narrow booking window / fingerprint
if found:
  CONFIRMED
else if provider guarantees lookup completeness:
  FAILED
else:
  remain UNKNOWN and escalate/backoff

"Bulamadım" her provider'da "yok" anlamına gelmez; lookup consistency contract'ı bilinmelidir.

User experience

UNKNOWN internal state'i kullanıcıya doğrudan teknik terimle göstermeyin. UX:

• "Rezervasyonunuz doğrulanıyor",
• tekrar satın alma CTA'sını geçici kapatma,
• duplicate riskini anlatmadan recovery sürdürme,
• terminal sonuç geldiğinde notification.

Failure modes

• duplicate create retry,
• lookup eventual consistency,
• wrong booking'i fingerprint ile eşleme,
• UNKNOWN kaydı sonsuza kadar açık bırakma,
• ops agent'ın ikinci booking açması,
• payment state'i booking outcome kanıtı sanma.

Observability

• UNKNOWN creation rate,
• UNKNOWN age percentiles,
• resolution source,
• resolution outcome,
• duplicate prevention count,
• manual escalation rate,
• time-to-confirm/time-to-fail.

Production checklist

• UNKNOWN first-class state,
• timeout taxonomy,
• recovery identity persistence,
• provider lookup capability map,
• safe retry gate,
• backoff,
• manual escalation,
• traveler-safe pending UX.