Grotti 2.0.0: eigenes Repo, Umbenennung von Farm.

docs/Dateien-Metadaten.md

@@ -0,0 +1,20 @@
+# Grotti-Dateien Metadaten
+
+`stored_path` liegt nur in der DB und in Rohzeilen (`get_file_row`, `list_file_rows`). Die API-Antwort (`file_out` / `GET /api/v1/dateien`) enthält den Pfad bewusst nicht.
+
+`POST /api/v1/dateien/neu-lesen` liest Watch-Ordner neu und ruft `refresh_file_meta` auf Rohzeilen auf — nicht auf `list_files`, sonst `KeyError: 'stored_path'`.
+
+## Was der Parser liest
+
+Kopfkommentare **und** Footer (letzte ~128 KB). Anycubic/Orca legen Gewicht, Zeit und Prozesswerte oft ans Dateiende.
+
+In der Bibliothek gespeichert:
+
+| Feld | Bedeutung |
+|------|-----------|
+| `filaments` | Typ/Farbe (`paint_info` oder `filament_type`/`filament_colour`) |
+| `weight_g` / `estimated_s` | Filamentgewicht und Druckzeit |
+| `printer_family` | aus `printer_model` |
+| `slice_meta` | jsonb: `layer_height`, `layers`, `max_z_mm`, `nozzle_mm`, `temp_nozzle`, `temp_bed`, `slicer` |
+
+Anzeige: Material, Zeit, Gewicht, Schichthöhe, Maschine, Projekt immer in der Zeile; Rest im Info-Popup bzw. unter der gewählten Datei. Nach Parser-Update: **Ordner neu lesen**.