QARAQUTU
Kayıtlı · Türetilmiş · Doğrulama İzi · Artefakt İhracı
QARAQUTU
Protokol & API

QARAQUTU Belgeleri / API

KatmanlarÜrün / Protokol KılavuzuTeknik / API Referansı

Ürün / Protokol Kılavuzu

Kurumsal, hukuk, sigorta ve operasyon okuyucuları için sade akış. Teknik test/fixture dilinden ayrıdır.

Ürün kapsamı

QARAQUTU şu anda araç olayı, filo, sigorta, hasar ve hukuk inceleme iş akışlarına odaklanır. Kamusal doktrin ailesi Kayıtlı · Türetilmiş · Doğrulama İzi · Artefakt İhracı çizgisinde yürür; kanonik olay paketleri üzerinde sınırlı inceleme yapılır. Bu belge sayfasında backend terimleri (tenant, policy, visibility classes) teknik bağlamda kullanılır; kamusal ürün kimliğini yeniden tanımlamaz.

Kanonik model özeti

  • Event: her olay için tek event ID içeren kanonik olay nesnesi.
  • Bundle: olayla ilişkili kanıt nesnelerinin paketleme birimi.
  • Manifest: pakete hangi nesnelerin ait olduğunu tanımlayan bütünlük haritası.
  • Export: kanonik olaydan türetilen, role uygun sunum artifact’ı (JSON/PDF).
  • Receipt: bir işlemin gerçekleştiğini gösteren protokol kanıtı (ör. export üretimi).
  • Verification State: demo olayları için PASS, FAIL, UNKNOWN veya UNVERIFIED değerlerinden biridir.
  • Recorded vs Derived: recorded evidence doğrudan kaydedilen/kaynak kökenli materyalleri; derived evidence ise sonradan üretilen yorum/rekonstrüksiyon/analizi temsil eder. Her zaman ayrı bölümlerde saklanır ve sunulur.

Doğrulama semantiği

Doğrulama, referans verilen olay paketi üzerinde sınırlı bir değerlendirmedir. Bu sürümde kanonik verification state PASS, FAIL, UNKNOWN veya UNVERIFIED olabilir. Doğrulama; sorumluluk tespiti, suç isnadı veya yargısal karar değildir; kanıt paketi üzerinde bütünlük ve bağlantı değerlendirmesidir.

Sektörler

Sektöre özgü tanıklık senaryoları

Her sektör senaryosu; olay, kurumsal risk, rol kabuğu, belge ailesi ve doktrin-güvenli çıktıyı tanımlar. Doğrulayıcı, sigorta, hukuk, teknik ve idari bağlamlarda aynı inceleme yapısını uygular.

Sigorta / Hasar

Filo olayı — hasar inceleme duruşu

Olay

Telemetri, dashcam ve sensör verisi içeren araç olayı. Birden fazla taraf aynı kanonik olaya bağlı ihtilafa hazır özetlere ihtiyaç duyar.

Kurumsal risk

Kayıtlı ve türetilmiş tek bir anlatıda birleşir; hasar ve hukuk ekipleri farklı nesnelere dayanır.

QARAQUTU yanıtı

Kayıtlı/türetilmiş ayrımı, kanonik referanslar ve rol-sınırlı artefakt ihracı ile iz-bağlı hasar paketi.

Belge: Hasar İnceleme Paketi, Doğrulama Özeti, Olay İnceleme RaporuRol: Hasar / Sigorta

Kurumlar, paylaşılan ve değiştirilemez kanıt omurgası olmadan karar veremez.

Noter / Özgünlük

Belge özgünlüğü — manifest ve makbuz zinciri

Olay

İmzalı belge veya dijital artifact için özgünlük doğrulaması. Manifest, makbuz ve sürüm zinciri açık kalmalıdır.

Kurumsal risk

İz olmadan özgünlük iddiaları; makbuz ve manifest bağlantısı sunumda kaybolur.

QARAQUTU yanıtı

Manifest, makbuz ID, sürüm zinciri ve iz ekleri ile özgünlük makbuzu — protokol mührü, hüküm değil.

Belge: Orijinallik Doğrulama Makbuzu, Doğrulama Özeti, Doğrulama İzi EkiRol: Noter / Özgünlük, Kâtip / Kabul

İz olmadan özgünlük iddiadır; ayrım olmadan iz karışıklıktır.

