Prozess: read-file

Zweck

Liest eine einzelne Datei aus der Sandbox im UTF-8-Textformat.

Verantwortlichkeit

Einzige Aufgabe: Dateiinhalt liefern, ohne zu verändern.

Eingaben

• path: Dateipfad relativ zu FS_ROOT.

Ablauf

1. path-sandbox aufrufen.

2. Prüfen, dass Ziel existiert und reguläre Datei ist.

3. Dateiinhalt lesen.

4. Größe prüfen (MVP: max. 1 MiB).

5. Erfolgsobjekt mit content, encoding, size zurückgeben.

Vorbedingungen

• Ziel ist Datei (nicht Verzeichnis).
• Leserechte vorhanden.

Nachbedingungen

• Rückgabe ist unverändert gegenüber dem Dateistand.

Fehler

• NOT_FOUND: Datei existiert nicht.
• VALIDATION_ERROR: Pfad ist kein File.
• PAYLOAD_TOO_LARGE: Inhalt > 1 MiB.
• INVALID_ENCODING: Inhalt ist kein gültiger UTF-8-Text.
• IO_ERROR: Lesefehler.

Testfälle

• Bestehende Datei lesen => 200 + Inhalt.
• Nicht vorhandene Datei => 404.
• Ordner als target => NOT_FOUND.