Prüfprotokoll

RAMP führt ein umfassendes Prüfprotokoll über alle Entitäten — Instanzen, Vorlagen, Schritte und API-Zugriff. Jede Zustandsänderung, Benutzeraktion und Genehmigung wird mit der Identität des Benutzers, der sie durchgeführt hat, dem genauen Zeitstempel und einer Beschreibung der Änderung aufgezeichnet. Diese Prüfdaten unterstützen Compliance-Anforderungen, Überprüfungen nach Vorfällen und operative Transparenz.

Was protokolliert wird

RAMP erfasst Prüfeinträge auf mehreren Ebenen. Die folgenden Abschnitte beschreiben, was für jeden Entitätstyp verfolgt wird.

Instanz-Prüfprotokoll

Jede Aktion an einer Instanz wird in der Tabelle InstanceAuditEntry aufgezeichnet:

Aktion	Beschreibung
Erstellt	Instanz wurde aus einer Vorlagenversion erstellt
StatusGeändert	Instanz hat zwischen Statuszuständen gewechselt (Entwurf, Geplant, Wird ausgeführt, Angehalten, Abgeschlossen, Storniert)
VariableAktualisiert	Instanzvariablenwert wurde geändert
TeamMitgliedHinzugefügt	Ein Benutzer oder eine Gruppe wurde dem Instanzteam hinzugefügt
TeamMitgliedEntfernt	Ein Benutzer oder eine Gruppe wurde aus dem Instanzteam entfernt
RolleGeändert	Die Rolle eines Teammitglieds wurde geändert (z. B. Ausführender zu Stellvertretendem Leiter)
EinstellungÜberschrieben	Eine Schritteinstellung wurde auf Instanzebene überschrieben (überspringbar, automatisch abschließen, geplante Dauer)
NotizAktualisiert	Instanznotiz wurde erstellt oder geändert
KommentarHinzugefügt	Instanzkommentar wurde hinzugefügt
Archiviert	Instanz wurde archiviert

Schritt-Prüfprotokoll

Aktionen auf Schrittebene innerhalb von Instanzen werden ebenfalls in der Tabelle InstanceAuditEntry mit einer StepId-Referenz aufgezeichnet:

Aktion	Beschreibung
SchrittGestartet	Schritt wurde gestartet
SchrittAbgeschlossen	Schritt wurde abgeschlossen (enthält Abschlussergebnis: Erfolgreich, OK mit Komplikationen usw.)
SchrittAngehalten	Schritt wurde angehalten
SchrittFortgesetzt	Schritt wurde fortgesetzt
SchrittÜbersprungen	Schritt wurde übersprungen (enthält Begründung)
SchrittAbgebrochen	Schritt wurde abgebrochen (enthält Begründung)
SchrittStorniert	Schritt wurde storniert (enthält Begründung)
Zwangsabschluss	Schritt wurde von Instanzleiter/Stellvertr. zwangsabgeschlossen (enthält Begründung)
Zwangsüberspringen	Schritt wurde zwangsübersprungen (enthält Begründung)
Zwangsabbruch	Schritt wurde zwangsabgebrochen (enthält Begründung)
AnhangHochgeladen	Datei wurde an den Schritt angehängt
AnhangGelöscht	Dateianhang wurde vom Schritt entfernt
GenehmigungAngefordert	Schrittabschluss mit “OK mit Fehlern” hat eine Genehmigungsanfrage ausgelöst
GenehmigungErteilt	Instanzleiter hat ein Schrittergebnis genehmigt

Vorlagen-Prüfprotokoll

Aktionen auf Vorlagenebene werden in der Tabelle TemplateAuditEntry aufgezeichnet:

Aktion	Beschreibung
Erstellt	Vorlage wurde erstellt
VersionErstellt	Neue Vorlagenversion wurde erstellt
StatusGeändert	Vorlagenversionsstatus geändert (Entwurf, Veröffentlicht, Veraltet)
RolleHinzugefügt	Vorlagenrollenzuweisung wurde hinzugefügt (Eigentümer, Bearbeiter, Betrachter, Genehmiger)
RolleEntfernt	Vorlagenrollenzuweisung wurde entfernt
Veraltet	Vorlage wurde als veraltet markiert
NichtMehrVeraltet	Vorlage wurde aus dem veralteten Status wiederhergestellt

