stephanev/risk-analysis-editorBrowserbasierter Risikoanalyse-Editor zur Erstellung von Risikomatrizen, Risikoregistern und Maßnahmenplänen. Unterstützt EBIOS RM, ISO 27005 und CNIL-DSFA mit Offline-.rae.json-Dateien.
# <img src="https://raw.githubusercontent.com/stephanev/risk-analysis-editor/HEAD/docs/images/RAE-logo-mini.svg" alt="" height="38" align="top"> Risk Analysis Editor (RAE)
**Englisch** · [Französisch](https://github.com/stephanev/risk-analysis-editor/blob/main/README.fr.md)
Eigenständiges Tool zum **Erstellen und Visualisieren von Risikomatrizen** — inhärentes (Brutto-)Risiko und Rest- (Netto-)Risiko — mit einem offenen, dokumentierten Dateiformat, `.rae.json`.
### ▶️ [App öffnen](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) · 📖 [**Benutzerhandbuch**](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md) · 🎬 [Video-Tutorials](https://www.youtube.com/@RiskAnalysisEditor) · ⬇️ [Herunterladen](https://github.com/StephaneV/Risk-Analysis-Editor/releases/latest/download/risk-analysis-editor.html)
*Keine Installation: Das Tool läuft vollständig in Ihrem Browser. Zwei sofort öffnungsbereite Demos: 📊 eine [**von EBIOS RM inspirierte** Risikoanalyse](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html?file=../examples/demo-ebios-rm-information-system-enriched.rae.json) (12 Risiken, 11 Maßnahmen) und 🛡️ [ein Beispiel für den Risikoanalyse-Teil einer DSFA](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html?file=../examples/demo-dpia-ohs-enriched.rae.json), inspiriert von der CNIL-PIA-Methode, mit Fokus auf befürchtete Ereignisse, Kontrollen und Restrisiko (12 Risiken, 12 Maßnahmen) — beide mit Beschreibungen, Notizen, farbigen **Tags**, **Fortschrittsbalken**, Verantwortlichen und Begründungen pro Verknüpfung sowie einem **wiederverwendbaren Objektmodell** (Geschäftswerte, unterstützende Werte, Risikoquellen, Stakeholder, Szenarien…) und einem vorkonfigurierten Bericht. Der Download enthält **die einzelne HTML-Datei** der [neuesten Version](https://github.com/StephaneV/Risk-Analysis-Editor/releases/latest): Doppelklicken Sie darauf, um **offline** zu arbeiten.*
> ***Matrizen › Trajektorie**-Ansicht: Jeder Pfeil verbindet die Anfangsposition eines Risikos (gestrichelte Kontur) mit seiner Restposition (durchgezogene Kontur).*
> ***Statistik**-Tab: zentrale Zähler und Verteilungen — nach Kritikalität (anfänglich → residual), Kategorie, Maßnahmentyp und -status, benutzerdefiniertem Feld und Abdeckung — als Tabellen und/oder Diagramme (Donut oder Kreis). Das Raster ist anpassbar und per Drag-and-Drop neu anordenbar und folgt dem aktiven Filter.*
> ***Maßnahmenplan** — Zeitachse: Kontrollen nach Fälligkeitsdatum sortiert, mit Verantwortlichem, Status und abgedeckten Risiken. Auch als **Statusboard (Kanban)** und **nach Verantwortlichem** verfügbar, mit Fortschritts- und Überfälligkeitsverfolgung.*
---
## Überblick
**Risk Analysis Editor** ist eine **eigenständige** Web-App: eine einzelne HTML-Datei ohne Netzwerk- oder externe Dienstabhängigkeit zur Laufzeit, die **offline** funktioniert (ein einfacher Doppelklick genügt — keine Installation, kein Server).
Sie ermöglicht eine generische, strukturierte Risikoanalyse: Bewertungskonfiguration, Erfassung von Risiken und Maßnahmen, anfängliche und residuale Bewertung, Maßnahmenplan, Visualisierungen und Berichte.
Das Tool basiert auf einem generischen, konfigurierbaren Modell, das an ein internes Framework anpassbar und nutzbar ist, um Analysen nach Ansätzen wie ISO 27005, EBIOS RM oder DSFA zu strukturieren und darzustellen. Das Raster ist weitgehend konfigurierbar: Dimensionen, Achsen, Stufen, Beschriftungen, Schwellenwerte, Farben und Bewertungsmethode; es wird in der Datei gespeichert.
Die gesamte Analyse passt in eine eigenständige **`.rae.json`**-Datei: Raster, Risiken, Maßnahmen, Verknüpfungen und anfängliche/residuale Bewertungen (plus aktuelle, im 3-Stufen-Modus). Das Format ist **spezifiziert** ([technische Dokumentation](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/SPEC-format-analyse-risque.md), auf Französisch) und wird von einem **JSON-Schema** zur Validierung begleitet ([schema-analyse-risque.json](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/schema-analyse-risque.json)). Eigenschaftsnamen sind auf Englisch; Werte (Beschriftungen, Beschreibungen) bleiben in der Sprache der jeweiligen Analyse.
**Offizielle Website:** [www.risk-analysis-editor.com](https://www.risk-analysis-editor.com/) — Präsentation, Screenshots und Links.
**YouTube-Kanal:** [@RiskAnalysisEditor](https://www.youtube.com/@RiskAnalysisEditor) — Video-Tutorials.
**Erste Schritte:** Der illustrierte **[Benutzerleitfaden](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md)** (auf Französisch) führt durch jeden Bildschirm und jede Funktion.
**Einstiegspunkt:** [die App online öffnen](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) — oder für die **Offline**-Nutzung das Repository herunterladen und [`app/risk-analysis-editor.html`](https://github.com/stephanev/risk-analysis-editor/blob/main/app/risk-analysis-editor.html) per Doppelklick öffnen.
### Methodische Einordnung
RAE konzentriert sich auf die **Strukturierung, Bewertung und Darstellung von Risiko- und Maßnahmenregistern**: Definition des Bewertungsrasters, Erst- und Restbewertung, Verknüpfung von Maßnahmen mit Risiken, Nachverfolgung des Aktionsplans, Visualisierung der Matrizen und Erstellung von Berichten.
Das generische, konfigurierbare Modell ermöglicht die Arbeit mit verschiedenen Ansätzen — insbesondere ISO 27005, EBIOS RM, DPIA/PIA CNIL oder einem internen Rahmenwerk —, ohne eine einzige Methodik vorzuschreiben. Die bereitgestellten Vorlagen und Beispiele sind **von diesen Ansätzen inspiriert** und dienen als anpassungsfähige Ausgangspunkte. RAE zielt jedoch nicht darauf ab, die vollständige Gesamtheit der Schritte, Objekte und Kontrollen der einzelnen Methoden abzubilden: deren vollständige Umsetzung bleibt durch die geltenden Rahmenwerke und den Kontext der Analyse geleitet.
RAE bietet somit ein Rahmenwerk, das **strukturierter und konsistenter als eine Sammlung von Tabellenkalkulationen** ist und zugleich **leichter, portabler und einfacher bereitzustellen als eine GRC-Plattform**. Es eignet sich besonders für eigenständige Analysen, Workshops, Beratungsprojekte und Organisationen, die die lokale Kontrolle über ihre Daten in einem offenen, dokumentierten Format behalten möchten.
---
## Funktionen
### Visualisierung
- **Zwei nebeneinanderliegende Matrizen**: *inhärentes (Brutto-)* und *Rest- (Netto-)* Risiko.
- **Trajektorienansicht**: Ein Pfeil verbindet die Ausgangsposition jedes Risikos mit seiner Restposition; nicht reduzierte Risiken werden hervorgehoben.
- **Layout-Algorithmen** für die Trajektorien zur Reduzierung von Kreuzungen und Überlappungen: gerade Pfeile, zentriertes quadratisches Raster.
- **Chip-Layout-Strategien**, wenn eine Zelle mehrere Risiken enthält: Raster, Zeile, Spalte, Cluster/Spirale, „+N“-Überlauf…
- **Manuelle Platzierung** von Chips per Drag-and-Drop, mit einem konfigurierbaren N×N-Einrastraster und in der Datei gespeicherten Positionen.
- **Interaktive Chips**: **Klicken** auf einen Chip öffnet den Risikodatensatz zum Bearbeiten; **Ziehen** in eine andere Zelle **bewertet das Risiko neu** (Tastatur: `Enter`/`Space` zum Bearbeiten, `Ctrl`+Pfeiltasten zum Neubewerten).
- **Statistik-Tab**: ein Kennzahlen-Dashboard — Schlüsselzähler, Verteilung nach **Kritikalität** (initial → residual), nach Risiko-**Kategorie**, nach Maßnahmen-**Typ** und **Status**, nach **benutzerdefiniertem Feld** und **Abdeckung** (Risiken ohne Kontrolle, verwaiste Kontrollen). Jeder Block als **Tabelle und/oder Diagramm** (Donut oder Kreis). Ein **anpassbares** Raster (Blöcke ein-/ausblenden, Größe, Form), das **per Drag-and-Drop neu angeordnet** werden kann; folgt dem weitergegebenen Filter; Einstellungen in der Datei gespeichert.
- **Radare**: ein eigener Tab für das **Risikoprofil** als Radar- (Spinnennetz-)Diagramm — eine **Achse** pro Wert einer **Dimension** (Kategorie oder benutzerdefiniertes Feld), mehrere **Metriken** (durchschnittliche, maximale, kumulative oder gewichtete Kritikalität, Risikoanzahl) und **Bewertungen** (initial, residual, nebeneinander oder überlagert zur Darstellung der Reduktion). Konfigurierbare Darstellung (*Einstellungen › Radare*), eine Wertetabelle, **PNG/SVG**-Export und Einbindung in den Bericht; folgt dem weitergegebenen Filter.
### Bewertungsraster
- **Konfigurierbare Achsen** (vertikal / horizontal): freie Anzahl von Stufen, Bezeichnungen und Tooltip-Beschreibungen.
- **Methoden zur Score-Berechnung**: Produkt (P × S), Summe (P + S) oder **Matrix** (Stufe Zelle für Zelle definiert, mit einem eigenen Editor).
- **Kritikalitätsstufen**: farbige Zonen, Schwellenwerte, Farbe, Akzeptanzentscheidung und Beschreibung, mit einer **Abdeckungsprüfung** der erreichbaren Scores.
- **Zwei oder drei Bewertungsstufen** *(Option, pro Analyse)*: neben dem klassischen Modus **initial → residual** ein Modus **inherent → current → residual** (Bruttorisiko, dann mit den Maßnahmen *in place*, dann das Ziel mit vorgeschlagenen/geplanten/in Bearbeitung befindlichen Maßnahmen). Umschaltbar unter *Einstellungen › Bewertungsraster*; passt die Dateneingabe, Register, die **Matrizen** (nebeneinander und eine **3-Punkte-Trajektorie**), die **Radare**, die **Statistiken**, den **Bericht** und die **Word/Excel/CSV**-Exporte an. Standard: 2 Stufen (vollständige Abwärtskompatibilität).
- **Achsentransposition** (vertikal ↔ horizontal) mit einem Klick, einschließlich Bewertungen und Platzierungen.
### Dateneingabe
- **Übersicht**: eigener Tab für die Dokumentmetadaten der Analyse (Titel, Status, Autor, Organisation, Geltungsbereich, Methodikreferenz, Beschreibung) und die Werte benutzerdefinierter Felder auf Analyseebene.
- **Risikoregister**: Kategorie, Verantwortlicher, Beschreibung, Erst- und Restbewertung (und **aktuelle** im 3-Stufen-Modus), Änderungsindikator.
- **Kontrollen / Maßnahmen**: Typ (technisch / organisatorisch…), Status (farbcodiert), Verantwortlicher, Fälligkeitsdatum, Kosten.
- **Verknüpfungen Risiko ↔ Maßnahme**, in zwei Untertabs: *Zuordnungen* (Kreuztabelle mit Kontrollkästchen, n:m) und *Details* (bearbeitbares Register, in dem jede Verknüpfung eine **Notiz** und eigene **benutzerdefinierte Felder** trägt); angereicherte Verknüpfungen werden in der Kreuztabelle gekennzeichnet.
- **Aktionsplan**: Maßnahmenverfolgung in drei Ansichten (Zeitachse, Kanban nach Status, gruppiert nach Verantwortlichem), **überfällige** Maßnahmen hervorgehoben (Fälligkeitsdatum überschritten und nicht abgeschlossen) sowie **Gesamtfortschritt** (Balken + Zähler pro Status). Jede Maßnahme lässt sich per **Doppelklick** — oder über die **✎-Schaltfläche** in jeder Zeile/jeder Karte — zum Bearbeiten öffnen (Fälligkeitsdatum, Status, Verantwortlicher, Notizen, benutzerdefinierte Felder) und im Kanban per **Drag-and-Drop** zwischen Statusspalten verschieben.
- **Benutzerdefinierte Felder**: Definieren Sie in den *Einstellungen* zusätzliche Felder, die an die Analyse, Risiken, Maßnahmen oder Verknüpfungen angehängt werden — viele Typen (Ja/Nein, Ganzzahl, Dezimalzahl, Datum, einzeiliger Text, Langtext, URL, E-Mail, Telefon, muster geprüfter Text, **Farbe**, **Bild** (eingebettet, als Miniaturansicht mit Klick-zum-Vergrößern-Lightbox angezeigt), Dropdown, Checkliste, **farbige Tags** mit Einzel-/Mehrfachauswahl, **Skala** (nummerierte Stufen, in Berechnungen verwendbar), **Fortschrittsbalken** in %, und **berechneter Wert** (eine Formel im Excel-Stil, die live anhand der anderen Felder und abgeleiteter Größen neu berechnet wird), plus den **Referenz**-Typ — siehe unten), mehrsprachige Beschriftungen (Beschriftung und Hilfe werden in der aktiven Oberflächensprache eingegeben; fehlt eine Übersetzung, wird der Code angezeigt), ein Pflichtfeld-Kennzeichen und Grenzen (Min/Max, Länge, Anzahl der Einträge) und — bei Listen (Dropdown, Checkliste, Tags) — eine **Beschreibung pro Wert**, die in einem Abschnitt **„Feldreferenz“** des Berichts gesammelt wird; Werte werden in den Datensätzen (Risiken, Maßnahmen) und im Tab *Übersicht* (Analysefelder) mit Validierung eingegeben und sind im **Bericht** sowie im **CSV-Import/-Export** enthalten.
- **Objekte & Referenzen**: Definieren Sie über einfache benutzerdefinierte Felder hinaus eigene **Objekttypen** (Support-Assets, Geschäftswerte, Stakeholder, Risikoquellen, Datenempfänger…) mit typisierten **Attributen** und legen Sie dann beliebig viele **Instanzen** im eigenen Tab *Objekte* an (Untertabs pro Typ, Sortierung, CSV-Import/-Export). Ein **Referenz**-Feld verknüpft dann ein Risiko, eine Maßnahme, eine Verknüpfung, die Analyse oder ein anderes Objekt mit einer oder mehreren Instanzen — oder mit den eigenen **Risiken/Maßnahmen** der Analyse, dargestellt als anklickbare **R*x*/M*x*-Pillen** (Code + Beschriftungs-Tooltip). Referenzen fließen in Filter, Statistiken und Radare ein, erscheinen im Bericht und in den Word-/Excel-Exporten und bleiben dank **kaskadierender Löschung** konsistent. Ein **Schema-Viewer** (in [`tools/`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools/schema-viewer)) zeichnet das Objekt-/Referenzmodell als Entity-Relationship-Diagramm.
- **CSV-Import** von Risiken, Maßnahmen und Verknüpfungen: Spalten benannt nach den **englischen** Schlüsseln des Formats, automatisch erkanntes Trennzeichen; Zusammenführung nach Kennung (Risiken/Maßnahmen); Integritätsprüfung und Deduplizierung (Verknüpfungen).
- **CSV-Export von Risiken, Maßnahmen und Verknüpfungen**: Kopfzeilen = **englische** Schlüsselnamen (unabhängig von der Oberflächensprache identisch), `;`-Trennzeichen und UTF-8-BOM (Excel), mit schreibgeschützten abgeleiteten Spalten (Score/Kritikalität für Risiken; abgedeckte Risiken für Maßnahmen; Beschriftungen für Verknüpfungen); erneut importierbar.
- **Sortierung und Filterung** der Listen Risiken, Maßnahmen und Aktionsplan: Textsuche, Sortierung per Klick auf Spalten (aufsteigend → absteigend → ursprüngliche Reihenfolge) und Dropdown-Filter (Kategorie, Typ, Status, Verantwortlicher, „nur überfällige“). Wenn keine Sortierung aktiv ist, können Zeilen **per Drag-and-Drop neu angeordnet** werden (⠿-Griff beim Überfahren der Zeile, Strg+↑/↓ mit der Tastatur): die neue Reihenfolge wird in der Datei gespeichert und bestimmt die Standardanzeige, den Bericht und die Exporte.
- **Weitergegebene Filterung**: Die Dropdown-Filter für **Kategorie** (Risiko), **Typ** und **Status** (Maßnahme) sowie jedes als *filterbar* deklarierte **benutzerdefinierte Feld** (geschlossene Werte: Dropdown, Checkliste, Tags, Ja/Nein) **werden entlang der Verknüpfungen weitergegeben** — sie beschränken jeden Tab, die Matrizen und den Bericht: Ein Filter auf ein Risiko behält nur die Maßnahmen und Verknüpfungen, die sich darauf beziehen, und symmetrisch dazu bei einem Maßnahmenfilter. Kriterien werden kombiniert (UND), und jeder aktive weitergegebene Filter bleibt in jeder Leiste, in der er gilt, **sichtbar und bearbeitbar**. Der weitergegebene Filter (Basis + benutzerdefinierte Felder) wird **in der Datei gespeichert** und beim erneuten Öffnen der Analyse wiederhergestellt. Die Textsuche und die aktionsplanspezifischen Filter (*Verantwortlicher*, *überfällig*) bleiben auf ihre jeweilige Ansicht beschränkt.
- **Eingabehilfen & Sicherheitsnetze**: Ein-Klick-**Duplizieren** (⧉) eines Risikos oder einer Maßnahme, **„Speichern und neu“** für die Stapeleingabe, ein **„Rückgängig“**-Toast nach jedem Löschen, anklickbare R*x*/M*x*-Pillen, die den referenzierten Datensatz öffnen, ein optionales *„Nicht mehr fragen“* für Verknüpfungsbestätigungen, eine Warnung beim Bearbeiten eines bereits bewerteten Rasters und ein **Hilfe-&-Tastenkürzel**-Panel (Datei-Menü oder die Taste `?`).
- **Registeransichten & Spalten** (Risiken, Maßnahmen, Verknüpfungsdetails, Objekte): Jedes Register bietet drei Darstellungen, die über einen **Symbolselektor** gewählt werden — **Tabelle**, **Master·Detail** (kompakte Liste + ein **Detail-Drawer** pro Zeile) und **Karten** (eine Karte pro Datensatz) — sowie eine **Dichte**-Steuerung (Komfortabel / Kompakt / Dicht). Ein dreistufiger **Spaltenmanager** (**⚙ Spalten**-Schaltfläche in der Symbolleiste, in jeder Ansicht verfügbar) legt für jede Spalte — einschließlich **Spalten benutzerdefinierter Felder** — fest: **Inline** (eine Spalte in Tabelle und Master·Detail, und auf Karten angezeigt), **Im Detail** (aus der Tabelle ausgeblendet, in den Master·Detail-Drawer verschoben, weiterhin auf Karten angezeigt) oder **Ausgeblendet** (überall); standardmäßig klassifiziert die App jede Spalte automatisch als Inline oder Im Detail (Langtext- und Sekundärfelder gehen in Im Detail), niemals als Ausgeblendet. Spalten lassen sich über die ▲/▼-Pfeile oder durch Ziehen der Kopfzeilen neu anordnen; ID und Aktionen bleiben fixiert; eine **Vollbreite**-Option und ein **„Sortieren nach ▾“**-Menü (zum Sortieren, wo es keine Kopfzeile gibt, z. B. bei Karten) runden das Ganze ab. Verknüpfungs-**Notizen werden als Markdown gerendert** in allen drei Ansichten. **Bearbeiten:** Ein einzelner Klick bewirkt nichts (langer abgeschnittener Text wird gezoomt, ein Bild öffnet eine Lightbox); ein **Doppelklick** auf ein Feld öffnet den Datensatz, positioniert auf diesem Feld, in jeder Ansicht — mit einer expliziten **✎-Schaltfläche** im Aktionsplan. Das gesamte Layout — Ansicht, Dichte, Spaltenzustände und -reihenfolge — wird **in der Datei gespeichert** (`extensions.display`).
### Datei & Export
- **Neu / Laden / Speichern** im `.rae.json`-Format.
- **Laden per URL**: Beim Öffnen des Tools mit `?file=<url>` (Alias `?url=`) wird die referenzierte Analyse beim Start automatisch geladen — z. B. `risk-analysis-editor.html?file=../examples/demo-ebios-rm-information-system.rae.json`. Erfordert, dass das Tool über HTTP(S) bereitgestellt wird (das `file://`-Protokoll blockiert dieses Lesen).
- **Startup-URL-Parameter** (kombinierbar): `?lang=fr|en|it` erzwingt die Oberflächensprache (überschreibt die in der Datei gespeicherte Sprache und die Browsersprache); `?tab=<tab>[.<sub-tab>]` öffnet einen bestimmten Tab und optional dessen Untertab — z. B. `?tab=matrices.traj` (Matrizen › Trajektorie), `?tab=settings.grid`, `?tab=plan`; `?filter=code:value;…` wendet Filter für benutzerdefinierte Felder an (überschreibt den gespeicherten Teil des Filters für benutzerdefinierte Felder und wird anschließend aus der Adressleiste entfernt). Unbekannte Tokens werden ignoriert.
- **Matrix-Export** als **PNG** (×1 / ×2 / ×3) und **SVG**, mit Titel, Untertitel, Achsenbeschriftungen und Legende; Kopieren in die Zwischenablage, wenn diese Funktion unterstützt und vom Browser sowie vom Laufzeitkontext erlaubt wird.
- **Word-Export (.docx)** des Berichts und **Excel-Export (.xlsx)** der Analyse: Menü *Datei* (und eine Schaltfläche im Tab *Bericht* für Word). Die Word-Datei übernimmt die Abschnitte, ihre Reihenfolge, die Spalten und den für den Bericht konfigurierten Umfang und ergänzt eine **Deckblattseite**, ein **Word-natives Inhaltsverzeichnis**, das bei Bedarf beim Öffnen aktualisiert werden kann, sowie eine **native Kopf-/Fußzeile** (mit Seitenzahlen) — Metadaten, Präsentation, Zusammenfassung, Raster, **Matrizen als eingebettete Bilder**, Register und detaillierte Tabellen — nutzbar als Grundlage für die Integration in eine Unternehmensvorlage; die Excel-Arbeitsmappe enthält formatierte Tabellenblätter (Zusammenfassung / Risiken / Maßnahmen / Verknüpfungen, **plus ein Tabellenblatt pro Objekttyp**) mit typisierten Zellen (echte Datums- und Zahlenwerte), Farben für Kritikalität und Status, fixierten Kopfzeilen und Autofiltern. Beide werden **lokal und offline** erzeugt: handgeschriebenes OOXML plus die eingebettete, MIT-lizenzierte Bibliothek [fflate](https://github.com/101arrowz/fflate) für den ZIP-Container — weiterhin als einzelne HTML-Datei verteilt, ohne externe Ressource zur Laufzeit.
- **Druckbarer Bericht**: Der Tab *Bericht* erzeugt einen konfigurierbaren Bericht aus den in RAE verwalteten Informationen (Metadaten, ein **Übersichtsblock** mit der Analysebeschreibung und benutzerdefinierten Feldern, Zusammenfassung, Raster und Kritikalitätsstufen mit Beschreibungen, **Feldreferenz und Legenden** (dokumentierte Dropdown-/Tag-Werte), Initial-/Residual- und Trajektorienmatrizen als Vektoren, Risikoregister, detaillierte Risiko- und Maßnahmenlisten mit ihren Beschreibungen **und Werten benutzerdefinierter Felder**, Verknüpfungen), dargestellt in einem hellen, druckfreundlichen Stil (→ PDF über den Browser).
- **Anpassbarer Bericht** (*Einstellungen › Bericht*): Wählen Sie die **Abschnitte** und ihre **Reihenfolge** (Drag-and-drop), die **Deckblattseite** (Logo, Titel, Untertitel, Hinweise, Vertraulichkeit, Freitext), das **Inhaltsverzeichnis**, eine dreizonige **Kopf-/Fußzeile** mit Variablen (`{title}`, `{date}`, `{page}/{pages}`…), die **Spalten** jeder Tabelle, die Metadatenzeilen, das Layout der Initial-/Residual-Matrix (nebeneinander oder gestapelt) und die Ansicht des Aktionsplans sowie den **Umfang** (vollständige Analyse oder gefilterte Teilmenge). Dieselbe Konfiguration bestimmt die Abschnitte, ihre Reihenfolge, die Spalten und den Umfang der **Bildschirm-/PDF-** und **Word**-Darstellungen (mit nativem Inhaltsverzeichnis und Kopf-/Fußzeile); sie wird in der Datei gespeichert (`extensions.display.report`).
- **Word-Vorlagen-Berichtsgenerator**: *Datei › Mit einer Word-Vorlage exportieren…* füllt **Ihre eigene `.docx`-Vorlage** — `{{ … }}`-**Tags** (Werte, Schleifen, Bedingungen, `matrix`- / `radar`- / `stat`- / `table`-Blöcke, Logo…) werden durch die Analysedaten ersetzt, während das Dokument Ihr gesamtes Layout beibehält. Ein **Warnbericht** kennzeichnet nicht erkannte Tags. **Gebrauchsfertige Vorlagen** (klassisch, nach Kategorie aufgeteilt, Referenzblätter, Dashboard, originalgetreue Nachbildungen des nativen Berichts) stehen in [`word-templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates) bereit, zusammen mit einem **[Schreibleitfaden](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/guide-redaction-modeles.md)** und einem **[Schlüsselwortkatalog](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/catalogue-mots-cles-rapport.md)**.
### Anpassung
- **Themes**: dunkel, hell.
- **Sprachauswahl**: Französisch / Englisch / Italienisch (Oberfläche und Standarddaten für eine neue Analyse), Architektur erweiterbar auf weitere Sprachen.
---
## Projektstruktur
| Ordner | Inhalt |
|---|---|
| [`app/`](https://github.com/stephanev/risk-analysis-editor/blob/main/app) | Die Anwendung (`risk-analysis-editor.html`). |
| [`docs/`](https://github.com/stephanev/risk-analysis-editor/blob/main/docs) | **Benutzerdokumentation** (auf Französisch): der illustrierte [Benutzerleitfaden](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md) und gemeinsame Bilder. |
| [`specs/`](https://github.com/stephanev/risk-analysis-editor/blob/main/specs) | **Spezifikationen** (auf Französisch): Dateiformat-Spezifikation, JSON-Schema, Layout-Strategien und die **Spezifikation des Word-Berichtsgenerators** ([`SPEC-rapport-modele-word.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/SPEC-rapport-modele-word.md)). |
| [`examples/`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples) | Beispielanalysen im Format `.rae.json` (Französisch und Englisch), darunter zwei **befüllte Demos, die für die Funktionen von RAE repräsentativ sind**: eine **von EBIOS RM inspirierte** Risikoanalyse (`demo-ebios-rm-*.rae.json`) und ein Beispiel für den Risikoanalyse-Teil einer DPIA, inspiriert von der CNIL-PIA-Methode, für einen arbeitsmedizinischen Dienst (`demo-aipd-sst.rae.json` / `demo-dpia-ohs.rae.json`) — mit farbigen Tags, Fortschrittsbalken, Verantwortlichen und begründeten Verknüpfungen. Jede ist auch als **angereicherte „Objekte“-Variante** (`…-objets-enrichi` / `…-enriched`) verfügbar, die Geschäftswerte / Daten, unterstützende Werte, Risikoquellen, Stakeholder und Szenarien modelliert, mit einem vorkonfigurierten Bericht. Siehe [`examples/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples/README.md). |
| [`templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/templates) | **Startvorlagen** (`xxx.template.<lang>.rae.json`, eine Datei pro Sprache) für Analysen, inspiriert von gängigen Methoden und Frameworks: leere Skelette — Raster, Kritikalitätsstufen und benutzerdefinierte Felder vorkonfiguriert, keine Risiken oder Maßnahmen. **EBIOS RM**, **CNIL PIA / DPIA**, **ISO/IEC 27005** und ein **generisches** 5×5 — plus **angereicherte EBIOS RM- / CNIL PIA-Varianten** mit Objekttypen und einem vorkonfigurierten Bericht — jeweils in **Französisch, Englisch und Italienisch**. Aufgeführt unter *Von einer Vorlage starten* im Onboarding-Block (die Datei, die der aktuellen Oberflächensprache entspricht, wird geladen); das Öffnen einer Vorlage (von dort oder über *Laden…*) startet eine neue, **nicht verknüpfte** Analyse. Sie können die aktuelle Analyse auch mit **Datei › Als Vorlage speichern…** in eine Vorlage umwandeln und mit **Datei › Startbildschirm** zum Onboarding-Block zurückkehren. |
| [`word-templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates) | **Word-Berichtsvorlagen** (`.docx`) für den vorlagenbasierten Berichtsgenerator: `{{ … }}`-Tags werden durch die Werte, Tabellen, Matrizen, Radare und Diagramme der Analyse ersetzt. *Klassische*, *nach Kategorie aufgeteilte*, *Referenzblatt-* und *Dashboard*-Vorlagen sowie originalgetreue Reproduktionen des nativen Berichts (saubere und **annotierte** Versionen), dazu ein **Schreibleitfaden** und der **Schlüsselwortkatalog**. Siehe [`word-templates/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/README.md). |
| [`tools/`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools) | **Entwicklungswerkzeuge**: Skripte zum Erzeugen der Screenshots (Leitfaden und README) und zum Einbetten der Vorlagen in die Anwendung. Siehe [`tools/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools/README.md). |
---
## Erste Schritte
1. [Die App online öffnen](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) — oder [`app/risk-analysis-editor.html`](https://github.com/stephanev/risk-analysis-editor/blob/main/app/risk-analysis-editor.html) aus einer lokalen Kopie in einem aktuellen Browser öffnen.
2. Das Tool startet mit einer **leeren Analyse**, geöffnet auf dem Tab **Übersicht**.
3. Mit **Laden…** eine `.rae.json`-Datei öffnen (z. B. aus [`examples/`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples)), mit **Speichern** die eigene exportieren.
---
## Browser-Unterstützung
**Voraussetzungen**: ein aktueller Desktop-Browser (Evergreen-Version) mit aktiviertem JavaScript — sonst nichts. Kein Server, kein Netzwerkzugriff und keine Installation erforderlich; die App läuft per Doppelklick auf eine einfache `file://`-Datei. Nur **Per URL laden** (`?file=…`) erfordert, dass das Tool über HTTP(S) bereitgestellt wird.
Entwicklung und Tests erfolgen primär mit **Microsoft Edge (Chromium)**; aktuelle Desktop-Browser auf Chromium-Basis (Chrome, Edge, Opera, Brave…) sind die primär getestete Umgebung und sollten das vollständigste Erlebnis bieten. Bekannte Unterschiede zu anderen Engines:
- **Firefox / Safari** — die File System Access API (`showSaveFilePicker`) ist nicht verfügbar: *Speichern* fällt auf einen Standard-**Download** der `.rae.json`-Datei zurück (und *Laden* auf einen klassischen Dateiauswahldialog), anstatt direkt in die geöffnete Datei zu schreiben. Die Hauptfunktionen bleiben in Firefox und Safari verfügbar, es kann jedoch Unterschiede geben, insbesondere bei der Zwischenablage, der Dateiverarbeitung, dem Drucken und der Darstellung generierter Dokumente.
- **Ältere Firefox-Versionen (< 127)** — das Kopieren einer Matrix in die Zwischenablage **als Bild** (`ClipboardItem`) wird nicht unterstützt; die Download-Schaltflächen für PNG und SVG bleiben verfügbar.
- **Touch-Geräte** — Drag-and-Drop-Interaktionen (Chips, Kanban, Spaltenüberschriften) sind auf die Verwendung mit der Maus ausgelegt; es gibt Alternativen über Tastatur und Menüs (Strg+Pfeiltasten im Kanban und in den Matrizen, ▲/▼-Pfeile im Spaltenmenü), das Tool ist jedoch für die Verwendung am Desktop konzipiert.
---
## Fremdcode von Drittanbietern
RAE bindet genau **eine Bibliothek von Drittanbietern** ein: [**fflate** v0.8.2](https://github.com/101arrowz/fflate) (MIT-Lizenz, © Arjun Barrett), eine winzige, schnelle ZIP-/Deflate-Implementierung. Sie stellt den ZIP-Container bereit, der für die Word- (`.docx`) und Excel- (`.xlsx`) Exporte erforderlich ist — OOXML-Dateien sind ZIP-Archive aus XML-Teilen. Die Bibliothek ist **inline eingebettet** in die HTML-Datei, zusammen mit ihrem Lizenzhinweis, sodass die App vollständig offline funktioniert und zur Laufzeit keine externe Ressource benötigt. Alles andere (Markdown-Engine, SVG-/PNG-Export, OOXML-Generierung, UI-Komponenten) wurde für dieses Projekt von Grund auf neu geschrieben.
---
## Entwicklung
Dieses Projekt wurde mit **[Claude Code](https://claude.com/claude-code)** (Anthropic) unter Verwendung des Modells **Claude Opus 4.8** und unter der Leitung seines Autors entwickelt.
---
## Fehler melden & Ideen
Einen Fehler gefunden oder einen Vorschlag? [Öffne ein GitHub-Issue](https://github.com/StephaneV/Risk-Analysis-Editor/issues). Bei Fehlern gib bitte deinen Browser und dein Betriebssystem, die App-Version (angezeigt unter *Über*), deine Erwartung, was tatsächlich passiert ist, und — wenn möglich — eine minimale `.rae.json` an, die den Fehler reproduziert (zippe sie oder füge sie in einen Codeblock ein, da GitHub `.json`-Anhänge nicht direkt akzeptiert).
---
## Lizenz
Verbreitet unter der **MIT**-Lizenz — siehe [`LICENSE`](https://github.com/stephanev/risk-analysis-editor/blob/main/LICENSE).
© 2026 Stéphane Vinter