# Anforderungsdokument: Review-Pivot-Anwendung

## 1. Ziel und Kontext

Es soll eine webbasierte Anwendung entstehen, mit der Prüfer Treffer („Matches“) aus einer automatisierten Suche nach schützenswerten Inhalten (z. B. personenbezogenen Daten in Dateien) sichten und bewerten. Das System hat zu jedem Treffer bereits eine Aktion vorgeschlagen. Die Anwendung soll es ermöglichen:

- die Treffer **verdichtet nach Suchbegriff** zu überblicken,
- pro Suchbegriff **mit wenigen Klicks eine Entscheidung** für alle zugehörigen Treffer zu treffen,
- in Ausnahmefällen **einzelne Treffer abweichend** zu bewerten.

Die Entscheidungen der Prüfer werden gespeichert und von nachgelagerten Prozessen weiterverwendet. Diese Prozesse gehören nicht zum Umfang dieser Anwendung.

### Nutzer
Fachliche Prüfer, die Treffer eines Falls (Case) für einen Mandanten (Tenant) bewerten. Rollen und Rechte sind nicht Teil der Ursprungsanforderung (siehe Abschnitt 9).

### Abgrenzung
- Die Anwendung **erzeugt keine Treffer** und **führt die gewählten Aktionen nicht aus**. Sie erfasst nur die Entscheidung.
- Es werden keine Dateien angezeigt, verändert oder gelöscht.

---

## 2. Fachliche Begriffe

| Begriff | Bedeutung |
| :--- | :--- |
| **Datenquelle** | Kombination aus Mandant (`tenant`) und Fall (`Caseid`). |
| **Treffer / Review-Datensatz** | Ein einzelner Fund in einer Datei. |
| **Suchbegriff** (`search_term`) | Das Muster oder der Begriff, der den Treffer ausgelöst hat. |
| **PP Action** (`pp_action`) | Vom System vorgeschlagene Aktion. Sie ist für den Prüfer **nur lesbar**. |
| **User Defined Action** (`user_defined_action`) | Die vom Prüfer festgelegte Aktion. Das ist das einzige Feld, das die Anwendung ändert. |
| **Pivot-Zeile** | Gruppe von Treffern mit gleichem Suchbegriff, gleicher PP Action und gleicher User Defined Action, samt Anzahl. |

### Aktionen

| Code | Bezeichnung | Bedeutung |
| :--- | :--- | :--- |
| `A` | Anonymisieren | Der Treffer soll anonymisiert werden. |
| `I` | Match ignorieren | Der Treffer wird als unkritisch eingestuft. |
| `D` | Datei löschen | Die Datei soll gelöscht werden. |
| `N` | Keine Aktion | Es wird bewusst nichts unternommen. |
| `-` | Keine Entscheidung | Ausgangszustand bzw. zurückgesetzt. Ein leerer Wert zählt als `-`. |

---

## 3. Datenmodell (fachlich)

Die Anwendung arbeitet auf einem vorhandenen Bestand an Review-Datensätzen. Er wird von der Anwendung nicht angelegt.

| Feld | Pflicht | Beschreibung | Anwendung darf ändern |
| :--- | :--- | :--- | :--- |
| `_id` | ja | Eindeutiger Schlüssel eines Treffers | nein |
| `tenant` | ja | Mandant | nein |
| `Caseid` | ja | Fall-ID | nein |
| `search_term` | ja | Suchbegriff | nein |
| `pp_action` | ja | Vorgeschlagene Aktion | nein |
| `user_defined_action` | nein | Entscheidung des Prüfers (`A`, `I`, `D`, `N`, `-` oder leer) | **ja** |
| `match_csvt` | nein | Text des Treffers | nein |
| `full_path` | nein | Pfad der Datei, in der der Treffer liegt | nein |

Hinweis: Der Bestand kann **sehr groß** sein (Zehntausende Treffer pro Fall und mehr).

---

## 4. Funktionale Anforderungen

### 4.1 Datenquelle wählen

