privacy-gateway/backend/README.md

Privacy Gateway Backend

Node.js/Express API mit Ollama-Proxy und Session-Management für den Privacy Gateway.

Features

• Session-Management: Erstellen, Lesen, Löschen von Chat-Sessions
• PII-Anonymisierung: Automatische Erkennung und Maskierung sensibler Daten
• Ollama-Proxy: Transparente Weiterleitung zu externen KI-Modellen
• Streaming: SSE-basierte Antwort-Streams
• Caching: Redis-basierte Performance-Optimierung
• PostgreSQL: Persistente Datenspeicherung

Schnelleinstieg

# 1. Umgebungsvariablen konfigurieren
cp .env.example .env
# Bearbeite .env mit deinen Daten

# 2. Mit Docker Compose starten
docker-compose up -d

# 3. Ollama-Modell herunterladen
docker-compose exec anonymizer ollama pull llama3.2

API-Endpunkte

Methode	Endpunkt	Beschreibung
GET	/api/sessions	Alle Sessions abrufen
POST	/api/sessions	Neue Session erstellen
GET	/api/sessions/:id	Session mit Messages
DELETE	/api/sessions/:id	Session löschen
POST	/api/sessions/:id/chat	Chat-Nachricht senden
GET	/api/models	Verfügbare Modelle
GET	/health	Health Check
GET	/ready	Readiness Check

Entwicklung

# Lokale Installation
npm install
npm run dev

# Build
npm run build
npm start

Architektur

Client → Express API → [Anonymizer (Ollama)] → Externe KI
            ↓
       PostgreSQL + Redis

PII-Typen

• PERSON: Personennamen
• EMAIL: E-Mail-Adressen
• PHONE: Telefonnummern
• ADDRESS: Adressen
• ORG: Organisationen
• ID: Identifikationsnummern
• DATE: Persönliche Daten
• FINANCIAL: Bank-/Kreditkarten-Daten

Lizenz

Proprietär - Täger IT & Gebäude-Systeme