Patent / Fikri Mülkiyet Tanıklığı

Önceki sanat / buluş açıklaması — tanık kaydı

Olay

Zaman damgalı buluş açıklaması veya önceki sanat yakalama. IP süreçleri için özgünlük katmanı ile iz-bağlı tanık kaydı.

Kurumsal risk

İz olmadan tanık kaydı; özgünlük hukuki iddia ile karıştırılır.

QARAQUTU yanıtı

Özgünlük katmanı ile iz-bağlı tanık kaydı; doğrulama izi incelemeyi destekler, gerçeğin kendisi değil.

Belge: Doğrulama İzi Eki, Orijinallik Doğrulama Makbuzu, Doğrulama ÖzetiRol: Noter / Özgünlük, Teknik / Üretici-Otonom-SaaS

IP süreçleri tartışılmaz zaman damgası ve provenans gerektirir; iz omurgayı sağlar.

Belediye / İdari İnceleme

İdari paket — sürüm ve erişim zinciri

Olay

İzin, itiraz veya idari dosya için kamu kurumu incelemesi. Sürüm zinciri, erişim geçmişi ve export geçmişi açık olmalıdır.

Kurumsal risk

Türetilmiş idari olgu olarak sunulur; sürüm ve erişim geçmişi opak.

QARAQUTU yanıtı

Sürüm zinciri, erişim geçmişi, doğrulama özeti ile idari paket — türetilmiş ayrı kalır.

Belge: İdari Paket, Doğrulama ÖzetiRol: İdari / Belediye-Kamu Kurumu, Gözetim / Denetçi-Yönetici

İdari hesap verebilirlik denetlenebilir zincir gerektirir; türetilmiş olgu kisvesine bürünemez.

Polis / Jandarma / Saha Kanıtı

Olay kaydı — kayıtlı kanıt ve iz ekleri

Olay

Vücut kamerası, araç veya sahne kaydı ile saha olayı. Zincir-of-custody için kayıtlı kanıt, kaynak listesi, zaman dizisi ve iz ekleri.

Kurumsal risk

Kayıtlı ve türetilmiş karıştırılır; iz gerçek olarak sunulur; zincir-of-custody boşlukları.

QARAQUTU yanıtı

Kayıtlı/türetilmiş ayrımı ile olay raporu; doğrulama adımları için iz ekleri — iz incelemeyi destekler, gerçeğin kendisi değil.

Belge: Olay İnceleme Raporu, Doğrulama İzi Eki, Doğrulama ÖzetiRol: Saha / Polis-Jandarma

Ayrım olmadan saha kanıtı tartışmalıdır; doktrin olmadan iz sorumluluk tiyatrosudur.

Teknik Üretici / Otonom SaaS

Teknik paket — sistem, senaryo, olay bağlantısı

Olay

Otonom sistem olayı — araç, drone veya robot. Teknik inceleme için sistem/senaryo/olay bağlantısı, kaynak referansları, paket yapısı ve iz.

Kurumsal risk

Teknik rekonstrüksiyon kusur bulma olarak sunulur; iz hüküm ile karıştırılır.

QARAQUTU yanıtı

Sistem/senaryo/olay, kaynak referansları, iz ekleri ile teknik paket — rekonstrüksiyon kusur isnadı değildir.

Belge: Teknik İnceleme Paketi, Doğrulama İzi Eki, Olay İnceleme RaporuRol: Teknik / Üretici-Otonom-SaaS

Üreticiler sorumluluk tiyatrosu olmadan ihtilaf düzeyinde iz gerektirir; teknik paket bunu sağlar.

Teknik / API Referansı

Geliştirici odaklı terimler, API uçları ve tanılama içerikleri bu katmanda tutulur.

Belge / artefakt ailesi

Protokol düzeyi kanıt belgeleri için ortak tasarım sistemi. Doktrin korunur: Kayıtlı, Türetilmiş, Bilinmeyen/Tartışmalı, Doğrulama İzi ve Artefakt İhracı katmanları ayrı bölümlerde tutulur.

  • Olay İnceleme Raporumetadata, document ID ve zincir bağlantısı içeren kanonik olay raporu.
  • Doğrulama Özetisınırlı değerlendirme, doğrulama izi referansı.
  • Doğrulama İzi Ekidoğrulama adımlarıdır; gerçeğin kendisi değildir.
  • Kurum penceresine bağlı artefakt aileleriHasar İnceleme Paketi, Hukuki İnceleme Paketi, Teknik İnceleme Paketi, İdari Paket ve Orijinallik Doğrulama Makbuzu.
  • Cover / seal / stamp katmanı — birincil logo değil, protokol işaretidir.