| ID | Anforderung |
| :--- | :--- |
| F-01 | Der Nutzer kann aus einer Liste eine Datenquelle (Mandant/Fall) wählen und aktivieren. |
| F-02 | Die Liste enthält jede vorhandene Kombination aus Mandant und Fall genau einmal. Kombinationen mit leerem Mandanten oder leerem Fall erscheinen nicht. Die Sortierung ist alphabetisch, erst nach Mandant, dann nach Fall. Die Anzeige hat das Format `Mandant/Fall`. |
| F-03 | Die aktive Auswahl bleibt über mehrere Seitenaufrufe und nach dem Speichern erhalten. |
| F-04 | Die aktive Auswahl wird deutlich angezeigt. Ist keine aktiv, erscheint ein auffälliger Hinweis. |
| F-05 | Der Nutzer kann die Auswahl zurücksetzen. Davor erscheint eine Sicherheitsabfrage. Das Zurücksetzen entfernt auch gesetzte Filter und zeigt eine Bestätigungsmeldung. |
| F-06 | Alle Auswertungen und Änderungen beziehen sich ausschließlich auf die aktive Datenquelle. |

Offen (siehe Abschnitt 9): Verhalten, wenn keine Datenquelle aktiv ist.

### 4.2 Kennzahlen

| ID | Anforderung |
| :--- | :--- |
| F-10 | Es werden vier Kennzahlen für die aktive Datenquelle angezeigt: Gesamtzahl der Treffer, Anzahl verschiedener Suchbegriffe, Anzahl verschiedener PP Actions, Anzahl verschiedener User Actions. |
| F-11 | Leere Werte zählen bei den „verschiedenen“ Kennzahlen nicht mit. |
| F-12 | Die Kennzahlen sind **unabhängig von den Filtern** und zeigen immer die gesamte Datenquelle. |
| F-13 | Große Zahlen werden mit deutschem Tausendertrennzeichen dargestellt (z. B. `12.345`). |

### 4.3 Pivot-Tabelle

| ID | Anforderung |
| :--- | :--- |
| F-20 | Die Treffer werden nach der Kombination Suchbegriff, PP Action und User Defined Action gruppiert. Pro Gruppe wird die Anzahl der Treffer angezeigt. |
| F-21 | Die Tabelle hat die Spalten: Suchbegriff, PP Action, User Defined Action, Anzahl, Aktion. |
| F-22 | Die Sortierung ist absteigend nach Anzahl. |
| F-23 | Eine leere User Defined Action wird in der Tabelle als `-` angezeigt. |
| F-24 | Eine Summenzeile zeigt die Gesamtzahl der aktuell **sichtbaren** (gefilterten) Zeilen. |
| F-25 | Ohne passende Zeilen erscheint der Hinweis „Keine Daten gefunden“. |
| F-26 | Jede Zeile bietet zwei Einstiege: Klick auf den Suchbegriff öffnet die Einzelbearbeitung (4.5), der Button „Bearbeiten“ die Sammelbearbeitung (4.4). |

### 4.4 Sammelbearbeitung je Suchbegriff

| ID | Anforderung |
| :--- | :--- |
| F-30 | Ein Dialog zeigt Suchbegriff, PP Action, aktuelle User Action und Anzahl der Pivot-Zeile, aus der er geöffnet wurde. |
| F-31 | Der Nutzer wählt genau eine Aktion aus: Anonymisieren, Match ignorieren, Datei löschen, Keine Aktion oder Zurücksetzen. Die aktuelle Aktion der Zeile ist vorausgewählt, sofern sie einem dieser Werte entspricht. |
| F-32 | Beim Speichern erhalten **alle Treffer der aktiven Datenquelle mit diesem Suchbegriff** die gewählte Aktion. Das gilt unabhängig von PP Action und bisheriger User Action, nicht nur für die angeklickte Pivot-Zeile. |
| F-33 | Ohne gewählte Aktion oder ohne Treffer wird nicht gespeichert, und der Nutzer erhält eine verständliche Meldung. |
| F-34 | Während des Speicherns sind Mehrfachklicks verhindert. Ein Fortschrittsbalken zeigt den Stand (Prozent sowie „x von y“). |
| F-35 | Nach erfolgreichem Speichern wird die Ansicht aktualisiert und zeigt die neuen Werte. |
| F-36 | Bei einem Fehler bleibt der Nutzer im Dialog, erhält die Fehlermeldung und kann erneut speichern. |

