Caveman.PrivacyGuard 1.0.1

Caveman.PrivacyGuard# <img width="1276" height="816" alt="Gemini_Generated_Image_tnxoi9tnxoi9tnxo" src="https://github.com/user-attachments/assets/5a8e3193-b7d3-4a41-90e6-e672467ce6cb" />

Caveman.PrivacyGuard 🛡️🇪🇺

Enterprise-grade PII & Privacy Analyzer for AI/LLM workflows
Rileva, valuta e maschera automaticamente dati sensibili in 27 paesi UE, con scoring del rischio, conformità GDPR/PCI-DSS/NIST e integrazione seamless con qualsiasi pipeline AI.

✨ Features

📦 Installazione

dotnet add package Caveman.PrivacyGuard

🚀 Quick Start

Modalità Avviso (Default)

var analyzer = new PrivacyAnalyzer { EnableAutoMasking = true };

// 🔹 Default: Inglese
var resEn = analyzer.Analyze("CF: RSSMRA80A01H501U, email: test@x.com");
Console.WriteLine($"[EN] Risk: {resEn.RiskLevel}\n{resEn.WarningMessage}");

// 🔹 Overload: Italiano
var resIt = analyzer.Analyze("CF: RSSMRA80A01H501U, email: test@x.com", "it");
Console.WriteLine($"[IT] Rischio: {resIt.RiskLevel}\n{resIt.WarningMessage}");

// 🔹 Overload: Tedesco
var resDe = analyzer.Analyze("Steuer-ID: 12345678901, IBAN: DE89370400440532013000", "de");
Console.WriteLine($"[DE] Risiko: {resDe.RiskLevel}\n{resDe.WarningMessage}");

Output:

🔒 Score: 26/100
⚠️  Avviso: ⛔ Dati rilevati: Codice Fiscale (IT), Email. Pseudonimizzazione obbligatoria.
✅ Safe for AI: False

var analyzer = new PrivacyAnalyzer { EnableAutoMasking = true };

var text = "Cliente: Mario Rossi, email mario@azienda.it, IBAN: IT60X0542811101000000123456";
var result = analyzer.Analyze(text);

Console.WriteLine($"🛡️  Testo sicuro per LLM:\n{result.MaskedText}");

Output:

🛡️  Testo sicuro per LLM:
Cliente: Mario Rossi, email [EMAIL], IBAN: [IBAN]

⚙️ Configurazione Avanzata

Whitelist (Esclusioni Sicure)

analyzer.AddToWhitelist(
    "test@company.eu",      // Email di test
    "127.0.0.1",            // IP localhost
    "IT00000000000"         // PIVA dummy
);

Validatori Personalizzati a Runtime

// Registra un nuovo validatore per un formato nazionale custom
ValidatorRegistry.Register("MY_CUSTOM_ID", value => 
    value.Length == 10 && value.StartsWith("XYZ") && value.All(char.IsDigit));

// Poi usalo nel tuo YAML custom:
// validator_name: "MY_CUSTOM_ID"

📐 Caricamento YAML Esterno (Opzionale)

// Per caricare regole aggiornate senza ricompilare la libreria
// (implementazione da aggiungere su richiesta)
// analyzer.LoadCustomYaml("path/to/custom-rules.yaml");

📐 Architettura del Punteggio

Score Finale = 
  (BaseScore × CorrelationMultiplier) + 
  (ContextBoost × 12) + 
  (DensityBonus × 18)

Soglie di Rischio:

🔐 Compliance & GDPR

PrivacyAnalysisResult.ComplianceFlags mappa automaticamente i dati rilevati a framework normativi:

if (result.ComplianceFlags.Contains("GDPR Art.4(1)"))
{
    // Logica per base giuridica, DPIA, minimizzazione
}
if (result.ComplianceFlags.Contains("PCI-DSS"))
{
    // Crittografia, segmentazione rete, audit
}

⚠️ Disclaimer: Questa libreria è uno strumento tecnico di supporto. Non sostituisce una Valutazione d'Impatto sulla Protezione dei Dati (DPIA) né il parere di un DPO. La conformità GDPR richiede valutazioni contestuali, basi giuridiche e processi organizzativi.

🧪 Testing & Performance

// Benchmark rapido
var analyzer = new PrivacyAnalyzer();
var sw = System.Diagnostics.Stopwatch.StartNew();

for (int i = 0; i < 10_000; i++)
{
    analyzer.Analyze("Testo con email test@example.com e IBAN DE89370400440532013000");
}

sw.Stop();
Console.WriteLine($"⚡ 10k analisi in {sw.ElapsedMilliseconds}ms ({10_000.0 / sw.ElapsedMilliseconds:F1} req/sec)");

🤝 Contributing

Fork il repo Crea un branch per la tua feature (git checkout -b feature/nuovo-paese) Aggiungi regole in rules.yaml + validatori in ValidatorRegistry.cs Aggiungi test in tests/ (xUnit) PR con descrizione chiara e esempi 🌍 Per aggiungere un nuovo paese: segui lo schema YAML esistente, implementa il validatore (se necessario) e aggiungi la voce nella tabella del README.

📄 License

Distribuito sotto licenza MIT. Vedi LICENSE per dettagli.

🆘 Support & Roadmap

🛡️ Proteggi i dati, abilita l'AI. Compliance by design.