Schema / Version Change Incident Playbook

Schema/version incident, provider contract değişikliğinin parser veya normalized model'i kırmasıdır.

Trigger

Parse error spike, unknown enum, missing required field, sudden reject-rate artışı veya provider deprecation bildirimi.

Triage

1. Son başarılı payload ile ilk hatalı payload'ı diff edin.
2. Version/header/schema marker değişti mi?
3. Breaking field rename/type/enum var mı?
4. Parser backward-compatible mı?
5. Bad data downstream'a yazıldı mı?

Containment

Yeni schema'yı version gate ile quarantine edin. Tüm batch'i sessizce kabul etmeyin. Gerekirse eski parser'a rollback veya affected provider'ı degrade mode'a alın.

Migration

Old/new DTO'ları ayrı tutun; normalized internal model'e mapper version ekleyin. Shadow parse ile output farkını ölçün.

Stop condition

Reject/error baseline'a dönmeli, sampled payload'lar doğru normalize edilmeli ve downstream corruption olmamalı.

Metrikler

Schema reject rate, unknown-field/enum rate, parser-version distribution, quarantine size ve migration mismatch.

Önleme

Contract fixture, schema snapshot, deprecation calendar ve provider version inventory tutun.