### 4.5 Einzelbearbeitung

| ID | Anforderung |
| :--- | :--- |
| F-40 | Ein Dialog listet **alle** Treffer der aktiven Datenquelle zum gewählten Suchbegriff. Angezeigt werden die Anzahl sowie je Treffer: Treffertext (auf 80 Zeichen gekürzt), PP Action, auswählbare Aktion und Dateipfad. |
| F-41 | Pro Treffer kann die Aktion einzeln auf `-`, `A`, `I`, `D` oder `N` gesetzt werden. Vorbelegt ist der aktuelle Wert. |
| F-42 | Ein gemeinsamer Button speichert die Aktionen aller aufgelisteten Treffer. |
| F-43 | Fortschritt, Sperre gegen Mehrfachklicks, Aktualisierung nach Erfolg und Fehlerbehandlung verhalten sich wie in F-34 bis F-36. |
| F-44 | Inhalte aus den Daten (Treffertext, Pfad, Aktionen) werden **als reiner Text** dargestellt und nie als ausführbarer Inhalt interpretiert. |

### 4.6 Filter

| ID | Anforderung |
| :--- | :--- |
| F-50 | Die Pivot-Tabelle lässt sich nach Suchbegriff, PP Action und User Defined Action filtern. Die Filter sind einzeln und kombiniert nutzbar (UND-Verknüpfung). |
| F-51 | Die Auswahlwerte jedes Filters entsprechen den in der aktiven Datenquelle vorkommenden Werten, sortiert. Die Option „Alle anzeigen“ hebt den Filter auf. |
| F-52 | Ein Filter wirkt sofort nach Auswahl, ohne zusätzliche Bestätigung. |
| F-53 | Sind Filter aktiv, gibt es eine Möglichkeit, sie zurückzusetzen. |
| F-54 | Filter ändern nur die Pivot-Tabelle und deren Summe (siehe F-12). |
| F-55 | Die Sammelbearbeitung und die Einzelbearbeitung beziehen sich auf alle Treffer des Suchbegriffs, **unabhängig von den gesetzten Filtern**. |

### 4.7 Meldungen und Rückmeldung

| ID | Anforderung |
| :--- | :--- |
| F-60 | Erfolgs- und Fehlermeldungen werden gut sichtbar angezeigt und verschwinden nach dem nächsten Seitenaufruf. |
| F-61 | Ist die Datenquelle nicht erreichbar oder liefert sie einen Fehler, erscheint an Stelle der Auswertung eine Fehlermeldung. |
| F-62 | Dialoge lassen sich schließen per Schließen-Symbol, Abbrechen/Schließen-Button, Klick neben den Dialog und ESC-Taste. |

---

## 5. Speicherverhalten

| ID | Anforderung |
| :--- | :--- |
| S-01 | Gespeichert wird ausschließlich das Feld `user_defined_action` der betroffenen Treffer. |
| S-02 | Ein leerer Wert wird als `-` gespeichert. |
| S-03 | Zulässig sind nur die Werte `A`, `I`, `D`, `N` und `-`. Andere Werte werden abgelehnt. |
| S-04 | Es dürfen nur Treffer der aktiven Datenquelle geändert werden. |
| S-05 | Große Änderungsmengen müssen effizient verarbeitet werden. Die Sammelbearbeitung teilt sie in Pakete von **100 Treffern** auf und zeigt zwischen den Paketen den Fortschritt an. |
| S-06 | Das Ergebnis eines Speichervorgangs meldet Erfolg oder Fehler und die Anzahl der bearbeiteten Treffer. |
| S-07 | Jeder Speichervorgang soll **atomar** sein: entweder vollständig übernommen oder gar nicht. Bei einer Sammelbearbeitung in mehreren Paketen kann ein Abbruch dazu führen, dass nur ein Teil gespeichert ist. Dann ist ein erneutes Speichern jederzeit gefahrlos möglich (siehe 9). |

