fix: docs

Author: sidey79

docs/architecture/decisions/ADR-006-json-output-schema.adoc

@@ -19,17 +19,54 @@ Die Umbenennung des Nutzdatenfeldes von `payload` zu `data` sowie die Einführun
 
 === Details zur neuen Struktur (Präzisiert durch ADR-007)
 
-| Feld | Typ | Beschreibung |
-|---|---|---|
-| `data` | `str` | Die bereinigten Nutzdaten **ohne** Preamble und Postamble (ersetzt `payload`). |
-| `raw` | `str` | Die ursprüngliche, unveränderte Nachricht vom Signalduino (z.B. `MU;...`). |
-| `protocol` | `dict` | Strukturierte Metadaten des Protokolls. |
-| `protocol.id` | `str` | Die ID des Protokolls (Redundanz zur einfachen Konsumierbarkeit). |
-| `protocol.name` | `str` | Der menschenlesbare Name des Protokolls (aus `protocols.json`). |
-| `protocol.preamble` | `str` | Die Preamble des Protokolls (z.B. `W125#`). |
-| `protocol.format` | `str` | Das Format des Signals (z.B. `manchester`, `twostate`, `2-FSK`) (aus `protocols.json`). |
-| `protocol.clock` | `int`/`float` | Der Clock-Wert, der für die Demodulation verwendet wurde (entweder `clockabs` oder `clockrange` Mittelwert/demodulierter Takt). |
-| `protocol.modulation` | `str` | (Optional) Modulationsart (z.B. `2-FSK`, `GFSK`) für FSK-Protokolle. |
+[cols="1,1,4"]
+|===
+| Feld | Typ | Beschreibung
+
+| `data`
+| `str`
+| Die bereinigten Nutzdaten (meist Hex-String) **ohne** Preamble/Postamble. Repräsentiert die protokollspezifischen Daten (ersetzt `payload`).
+
+| `raw`
+| `str`
+| Die ursprüngliche, unveränderte Nachricht vom Signalduino (z.B. `MU;...`). Dient der vollständigen Nachvollziehbarkeit.
+
+| `protocol`
+| `object`
+| Container für strukturierte Metadaten der erfolgreichen Protokolldemodulation.
+
+| `protocol.id`
+| `str`
+| Die interne ID des Protokolls (z.B. `125`).
+
+| `protocol.name`
+| `str`
+| Der menschenlesbare Name des Protokolls (aus `protocols.json`).
+
+| `protocol.preamble`
+| `str`
+| Die Preamble (z.B. `W125#`) des erkannten Protokolls.
+
+| `protocol.encoding`
+| `str`
+| Das Codierungsformat des Signals (z.B. `manchester`, `twostate`, `pulse`).
+
+| `protocol.clock`
+| `float`
+| Der Takt-Wert in Mikrosekunden (`us`), der für die Demodulation verwendet wurde.
+
+| `protocol.modulation`
+| `str`
+| (Optional) Modulationsart (z.B. `2-FSK`, `GFSK`) für FSK-Protokolle.
+
+| `protocol.bitlength`
+| `int`
+| (Optional) Die tatsächliche Bitlänge der `data`-Nutzdaten, falls vom Protokoll bekannt/erzwungen. Unterstützt z.B. die Grothe-Constraint-Prüfung.
+
+| `protocol.repeats`
+| `int`
+| (Optional) Die Anzahl der erkannten Wiederholungen dieses Pakets, relevant für Duplikaterkennung.
+|===
 
 === Beispiel für die Datenstruktur (Präzisiert durch ADR-007)
 

docs/architecture/decisions/ADR-007-data-and-raw-fields.adoc

@@ -11,18 +11,18 @@
 
 Im Zuge der Definition des neuen JSON-Output-Schemas (siehe ADR-006) wurde Feedback gesammelt, das zwei wesentliche Verbesserungen vorschlägt:
 
-1.  **Ambiguität des Feldes `payload`:** Der Begriff `payload` wird in MQTT- und Messaging-Kontexten häufig für den gesamten Nachrichteninhalt verwendet. Die Verwendung von `payload` für die spezifischen, decodierten Hex-Daten kann daher zu Verwirrung führen.
-2.  **Bedarf an Rohdaten:** Für Debugging-Zwecke und fortgeschrittene Analysen ist es notwendig, Zugriff auf die ursprüngliche, unveränderte Nachricht zu haben, wie sie vom Signalduino-Gerät empfangen wurde (z.B. der komplette `MU;...`- oder `MC;...`-String), bevor irgendeine Verarbeitung oder Parsing stattgefunden hat.
+.  **Ambiguität des Feldes `payload`:** Der Begriff `payload` wird in MQTT- und Messaging-Kontexten häufig für den gesamten Nachrichteninhalt verwendet. Die Verwendung von `payload` für die spezifischen, decodierten Hex-Daten kann daher zu Verwirrung führen.
+.  **Bedarf an Rohdaten:** Für Debugging-Zwecke und fortgeschrittene Analysen ist es notwendig, Zugriff auf die ursprüngliche, unveränderte Nachricht zu haben, wie sie vom Signalduino-Gerät empfangen wurde (z.B. der komplette `MU;...`- oder `MC;...`-String), bevor irgendeine Verarbeitung oder Parsing stattgefunden hat.
 
 [#adr-decision]
 == Entscheidung
 
 Wir passen das in ADR-006 definierte Schema wie folgt an:
 
-1.  **Umbenennung `payload` zu `data`:**
+.  **Umbenennung `payload` zu `data`:**
     Das Feld, das bisher `payload` hieß und die bereinigten Hex- oder Binärdaten (ohne Preamble) enthielt, wird in **`data`** umbenannt.
 
-2.  **Einführung des Feldes `raw`:**
+.  **Einführung des Feldes `raw`:**
     Es wird ein neues Feld **`raw`** auf der obersten Ebene des JSON-Objekts eingeführt. Dieses Feld enthält den ursprünglichen Nachrichten-String, der an den Parser übergeben wurde.
 
 === Aktualisierte Datenstruktur