Bağlam

ADR-0010 ve SPEC-SCHEMA-0001/D1 gereği yayımlanmış bir şema dosyası asla değişmez. Değişiklik yeni sürüm yolu ister; daha önce verilmiş belgeler (credential) kendi sürümüyle doğrulanmaya devam eder. Bu kural gerçek kullanıcıların elinde belge varken doğrudur.

Tamga bugün geliştirme evresindedir:

Uygulamayı ve siteyi kullanan gerçek kişi yoktur.
Devletler resmî olarak sistemde değildir; AB'de bu yapı üye devletlere zorunlu tutulur, Türkiye'de henüz öyle değildir.
Şemalar doğrusu bulunana kadar değişecektir (ör. AB eğitim kataloğuna göre eklenen alanlar).

Bu evrede sürüm geçişlerini taşımak iş yükü ve karışıklık üretir. Proje yönetimi, şemaların yanlışsa doğrudan düzeltilmesini ve sürüm ya da kayıt sistemine belli bir olgunluğa gelince (beta) geçilmesini istedi.

Karar

K1 — Geliştirme evresi

SCHEMA_STAGE = "development" iken (packages/schemas):

Şema tanımı aynı sürüm yolunda (ör. 1.0.0) düzeltilir. Derleyici değişen dosyanın üzerine yazar ve uyarı basar.
Yeni sürüm yolu açılmaz. güven listesinde (trust list) tür başına tek geçerli özet bulunur.
Önceki özetle verilmiş deneme belgeleri doğrulamada reddedilir ve yeniden alınır.
Kırıcı değişiklik (alan adı, anlam) da yerinde yapılabilir. vct (Verifiable Credential Type) URN'i yalnız tür gerçekten başka bir şeye dönüşürse değişir.

K2 — Beta ile geçiş

Beta yayınında SCHEMA_STAGE = "stable" yapılır. O andan itibaren:

SPEC-SCHEMA-0001/D1 (yayımlanmış şema değişmez),
küçük sürüm kuralı (ADR-0010 K4: aynı vct, yeni metadata sürümü, önceki özetler geçerli kalır; güven listesinde content_hashes — okuma tarafı hazır).

Aşamanın değiştirilmesi STATUS ve DECISIONS'a işlenir.

Değişmezler

Kod	Kural
DS1	`SCHEMA_STAGE = "development"` yalnız gerçek kullanıcıya belge verilmeyen evrede kullanılır; ilk gerçek kurum ya da kişi belgesinden önce `stable` yapılır.

Durum

Accepted — 2026-09-30. Proje yönetimi onayıyla. DECISIONS: D-SCHEMA-5.

Bağlam ​

Karar ​

K1 — Geliştirme evresi ​

K2 — Beta ile geçiş ​

Değişmezler ​

Durum ​