---

## 6. Ablauf (Hauptszenario)

1. Der Nutzer öffnet die Anwendung. Es ist keine Datenquelle aktiv, und er sieht den Hinweis darauf.
2. Er wählt `Mandant/Fall` und aktiviert die Auswahl. Kennzahlen und Pivot-Tabelle erscheinen.
3. Er filtert z. B. nach einer PP Action und sieht die größten Gruppen zuerst.
4. Er klickt bei einem Suchbegriff auf „Bearbeiten“, wählt „Anonymisieren“ und speichert.
5. Ein Fortschrittsbalken läuft. Danach ist die Ansicht aktualisiert, und der Suchbegriff erscheint mit User Action `A`.
6. Für einen auffälligen Treffer öffnet er die Einzelbearbeitung über den Suchbegriff, setzt dort `I` und speichert.

---

## 7. Nicht-funktionale Anforderungen

| ID | Bereich | Anforderung |
| :--- | :--- | :--- |
| N-01 | Sprache | Oberfläche, Meldungen und Zahlenformat sind **deutsch**. |
| N-02 | Datenmenge | Die Anwendung muss mit mehreren Zehntausend Treffern pro Datenquelle bedienbar bleiben. Der Detaildialog zeigt dennoch **alle** Treffer des Suchbegriffs. Bei sehr großen Mengen ist eine schrittweise Darstellung zulässig, sofern „Speichern“ weiterhin alle Treffer umfasst. |
| N-03 | Antwortzeit | Laden, Filtern und Öffnen der Dialoge soll bei üblichen Datenmengen ohne spürbare Wartezeit erfolgen. Längere Vorgänge zeigen den Fortschritt. |
| N-04 | Laufzeit | Eine Anfrage darf bei großen Mengen bis zu etwa 2 Minuten dauern. |
| N-05 | Sicherheit | Eingaben werden nie unmittelbar in Datenbankabfragen oder Seiteninhalte übernommen (Schutz vor Injektion und Script-Einschleusung). |
| N-06 | Sicherheit | Zugangsdaten gehören nicht in den Quelltext, sondern in eine geschützte Konfiguration. |
| N-07 | Sicherheit | Technische Fehlerdetails werden im Normalbetrieb nicht an Endnutzer ausgegeben. |
| N-08 | Bedienbarkeit | Moderne Desktop-Browser. Die Oberfläche passt sich der Fensterbreite an (Maximalbreite ca. 1600 px). |
| N-09 | Robustheit | Fehler (Datenbank, Netzwerk, ungültige Antwort) führen nie zu einer leeren oder hängenden Seite, sondern zu einer verständlichen Meldung. |
| N-10 | Konfigurierbarkeit | Datenbankverbindung und Tabellenname sind konfigurierbar. |

---

## 8. Oberflächenübersicht

Eine einzelne Seite mit folgenden Bereichen von oben nach unten:

1. **Titelbereich** mit Name der Anwendung und Untertitel
2. **Meldungsbereich** (Erfolg grün, Fehler rot)
3. **Datenquelle:** Auswahlfeld, „Aktivieren“, „Auswahl zurücksetzen“ und Anzeige der aktiven Auswahl
4. **Kennzahlen:** vier Karten nebeneinander
5. **Filter:** drei Auswahlfelder, ggf. „Filter zurücksetzen“
6. **Pivot-Tabelle** mit Summenzeile
7. **Dialog Sammelbearbeitung** (Overlay)
8. **Dialog Einzelbearbeitung** (Overlay, breiter, mit scrollbarer Tabelle und fixer Kopfzeile)
9. **Fortschrittsanzeige** (Overlay über der gesamten Seite)