Schrittentwurf-Prüfprotokoll

Änderungen an Vorlagenschritten während des Entwurfs werden in der Tabelle StepAuditEntry verfolgt:

Änderungstyp	Beschreibung
Erstellt	Schritt wurde zur Vorlagenversion hinzugefügt
Geändert	Schrittinhalt, Titel, Einstellungen oder Reihenfolge wurden geändert
Gelöscht	Schritt wurde entfernt (Soft-Delete)
Umsortiert	Schrittposition wurde innerhalb der Hierarchie geändert
Eingefügt	Schritt wurde aus einer anderen Vorlagenversion eingefügt

Schrittentwurf-Prüfeinträge enthalten Inhalts-Snapshots — die alten und neuen Werte für Titel, Inhalt, Reihenfolge und übergeordneter Schritt — sodass die vollständige Geschichte eines Schritts rekonstruiert werden kann.

API-Prüfprotokoll

Alle API-Anfragen werden in der Tabelle ApiAuditEntry für Sicherheit und Compliance protokolliert:

Feld	Beschreibung
Anfragepfad	Der aufgerufene API-Endpunkt
HTTP-Methode	GET, POST, PUT, DELETE usw.
Statuscode	HTTP-Antwortcode (200, 401, 403, 500 usw.)
Authentifizierungsmethode	JWT, Persönliches Zugriffstoken (PAT), Dienstkonto oder Anonym
Benutzeridentität	Welcher Benutzer oder welches Dienstkonto die Anfrage gestellt hat
Autorisierungsergebnis	Ob die Anfrage autorisiert oder abgelehnt wurde (403)
Dauer	Anfrageverarbeitungszeit in Millisekunden
IP-Adresse	Ursprungs-IP der Anfrage
Fehlermeldung	Bei fehlgeschlagenen Anfragen die Fehlerdetails

Struktur der Prüfeinträge

Jeder Prüfeintrag folgt einer konsistenten Struktur, unabhängig vom Entitätstyp.

Instanz- und Schritt-Prüfeinträge

Feld	Beschreibung
Id	Eindeutige Kennung für den Prüfeintrag
Zeitstempel	Genaues Datum und Uhrzeit der Aktion (UTC)
Benutzer	Der Benutzer, der die Aktion durchgeführt hat
Aktion	Der Aktionstyp (z. B. StatusGeändert, SchrittAbgeschlossen)
Alter Wert	JSON-Darstellung des vorherigen Zustands
Neuer Wert	JSON-Darstellung des neuen Zustands
Details	Von Menschen lesbare Beschreibung des Geschehens
Schritt-ID	Bei Aktionen auf Schrittebene: gibt an, welcher Schritt betroffen war

Ausführungsprotokoll-Einträge

Das Ausführungsprotokoll (das in der Ausführungsansicht verwendet wird) hat eine etwas andere Struktur, die sich auf die Echtzeit-Kommunikation konzentriert:

Feld	Beschreibung
Zeitstempel	Wann der Eintrag erstellt wurde
Benutzer	Wer die Aktion ausgeführt oder den Kommentar gepostet hat
Aktion	Aktionstypcode (z. B. STEP_STARTED, COMMENT_ADDED, INSTANCE_PAUSED)
Nachricht	Rich-Text-HTML-Inhalt (für Kommentare) oder systemgenerierte Beschreibung
IsForceAction	Boolesches Flag, das Zwangsaktionen zur visuellen Unterscheidung markiert
Schritt-ID	Optionaler Verweis auf den beteiligten Schritt

Prüfverlauf anzeigen

Instanz-Verlaufsregisterkarte

Navigieren Sie zur Instanzdetailseite
Klicken Sie auf die Registerkarte Verlauf
Durchsuchen Sie die chronologische Liste aller Änderungen
Jeder Eintrag zeigt Zeitstempel, Benutzer, Aktionstyp und Beschreibung
Erweitern Sie einen Eintrag, um die alten und neuen Werte zu sehen (JSON-Diff)

Prüfeinträge filtern

Prüfansichten unterstützen Filterung, um bestimmte Einträge zu finden.

Verfügbare Filter

