shieldx/ai-act-kompass
Claude 06574c5cfd
feat(ai-act-kompass): anti-AI print design and company personalization
- Full redesign: paper tone, serif typography, hairlines, rectangular
  stamp badges, mono labels — technical print look instead of SaaS style,
  no gradients/shadows/emoji
- Company profile settings (name, address, contact person, email, phone,
  website, logo upload as local data URL) persisted in localStorage and
  included in JSON backup (schema v2, v1 imports still supported)
- Print/PDF output via letterhead print view (window.print): logo,
  company name and contact data in header, contact line in footer;
  applies to risk report, action plan, Annex IV skeleton and inventory
- Company block also embedded in generated Markdown headers
- Minimal auditable Markdown renderer (no external parser), HTML-escaped
- 8 new tests (32 total)

Claude-Session: https://claude.ai/code/session_017YjohVNx1ZGNM4MX7tHpfv
2026-07-04 09:18:07 +00:00
..

🧭 AI-Act-Kompass

Standalone EU-AI-Act-Compliance-Toolkit für KMU. Local-first: keine Cloud, keine Telemetrie, keine Datenübertragung — alle Daten bleiben im Browser des Nutzers (localStorage, mit JSON-Export/-Import).

⚠️ Strukturierte Arbeitshilfe auf Basis der Verordnung (EU) 2024/1689 — keine Rechtsberatung.

Was es kann

  • Bewertungs-Wizard: erfasst ein KI-System und klassifiziert es automatisch nach der Systematik des AI Act — KI-Definition (Art. 3 Nr. 1) → verbotene Praktiken (Art. 5) → Hochrisiko (Art. 6, Annex I/III, inkl. Ausnahme Art. 6 Abs. 3 und Profiling-Sperre) → Transparenzpflichten (Art. 50) → minimales Risiko. GPAI-Pflichten (Art. 53 ff.) werden separat geflaggt.
  • KI-Inventar: alle Systeme des Unternehmens mit Risikoklasse, Rolle und Verantwortlichen — exportierbar als Markdown (AI Asset Register).
  • Pflichten-Checklisten: rollenspezifisch (Anbieter/Betreiber/Einführer/Händler) abgeleitete Pflichten mit Rechtsgrundlage, Geltungsfrist und Umsetzungsstatus.
  • Dokumenten-Generator: Risikoklassifizierungs-Bericht, Maßnahmenplan und Annex-IV-Grundgerüst (technische Dokumentation) als Markdown.
  • Fristen-Übersicht: alle Geltungsfristen des AI Act inkl. der Digital-Omnibus-Verschiebung (Annex III → 02.12.2027).

Architektur

Schicht Inhalt
src/engine/ Reine, getestete Regel-Engine: classify, deriveObligations, Dokumenten-Generatoren. Kein DOM, keine Seiteneffekte.
src/content/ Versionierter regulatorischer Content-Pack (Verbote, Annex-III-Bereiche, Pflichten, Fristen) als Daten — vorbereitet für einen späteren signierten Update-Feed.
src/store/ localStorage-Persistenz + Export/Import (JSON).
src/ui/ React-UI (Dashboard, Wizard, Detailansicht, Einstellungen), Deutsch.

Kein Backend, kein Build-Server nötig — dist/ ist eine statische Site und läuft von Datei-Share, Intranet oder localhost.

Entwicklung

npm install
npm run dev        # Dev-Server
npm test           # Engine-Tests (Vitest)
npm run typecheck  # TS strict
npm run build      # Statischer Build nach dist/

Geschäftsmodell (geplant)

Standalone-App + Abo für den Regulatory-Content-Feed: Die App gehört dem Kunden und läuft lokal; das Abo liefert aktualisierte Regelinhalte (delegierte Rechtsakte, harmonisierte Normen, Fristenänderungen), Templates und Norm-Mappings. Synergie mit @shieldx/core: Art.-15-Pflicht (Robustheit/Cybersicherheit gegen Prompt Injection & Co.) verweist direkt auf ShieldX als technische Umsetzung.