Aynı olay, farklı kurum penceresi

QARAQUTU tek olay omurgasını sabit tutar (Event/Bundle/Manifest/Receipt değişmez). Kurum penceresi değiştiğinde yalnız inceleme sırası, dosyalama vurgusu ve artefakt ailesi farklılaşır.

  • Sigorta / hasar penceresi: Hasar İnceleme Paketi, Sensör Durum Özeti ve Doğrulama Özeti ile dosya başlangıcı kurulur.
  • Hukuk / yargısal inceleme penceresi: Hukuki İnceleme Paketi ve Doğrulama İzi Eki ile usul okunabilirliği güçlendirilir.
  • Kolluk / resmî inceleme penceresi: Olay İnceleme Raporu ve Doğrulama İzi Eki ile olay sırası ve zincir devamlılığı görünür kalır.
  • Teknik inceleme penceresi: Teknik İnceleme Paketi, yöntem şeffaflığı ve sinyal tekrar edilebilirliğini öne çıkarır.
  • Banka / risk / governance penceresi: İdari Paket, Orijinallik Doğrulama Makbuzu ve Doğrulama Özeti ile kontrol zinciri görünür tutulur.

Kurumsal kullanım aileleri — role dayalı inceleme ve dışa aktarma eşleşmesi

Tek kanonik olay çekirdeği, çoklu kurumsal pencere. Aynı olay omurgası (Event ID, Bundle ID, Manifest ID, Receipt ID, Version, Kayıtlı, Türetilmiş, Bilinmeyen/Tartışmalı, Doğrulama İzi, Artefakt İhracı) korunur; yalnız öncelik sırası, görünürlük ağırlığı, belge önerisi ve kabuk yerleşimi role göre değişir.

