Kurumsal, hukuk, sigorta ve operasyon okuyucuları için sade akış. Teknik test/fixture dilinden ayrıdır.
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.
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.
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.
Telemetri, dashcam ve sensör verisi içeren araç olayı. Birden fazla taraf aynı kanonik olaya bağlı ihtilafa hazır özetlere ihtiyaç duyar.
Kayıtlı ve türetilmiş tek bir anlatıda birleşir; hasar ve hukuk ekipleri farklı nesnelere dayanır.
Kayıtlı/türetilmiş ayrımı, kanonik referanslar ve rol-sınırlı artefakt ihracı ile iz-bağlı hasar paketi.
Kurumlar, paylaşılan ve değiştirilemez kanıt omurgası olmadan karar veremez.
İmzalı belge veya dijital artifact için özgünlük doğrulaması. Manifest, makbuz ve sürüm zinciri açık kalmalıdır.
İz olmadan özgünlük iddiaları; makbuz ve manifest bağlantısı sunumda kaybolur.
Manifest, makbuz ID, sürüm zinciri ve iz ekleri ile özgünlük makbuzu — protokol mührü, hüküm değil.
İz olmadan özgünlük iddiadır; ayrım olmadan iz karışıklıktır.
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ı.
İz olmadan tanık kaydı; özgünlük hukuki iddia ile karıştırılır.
Özgünlük katmanı ile iz-bağlı tanık kaydı; doğrulama izi incelemeyi destekler, gerçeğin kendisi değil.
IP süreçleri tartışılmaz zaman damgası ve provenans gerektirir; iz omurgayı sağlar.
İ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.
Türetilmiş idari olgu olarak sunulur; sürüm ve erişim geçmişi opak.
Sürüm zinciri, erişim geçmişi, doğrulama özeti ile idari paket — türetilmiş ayrı kalır.
İdari hesap verebilirlik denetlenebilir zincir gerektirir; türetilmiş olgu kisvesine bürünemez.
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.
Kayıtlı ve türetilmiş karıştırılır; iz gerçek olarak sunulur; zincir-of-custody boşlukları.
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.
Ayrım olmadan saha kanıtı tartışmalıdır; doktrin olmadan iz sorumluluk tiyatrosudur.
Otonom sistem olayı — araç, drone veya robot. Teknik inceleme için sistem/senaryo/olay bağlantısı, kaynak referansları, paket yapısı ve iz.
Teknik rekonstrüksiyon kusur bulma olarak sunulur; iz hüküm ile karıştırılır.
Sistem/senaryo/olay, kaynak referansları, iz ekleri ile teknik paket — rekonstrüksiyon kusur isnadı değildir.
Üreticiler sorumluluk tiyatrosu olmadan ihtilaf düzeyinde iz gerektirir; teknik paket bunu sağlar.
Geliştirici odaklı terimler, API uçları ve tanılama içerikleri bu katmanda tutulur.
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.
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.
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.
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.
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.
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.
GET /health — temel canlılık kontrolü.GET /v1/events — mevcut tenant için olay listesini döndürür.GET /v1/events/:eventId — tek bir kanonik olay görünümünü döndürür.POST /v1/events/:eventId/verify — demo 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/:verificationRunId — run ID ile kalıcı verification run ve trace kaydını döndürür; bulunamazsa 404 verir.POST /v1/events/:eventId/exports — verilen 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/download — profil 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-long — yalnı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 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.
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.