Filter	Beschreibung
Nach Benutzer	Nur Aktionen eines bestimmten Benutzers anzeigen
Nach Aktionstyp	Nach Aktionskategorie filtern (z. B. Statusänderungen, Rollenänderungen, Kommentare)
Nach Datumsbereich	Start- und Enddatum angeben, um Ergebnisse einzugrenzen
Nur Zwangsaktionen	Nur Zwangsaktionseinträge anzeigen (Ausführungsprotokoll)
Nach Schritt	Nur Aktionen zu einem bestimmten Schritt anzeigen

Filter im Ausführungsprotokoll verwenden

Öffnen Sie die Ausführungsansicht für eine Instanz
Navigieren Sie zur Registerkarte Ausführungsprotokoll im Notizenpanel
Klicken Sie auf die Schaltfläche Filter, um Filteroptionen anzuzeigen
Wählen Sie ein oder mehrere Filterkriterien aus
Das Protokoll wird aktualisiert und zeigt nur übereinstimmende Einträge an
Klicken Sie auf Filter löschen, um zum vollständigen Protokoll zurückzukehren

Prüfung von Zwangsaktionen

Zwangsaktionen erhalten aufgrund ihrer außergewöhnlichen Natur eine besondere Behandlung im Prüfprotokoll.

Identifizierung

Ausführungsprotokoll-Einträge für Zwangsaktionen haben das IsForceAction-Flag auf true gesetzt
In der Benutzeroberfläche werden Zwangsaktionseinträge mit einem roten Hintergrund angezeigt
Der Filter “Nur Zwangsaktionen” im Ausführungsprotokoll isoliert diese Einträge

Aufgezeichnete Informationen

Jeder Zwangsaktions-Prüfeintrag enthält:

Den spezifischen Zwangsaktionstyp (Zwangsabschluss, Zwangsüberspringen, Zwangsabbruch)
Die vom Instanzleiter oder stellvertretenden Leiter angegebene obligatorische Begründung
Die Zustimmungsbestätigung
Bei Kaskadenoperationen: welche untergeordneten Schritte betroffen waren und ihre vorherigen Zustände

Echtzeit-Prüfaktualisierungen

Prüfeinträge werden synchron mit den Aktionen, die sie verfolgen, erstellt — es gibt keine Verzögerung zwischen einer Aktion und ihrem Prüfeintrag. Beim Anzeigen des Prüfverlaufs in der Benutzeroberfläche:

Neue Einträge erscheinen in Echtzeit über SignalR
Das Ausführungsprotokoll wird sofort aktualisiert, wenn ein Benutzer eine Aktion ausführt
Historische Ansichten (Verlaufsregisterkarte) erfordern möglicherweise eine Seitenaktualisierung, um die neuesten Einträge anzuzeigen

Datenspeicherung

Prüfdaten werden dauerhaft in der Datenbank neben den Entitäten gespeichert, die sie verfolgen. Es erfolgt keine automatische Bereinigung von Prüfeinträgen. Dies stellt sicher, dass die vollständige Geschichte jeder Instanz oder Vorlage stets zur Überprüfung verfügbar ist.

Bewährte Praktiken

Regelmäßige Überprüfung

Überprüfen Sie Zwangsaktionen vierteljährlich oder wie von Ihrem Compliance-Framework gefordert
Prüfen Sie API-Prüfeinträge auf unbefugte Zugriffsversuche (403-Antworten)
Überwachen Sie auf ungewöhnliche Muster (z. B. übermäßige Zwangsaktionen eines einzelnen Benutzers)

Prüfdaten zur Prozessverbesserung nutzen

Identifizieren Sie Schritte, die häufig zwangsübersprungen oder zwangsabgebrochen werden — diese können Vorlagenaktualisierungen benötigen
Analysieren Sie Schrittabschlusszeiten (aus Prüfzeitstempeln), um geplante Dauern zu verfeinern
Überprüfen Sie Kommentare und Notizen auf Schrittebene auf wiederkehrende Probleme, die in der Vorlage behoben werden könnten

Compliance-Dokumentation

Exportieren Sie Prüfdaten vor dem Archivieren von Instanzen (siehe Datenexporte)
Führen Sie eine Aufzeichnung von Zwangsaktionsüberprüfungen und ihren Ergebnissen
Dokumentieren Sie alle Prüfbefunde und ergriffene Abhilfemaßnahmen