Kurum penceresi → Belge ailesi
Kâtip / Kabul
Olay İnceleme Raporu, Orijinallik Doğrulama Makbuzu
Saha / Polis-Jandarma
Olay İnceleme Raporu, Doğrulama İzi Eki, Doğrulama Özeti
İdari / Belediye-Kamu Kurumu
İdari Paket, Doğrulama Özeti
Noter / Özgünlük
Orijinallik Doğrulama Makbuzu, Doğrulama Özeti, Doğrulama İzi Eki
Hukukî / Hakim-Savcı-Avukat
Hukuki İnceleme Paketi, Doğrulama Özeti, Doğrulama İzi Eki, Olay İnceleme Raporu
Hasar / Sigorta
Hasar İnceleme Paketi, Doğrulama Özeti, Olay İnceleme Raporu
Teknik / Üretici-Otonom-SaaS
Teknik İnceleme Paketi, Doğrulama İzi Eki, Olay İnceleme Raporu
Gözetim / Denetçi-Yönetici
İdari Paket, Doğrulama Özeti, Orijinallik Doğrulama Makbuzu
Aynı olay omurgası · kurum pencereleri
Sigorta / Hasar
Hasar İnceleme Paketi · Sensör Durum Özeti · Yeniden Doğrulama Sonucu
Aynı olay omurgasını hasar dosyası önceliğinde okur; kayıtlı/türetilmiş ayrımını korur.
Hukuk / Yargısal İnceleme
Hukuki İnceleme Paketi · Mühürlü Kanıt Özeti · Doğrulama İzi Eki
Usul okunabilirliği ve zincir sürekliliğini öne alır; Türetilmiş ≠ Hüküm sınırı korunur.
Kolluk / Resmî İnceleme
Olay İnceleme Raporu · Doğrulama İzi Eki · Doğrulama Özeti
Olay sırası ve temas zincirini görünür kılar; artefakt ihracı suçlama diline dönüşmez.
Teknik İnceleme
Teknik İnceleme Paketi · Doğrulama İzi Eki · Sensör Durum Özeti
Yöntem ve sinyal tekrarlanabilirliğini öne alır; teknik okuma kusur hükmü üretmez.
Banka / Risk / Governance
İdari Paket · Orijinallik Doğrulama Makbuzu · Doğrulama Özeti
Risk komitesi ve kontrol masası için zincir sürekliliği, makbuz bağı ve yeniden doğrulama disiplini görünür tutulur.
Belge ailesi → Birincil kurum penceresi
Araç Olay Tutanığı
Hasar / Sigorta, Saha / Polis-Jandarma, Hukukî / Hakim-Savcı-Avukat, Teknik / Üretici-Otonom-SaaS
Drone Uçuş Olay Tutanığı
Saha / Polis-Jandarma, Hukukî / Hakim-Savcı-Avukat, Teknik / Üretici-Otonom-SaaS
Robot Operasyon Olay Tutanığı
Teknik / Üretici-Otonom-SaaS, Hukukî / Hakim-Savcı-Avukat, Gözetim / Denetçi-Yönetici
Sensör Durum Özeti
Hasar / Sigorta, Hukukî / Hakim-Savcı-Avukat, Noter / Özgünlük, Gözetim / Denetçi-Yönetici
Mühürlü Kanıt Özeti
Hukukî / Hakim-Savcı-Avukat, Hasar / Sigorta, İdari / Belediye-Kamu Kurumu, Gözetim / Denetçi-Yönetici
PASS Sınırlama Eki
Hasar / Sigorta, Hukukî / Hakim-Savcı-Avukat, Teknik / Üretici-Otonom-SaaS
Yeniden Doğrulama Sonucu
Saha / Polis-Jandarma, Hasar / Sigorta, Hukukî / Hakim-Savcı-Avukat
Bütünlük İhlali Tespit Kaydı
Hukukî / Hakim-Savcı-Avukat, Noter / Özgünlük, Gözetim / Denetçi-Yönetici
Bütünlük İhlali Bildirimi
Noter / Özgünlük, Hukukî / Hakim-Savcı-Avukat, Gözetim / Denetçi-Yönetici
Kurcalama Tespit Bildirimi
Noter / Özgünlük, Hukukî / Hakim-Savcı-Avukat, Teknik / Üretici-Otonom-SaaS
Zincir Kırılması Bildirimi
Noter / Özgünlük, Gözetim / Denetçi-Yönetici, Hukukî / Hakim-Savcı-Avukat
Artefakt Geçersizlik Bildirimi
Hukukî / Hakim-Savcı-Avukat, Noter / Özgünlük, Gözetim / Denetçi-Yönetici
Olay İnceleme Raporu
Kâtip / Kabul, Saha / Polis-Jandarma, Hukukî / Hakim-Savcı-Avukat, Hasar / Sigorta, Teknik / Üretici-Otonom-SaaS
Doğrulama Özeti
Saha / Polis-Jandarma, İdari / Belediye-Kamu Kurumu, Noter / Özgünlük, Hukukî / Hakim-Savcı-Avukat, Hasar / Sigorta, Gözetim / Denetçi-Yönetici
Doğrulama İzi Eki
Saha / Polis-Jandarma, Noter / Özgünlük, Hukukî / Hakim-Savcı-Avukat, Teknik / Üretici-Otonom-SaaS
Hasar İnceleme Paketi
Hasar / Sigorta
Hukuki İnceleme Paketi
Hukukî / Hakim-Savcı-Avukat
Teknik İnceleme Paketi
Teknik / Üretici-Otonom-SaaS
İdari Paket
İdari / Belediye-Kamu Kurumu, Gözetim / Denetçi-Yönetici
Orijinallik Doğrulama Makbuzu
Kâtip / Kabul, Noter / Özgünlük, Gözetim / Denetçi-Yönetici
Vurgulanan aileler, aynı olay omurgası üzerindeki role-dayalı kurumsal pencereleri gösterir: Olay İnceleme Raporu, Doğrulama İzi Eki, Hukuki İnceleme Paketi, Teknik İnceleme Paketi, Hasar İnceleme Paketi ve Orijinallik Doğrulama Makbuzu.

Her rolün birincil inceleme önceliği, tercih edilen belge ailesi ve yasaklı birleştirme notu vardır. İz-bağlı belge aileleri (Olay İnceleme Raporu, Doğrulama Özeti, Doğrulama İzi Eki, Hasar İnceleme Paketi, Hukuki İnceleme Paketi, Teknik İnceleme Paketi, İdari Paket, Orijinallik Doğrulama Makbuzu) bu rollere eşlenir. Özgünlük, makbuz ve sürüm görünürlüğü tüm kabuklarda açık kalır.

