Denetim Kaydı
Denetim kaydı, ürün içi işlem incelemesi ve hesap verebilirlik için teknik kanıt sunar. Olay türü, varlık, aktör ve kurum bağlamı birlikte değerlendirilir. Bir kaydın bulunması hukuki delil kabulü, harici WORM depolama veya bütün kullanıcı etkileşimlerinin kaydedildiği garantisi değildir.
Yüzeyler ve Yetkiler
| Sayfa | Roller | API yolu |
|---|---|---|
https://app.mevzuatradar.com/compliance/audit | ADMIN, LEGAL_REVIEWER | /api/v1/audit-logs/compliance |
https://mevzuatradar.com/admin/audit | ADMIN | /api/v1/audit-logs |
API temel adresi https://api.mevzuatradar.com olur. Uçlar JWT ve rol
kontrolüyle korunur. EDITOR ve VIEWER okuma/dışa aktarma yetkisine sahip
değildir; izin verilen istemci olaylarını yazma uçları ayrı yetkilendirilir.
Liste ve tekil sorgu oturumun kurum kimliğiyle sınırlıdır.
targetOrganizationId, kayıt metadata’sındaki hedef kurum filtresidir;
başka kurumun tablosuna geçiş yetkisi vermez. Platform işlemi kendi kurum
kaydı içinde müşteri hedefini metadata olarak taşıyabilir.
Okuma ve Dışa Aktarma
Aşağıdaki tabloda müşteri uyum yüzeyinin yolları gösterilir. Yönetici
karşılıklarında /compliance parçası çıkarılır; rol ADMIN olur.
| Yöntem ve yol | Sonuç |
|---|---|
GET /api/v1/audit-logs/compliance | Liste ve sayfalama bilgisi |
GET /api/v1/audit-logs/compliance/:id | Tek kayıt |
POST /api/v1/audit-logs/compliance/export | Gövdedeki format ile CSV veya PDF liste çıktısı |
POST /api/v1/audit-logs/compliance/:id/export | Tek kaydın PDF çıktısı |
Liste page için en az 1, limit için 1–100 kabul eder; varsayılanlar 1 ve
50’dir. Yanıt { success: true, data: { items, meta } } biçimindedir.
meta, total, page, limit, totalPages içerir.
Filtreler
Liste sorgusunda şu alanlar bulunur:
dateFrom,dateTo: ISO tarihleri. Yalnız tarih verilen aralıklar UTC gün başlangıcı ve sonuyla genişletilir.userId,action,entityType,entityId,departmentId.actorRole,eventCategory,eventOutcome,surface,route.requestId,correlationId,aiRequestId.targetOrganizationId,adminActorId,accessReason,supportCaseId.hashStatus:VERIFIED,MISSING,UNVERIFIED.includeArchived:true/false; varsayılan olarakarchivedAtdolu kayıtlar listeye alınmaz.
Metadata filtreleri ilgili alanın eşitliğini arar. entityType büyük/küçük
harf ve alt çizgi varyantlarıyla kısmi eşleşme uygular. hashStatus=MISSING
özeti olmayan satırları seçer; diğer iki değer sorguda özeti bulunan satırları
seçer. Gerçek doğrulama durumu dönen her kayıtta ayrıca hesaplanır; bu iki
filtrenin tek başına geçerli/geçersiz zinciri ayırdığı varsayılmaz.
Dışa aktarma gövdesi filtreleri ve format: "csv" | "pdf" alanını kabul eder;
varsayılan CSV’dir. Liste çıktısı en fazla 100 kayıt içerir. Daha fazla
kayıt bulunduğunda başarılı yanıt truncated: true, limitApplied: 100
ile sınırlamayı bildirir; tarih veya diğer filtreler daraltılarak yeniden alınır.
Limit aşımı hata yanıtı değildir.
Çıktı dosyası doğrudan HTTP dosyası olarak dönmez. data içinde fileName,
mimeType, base64, totalRecords, generatedAt ve duruma göre
truncated/limitApplied alanları bulunur. Yönetici yüzeyinde
targetOrganizationId ile liste çıktısı alınırken accessReason, dateFrom
ve dateTo zorunludur; eksikse 400 döner. Rol kontrolü 403, kapsamda
bulunamayan tek kayıt 404 ile sonuçlanır.
Kayıt Alanları ve Gerçek Olaylar
Kayıt; id, userId, userName, userEmail, action, entityType,
entityId, metadata, previousHash, hashChain, hashStatus,
archivedAt, createdAt alanlarını taşır. Rol, route veya AI bağlamı gibi
alanlar olaya göre metadata’da bulunabilir; her olay için dolu olmaları zorunlu değildir.
| Olay | Üretildiği işlem |
|---|---|
DSR_REQUEST_CREATED | Veri sahibi talebi oluşturma |
DSR_REQUEST_UPDATED | Yönetici DSR kararı ve kullanıcı silme kaydı |
AUDIT_LOG_VIEWED | Filtresiz denetim listesi okuma |
AUDIT_LOG_FILTERED | Filtreli denetim listesi okuma |
AUDIT_LOG_DETAIL_VIEWED | Tek denetim kaydı okuma |
AUDIT_LOG_EXPORTED | CSV liste çıktısı |
AUDIT_LOG_PDF_GENERATED | PDF çıktısı |
VERIFICATION_RERUN_REQUESTED | Doğrulama çalışmasını yeniden isteme |
VERIFICATION_EXPORT_GENERATED | Doğrulama raporu dışa aktarma |
İstemci etkileşimleri ayrı semantik olay kataloğuna göre kaydedilir. AI alanları model rotası, istek/atıf kimlikleri ve maskeleme sürümü gibi bağlamı taşıyabilir. İç araç adı veya her tıklama için ayrı olay garantisi verilmez.
Maskeleme ve Kişisel Veri Sınırı
Ortak yazım ve okuma yardımcıları; token, secret, oturum, cookie, API anahtarı, ham prompt/yanıt/gövde gibi adlandırılmış metadata alanlarını maskeler. IP metadata anahtarlarında SHA-256 özet kullanılır. Derinlik, dizi ve metin boyutları sınırlandırılır. Bu anahtar tabanlı maskeleme serbest metnin tamamının kişisel veriden arındırıldığı anlamına gelmez. Aktör adı ve e-posta gibi alanlar yetkili okuma çıktısında bulunur; “denetim kaydı kişisel veri içermez” beyanı kurulamaz.
Bütünlük ve Saklama
Ortak değişmez kayıt servisi, kurum kilidi altında önceki özet ve sıra
bilgisiyle SHA-256 zincirli kayıt üretir. Diğer doğrudan yazım yollarının da
aynı zincire katıldığı varsayılmaz. Liste/ayrıntı eşleyicisi kaydın kendi
özetiyle doğrulama yaparak VERIFIED, MISSING veya UNVERIFIED döndürür.
VERIFIED, satırın özet hesabına ilişkindir; önceki satırların varlığı,
sırası veya tüm zincirin eksiksizliğinin bağımsız doğrulaması değildir.
Politika tabanlı şifreli arşiv, kaynak satırları değiştirmeden doğrulanmış nesne ve arşiv konum kaydı oluşturur. Saklama alt sınırı ürün politikasında 5 yıldır; otomatik etkinlik ve gerçek depolama için yapılandırma kanıtı gerekir. Saklama ayrıntıları ayrı açıklanır. Harici Object Lock, on yıllık saklama veya dış denetçi kabulü ayrı kanıt gerektirir.