---

## 9. Offene Punkte und Entscheidungen

Diese Punkte sind im bestehenden Verhalten nicht oder nur unzureichend gelöst. Sie müssen vor der Umsetzung entschieden werden. Die Empfehlung ist jeweils angegeben.

| Nr. | Thema | Empfehlung |
| :--- | :--- | :--- |
| O-01 | **Keine Datenquelle aktiv:** Aktuell werden alle Treffer aller Mandanten geladen. | Ohne Auswahl keine Treffer laden, nur den Hinweis zeigen. Das vermeidet Mandantenvermischung und Ladezeit. |
| O-02 | **Authentifizierung und Rollen:** Es existiert keine Zugriffskontrolle. | Anmeldung einführen und festlegen, welche Nutzer welche Mandanten sehen und ändern dürfen. |
| O-03 | **Nachvollziehbarkeit:** Es wird nicht festgehalten, wer wann was geändert hat. | Änderungsprotokoll (Nutzer, Zeitpunkt, alter und neuer Wert) ergänzen. |
| O-04 | **Teilweise gespeicherte Sammelbearbeitung:** Bei Abbruch zwischen zwei Paketen ist nur ein Teil geändert. | Serverseitig in einem Vorgang speichern (mit Fortschrittsrückmeldung) oder dem Nutzer klar melden, wie viele Treffer geändert wurden. |
| O-05 | **Filter nach dem Speichern:** Sie gehen bisher verloren. | Filter und Datenquelle nach dem Speichern beibehalten. |
| O-06 | **Parallele Bearbeitung:** Zwei Prüfer können denselben Suchbegriff gleichzeitig bearbeiten, wobei die letzte Speicherung gewinnt. | Festlegen, ob das akzeptabel ist, oder Konflikterkennung ergänzen. |
| O-07 | **Anzeige „Zurücksetzen“ im Einzeldialog:** Es gibt `-` mit leerem Wert, im Sammeldialog heißt es „Zurücksetzen“. | Begriff und Wert einheitlich festlegen (`-`). |
| O-08 | **Spaltenüberschrift „Anzahl von match_csvt“:** Sie ist technisch benannt. | Fachlich als „Anzahl Treffer“ bezeichnen. |
| O-09 | **Sammelbearbeitung und PP Action:** Eine Aktion gilt für alle Treffer eines Suchbegriffs, auch für solche mit anderer PP Action als die angeklickte Zeile. | Bestätigen, ob das gewollt ist, oder die Sammelaktion auf die angeklickte Pivot-Zeile begrenzen. |

---

## 10. Abnahmekriterien (Auswahl)

1. Die Datenquellenliste enthält jede Kombination aus Mandant und Fall genau einmal, ohne Einträge mit leerem Wert, sortiert nach Mandant und Fall.
2. Nach Aktivierung zeigen die Kennzahlen die Werte der Datenquelle. Ein gesetzter Filter ändert sie nicht.
3. Die Pivot-Tabelle ist nach Anzahl absteigend sortiert. Die Summenzeile entspricht der Summe der sichtbaren Zeilen.
4. Die Sammelbearbeitung für einen Suchbegriff mit 250 Treffern setzt alle 250 Treffer auf die gewählte Aktion, zeigt den Fortschritt und aktualisiert danach die Ansicht.
5. Die Einzelbearbeitung ändert nur die in der Liste vorgenommenen Zuweisungen, und die Werte sind nach dem Neuladen sichtbar.
6. Ein Treffertext mit Sonderzeichen (z. B. `<b>x</b>`) wird im Dialog als Text und nicht formatiert dargestellt.
7. Ein Speichern mit ungültigem Aktionscode wird abgelehnt, und es ändert sich nichts.
8. Ein Datenbankfehler führt zu einer verständlichen Meldung statt zu einer leeren Seite.
9. Nach „Auswahl zurücksetzen“ ist keine Datenquelle mehr aktiv, und der Hinweis ist sichtbar.