Role dayalı kabuklar yapısal bir çerçevedir. Backend role switching henüz uygulanmamıştır; Verifier tek kanonik görünümle birincil inceleme istasyonu olarak kalır.

Dışa aktarma profilleri

  • claims: hasar odaklı kanıt paketi; JSON ve PDF olarak üretilebilir.
  • legal: hukuk inceleme odaklı kanıt paketi; JSON ve PDF olarak üretilebilir.
  • Export çıktıları tenant policy ve visibility class kurallarına tabidir; her recorded/derived öğe her pakete otomatik girmez.

Görünürlük sınıfları ve redaksiyon

Kanıt öğeleri bir görünürlük sınıfı taşıyabilir. Mevcut demoda claims_review, legal_review, technical_review ve restricted_internal sınıfları desteklenir. Claims export’ları yalnız claims_review uyumlu kanıtları içerir; legal export’ları claims_review, legal_review ve technical_review materyallerini içerebilir. restricted_internal materyaller dışa aktarılmaz. Politika nedeniyle hariç tutulan kanıtlar, kanonik olayı değiştirmeden redaction metadata ile beyan edilir.

Doktrin ve uygulama dili

Kamusal ürün kimliği doğrulayıcı-öncelikli tanık protokolü olarak kalır. tenant, policy, visibility class, diagnostics route ve export profile gibi terimler backend/API davranışı için uygulama açıklayıcılarıdır; QARAQUTU’yu generic bir SaaS konsoluna dönüştürmez.

Mevcut API rotaları

  • GET /healthtemel canlılık kontrolü.
  • GET /v1/eventsmevcut tenant için olay listesini döndürür.
  • GET /v1/events/:eventIdtek bir kanonik olay görünümünü döndürür.
  • POST /v1/events/:eventId/verifydemo bundle/manifest üzerinde olay-öncelikli doğrulama çalıştırır; kalıcı verification run ve trace üretir, verification_run_id, transcript_id, verification state ve trace özeti döndürür.
  • GET /v1/verifications/:verificationRunIdrun ID ile kalıcı verification run ve trace kaydını döndürür; bulunamazsa 404 verir.
  • POST /v1/events/:eventId/exportsverilen profil (claims, legal) ve biçimle (json, pdf) export üretir; body içinde profile, format ve purpose alanları taşınır. Tenant export profile veya visibility policy ihlali olan istekler kurumsal hata kodlarıyla (ör. POLICY_EXPORT_PROFILE_NOT_ALLOWED veya POLICY_VISIBILITY_VIOLATION) reddedilir ve export artifact üretilmez.
  • GET /v1/exports/:exportId/downloadprofil ve biçime göre export çıktısını ID üzerinden JSON/PDF olarak indirir.
  • GET /v1/system/diagnosticsçalışan backend için environment, dataset, schema ve build tanılama bilgilerini döndürür.
  • GET /v1/system/pdf-fixture/claims-longyalnız iç test için kullanılan, çok sayfalı claims PDF fixture döndüren rotadır; layout/paging doğrulaması içindir, tenant veya müşteri yüzüne açık kullanım için tasarlanmamıştır.

Tanılama ve smoke

Tanılama verileri /v1/system/diagnostics rotası üzerinden yayınlanır ve environment, sürümler, desteklenen export profilleri, yakın export/verification aktiviteleri, son verification run özeti, son smoke run detayları ve özet tenant policy bilgisini içerir. Smoke kontrolleri CLI ile çalıştırılır; availability, diagnostics, dataset, verifier (persisted run/trace dahil), verification okuma rotası, export oluşturma/indirme, receipt bağlama ve çok sayfalı PDF davranışı kontrol edilir. Her smoke çalıştırması kalıcı bir SmokeRun kaydı (ve kontrol başına SmokeCheck kayıtları) üretir.

Güncel sınırlamalar

  • Smoke run geçmişi şu anda diagnostics/admin yüzeylerinde kısa bir son çalıştırma listesi ile sınırlıdır.
  • Uygulama policy katmanı şu anda tenant-genel düzeyde modellenmiştir; kullanıcı/rol bazlı override henüz desteklenmez.

Yargılamaz; tanıklık eder.

QARAQUTU; kayıtlı kanıt, türetilmiş değerlendirme, doğrulama izi ve sınırlı artefakt ihracını birbirinden ayırır. Bağımsız hukukî, sigorta veya teknik yargının yerini almaz.