Der Weg einer Anfrage durch die Schichten

Wann: POST /read/{id} oder GET /read/{id}

sequenceDiagram
    participant C as Client
    participant F as Filterkette (CIAS)
    participant R as REST-Layer
    participant S as System-Layer
    participant P as Persistenz
    participant DB as Datenbank
    participant H as Hooks
    C->>F: POST /read/{id} + Token
    F->>F: Token prüfen, RequestContext füllen
    F->>R: weiterreichen
    R->>R: response auflösen (Felder, Referenzen)
    R->>S: readObject(id, Feldauswahl)
    S->>S: Leserolle prüfen
    S->>S: Sicherheitsfilter anhängen (Besitzer, Attribute)
    S->>P: Abfrage
    P->>DB: SELECT nur der angeforderten Spalten
    DB-->>P: Zeile
    P-->>S: Entity
    S->>H: After-Hook (READ), z. B. ein Feld entschlüsseln
    S->>S: Entity in DTO umwandeln
    S->>S: Referenzen einzeln nachladen, je mit eigener Rechteprüfung und eigenem READ-Hook
    S-->>R: DTO
    R-->>C: data + meta

Ergebnis: Kein Treffer, oder Treffer nicht sichtbar: 404. Der READ-Hook sieht jedes geladene Objekt, bevor es zur Antwort wird.

Wann: POST /create

sequenceDiagram
    participant C as Client
    participant F as Filterkette (CIAS)
    participant R as REST-Layer
    participant S as System-Layer
    participant H as Hooks
    participant P as Persistenz
    C->>F: POST /create + Token
    F->>R: RequestContext gefüllt
    R->>R: Dateien übernehmen, response auflösen
    R->>S: createObject(DTO)
    S->>S: Rolle prüfen, Felder übertragen,<br/>Defaults setzen, Verstöße sammeln,<br/>Kinder rekursiv anlegen
    S->>H: Before-Hooks
    S->>S: alle Verstöße auf einmal melden (422)
    S->>P: speichern
    S->>H: After-Hooks
    S->>P: flush, dann zurücklesen (mit READ-Hook)
    S-->>R: DTO
    R-->>C: data + meta

Ergebnis: Die Hooks laufen vor der Validierung. Ein Hook darf also ein Pflichtfeld füllen, das der Client gar nicht kennt.

Wann: PUT, PATCH, DELETE, Rollback

Ergebnis: Man kann nur ändern oder löschen, was man auch lesen kann.

Wann: POST /query

Ergebnis: Keine Treffer sind kein Fehler: 200 mit leerer Liste.