Skip to content
ADR-0018Mimari karar kaydı · GovernanceKabul edildisürüm 1.0.02026-09-27T00:00:00.000Z

Bağlam ​

D-GOV-6 (2026-09-24) çerçeve belge setini (Tamga ARF, Trust Framework, Rulebook, attestation rulebook'ları) tanımladı ve yayın yerini docs.tamga.network olarak koydu ("Türkçe kanonik, İngilizce v0.2"). Bugünkü durum:

  • tamga.network/docs genel anlatımla geliştirici sayfalarını (entegrasyon, kod) karıştırıyor.
  • docs.tamga.network her şeyi bir arada sunuyor: çerçeve belgeleri, kılavuzlar, spesifikasyonlar, ADR'ler, iç çalışma kayıtları (teslimat, Faz B analizi). Düzenleyici ya da kurum için ARF bu kalabalıkta kayboluyor.
  • AB'de aynı ihtiyaç üç ayrı yerle karşılanır: vatandaş/kurum anlatımı (Komisyon sitesi), geliştirici merkezi ve ARF (ayrı, sürüm numaralı, İngilizce yayın; ekleri: yüksek seviye gereksinimler, attestation rulebook'ları).

Proje yönetiminin isteği (2026-09-27): belgeler AB'deki gibi ayrılsın — genel belgeler, geliştirici belgeleri ve bir ARF.

Karar ​

K1 — Üç kapı ​

KapıAdresOkurİçerik
Geneltamga.network/docs (tamga-web, üç dil)kurum, karar verici, vatandaşkavramlar, e-kimlik ve eIDAS, TamgaID, nasıl çalışır, senaryolar, sözlük
Geliştiricidocs.tamga.network (VitePress, tamga-network/docs)yazılımcı, entegratörkılavuzlar, kod örnekleri, paketler, spesifikasyonlar, ADR'ler, kayıtlar
Tamga ARFarf.tamga.network (VitePress, tamga-network/arf)düzenleyici, kurum, denetçiana belge (FW-ARF-0001) + Ek A Trust Framework + Ek B katılımcı kuralları + Ek C attestation rulebook'ları

Her kapı diğer ikisine görünür bağlantı verir. Çerçeve belgelerinin tek kamu yeri arf.tamga.network'tür; docs.tamga.network onları yeniden yayınlamaz, [[FW-*]] atıflarını ARF sitesine bağlar.

K2 — Ad ve alan adı ​

Kamuya açık ad "Tamga ARF" (açılımı: Mimari ve Referans Çerçevesi / Architecture and Reference Framework). Yeni alt alan adı arf.tamga.network (statik; D-NAME-1 hizmet listesine belge yayını olarak eklenir, ağ hizmeti değildir).

K3 — Dil ve kaynak ​

  • Tamga ARF İngilizce + Türkçe yayınlanır; kök sayfa İngilizce (/), Türkçe /tr/.
  • Kaynak Türkçedir: docs/framework/*.md (DOC-ID atıfları, MASTER_INDEX, onay süreci burada). Türkçe sayfalar derlemede bu dosyalardan üretilir.
  • İngilizce arf/*.md elle çevrilir; her dosya translation_of ve source_version taşır. Kaynak sürüm artıp çeviri güncellenmezse derleme durur (npm run arf:check, CI).
  • Çelişkide Türkçe kaynak geçerlidir; bu, bir devlet ya da konsey belgeyi devraldığında yeniden değerlendirilir (FW-TF-0001 §7).

K4 — Sürüm ​

Tamga ARF bir yayın numarası taşır (ör. "Tamga ARF 0.2"); her belgenin kendi sürümü ayrıca görünür. Yayın numarası, setteki herhangi bir belgenin MINOR ya da MAJOR artışında yükselir; sürüm geçmişi ARF sitesinde herkese açıktır.

Değerlendirilen seçenekler ​

SeçenekArtıEksiSonuç
Hepsi tamga.network altında (/docs, /developers, /arf)tek site, yeni alan adı yokARF bir tanıtım sitesinin parçası gibi durur; iki farklı yayın aracı tek sitederet
Ayrı adresler, geliştirici için de yeni alan adıen temiz ayrımiki yeni alan adı; docs.tamga.network bağlantıları kırılırret
Ayrı adresler; geliştirici docs. kalır, ARF arf.AB düzenine en yakın; ARF resmî belge gibi durur; mevcut bağlantılar korunurbir yeni alt alan adıseçildi
ARF yalnızca Türkçehızlıuluslararası okur (AB, TDT devletleri) İngilizce okurret
ARF üç dil (EN/TR/TK)sitenin geri kalanıyla aynıen çok iş; Türkmence metnin ayrıca okunması gerekirsonraya

Sonuçlar ​

  • tamga-network/arf/ (VitePress, iki dil) + scripts/arf-sync.mjs (Türkçe kaynaktan üretim, --check sürüm denetimi).
  • docs.tamga.network geliştirici belgeleri olarak yeniden düzenlenir; çerçeve bölümü ARF'ye bağlanır.
  • tamga-web: menü ve alt bilgi üç kapıyı gösterir; /docs genel anlatımda kalır.
  • tamga-platform/ops: nginx arf.tamga.network bloğu, deploy.sh derleme + yayın; DNS kaydı (operatör).
  • D-GOV-6'nın "Yayın" satırı bu ADR'ye bağlanır (DECISIONS "Değiştirilen Kararlar").
  • K4 uygulaması: yayınlar arf/releases.json'da; her yayın arf/archive/<yayın>/ altında dondurulur (npm run arf:snapshot) ve /v<yayın>/ adresinde okunabilir kalır; sitede sürüm menüsü ("latest" etiketi) ve yayınlar arası satır farkı sayfası (/changes). arf:check yayın kaydı ↔ belge sürümleri ↔ arşiv tutarlılığını da denetler.

Değişmezler ​

KodKural
DY1Çerçeve belgelerinin (FW-*) kamuya açık tek yayın yeri Tamga ARF sitesidir; başka site kopyasını yayınlamaz, bağlantı verir.
DY2Tamga ARF'nin İngilizce çevirisi Türkçe kaynağın aynı sürümünü taşır; sürüm farkı varken yayın yapılmaz.
DY3Tamga ARF sayfaları özel depo yollarına, konuşmalara ya da kiracı verisine bağlantı vermez.

Durum ​

Accepted — 2026-09-27. Seçilen: ayrı adresler, İngilizce + Türkçe ARF, ad "Tamga ARF". DECISIONS: D-DOCS-1.