Konzept weiterentwickelt und gameplay hinzugefügt

doc/docs/planung.md

@@ -29,25 +29,52 @@ lasertag/
 
 ## Roadmap
 
-### Phase 1: Foundation (Struktur & Shell)
-- [ ] Verzeichnisstruktur und `CMakeLists.txt` Verknüpfungen erstellen.
-- [ ] Basis-Firmware mit **Zephyr Shell** zur Konfiguration.
-- [ ] Implementierung von NVS (Non-Volatile Storage) zum Speichern von Gerätenamen und Team-IDs.
+### Entwicklungs-Roadmap (Schritt-für-Schritt)
 
-### Phase 2: Connectivity (BLE & Thread)
-- [ ] **BLE-Provisioning:** Übertragung von Thread-Credentials via Bluetooth.
-- [ ] **Thread-Setup:** Aufbau eines stabilen Mesh-Netzwerks zwischen Leader und Westen.
-- [ ] **Web-Interface:** Verbindung der Chrome Web Bluetooth App mit dem Leader.
+Diese Roadmap führt vom nRF52840DK bis zum fertigen Produkt.
 
-### Phase 3: Core Game Logic (CoAP Brücke)
-- [ ] **Multicast-Broadcast:** "Spiel Start"-Kommando von Web-App -> Leader -> Thread-Mesh.
-- [ ] **Unicast-Feedback:** Treffermeldung von Weste -> Leader -> Web-App.
-- [ ] **Reliability:** Implementierung von CoAP Confirmable Messages für kritische Befehle (z. B. Waffe deaktivieren).
+#### Phase 1: Die "Tisch"-Basis (PoC)
+**Ziel:** Stabile Thread-Kommunikation und IR-Signalerzeugung verifizieren.
 
-### Phase 4: Erweitert (Bases & NFC)
-- [ ] **Rollen-Switch:** Leader-Hardware erkennt via GPIO (Schalter), ob sie als Base agiert.
-- [ ] **Capture the Base:** Logik für Teambesitz und Zeitmessung.
-- [ ] **NFC-Provisioning:** (Optional) Schnelles Zuweisen von IDs via Smartphone-NFC.
+- [ ] Zephyr Setup: Installation des nRF Connect SDK (NCS) und VS Code.
+- [ ] Custom Board Definition: Board-File anlegen, das die Pins des nRF52840DK auf die geplanten Funktionen mappt (PWM für IR, GPIO für Buttons).
+- [ ] Thread Mesh: Minimalen OpenThread-Stack aufsetzen. Ein DK als Leader (FTD), einer als Child. UDP/CoAP-Ping bei Knopfdruck.
+- [ ] IR-Engine: MilesTag-Encoder mit nrfx_pwm + PPI implementieren. Signal mit Oszilloskop/Logic Analyzer verifizieren. Sicherstellen, dass Funk die IR-Engine nicht stört.
+
+#### Phase 2: Der "Prototyp" (Integration)
+**Ziel:** Einbindung von Audio und Solenoid.
+
+- [ ] Audio: MAX98357A am I2S-Interface. WAV-Player, der Samples aus internem Flash abspielt.
+- [ ] Solenoid-Treiber: MOSFET-Schaltung auf Breadboard. PWM-Logik für "Kick" (100% für 30ms) und "Hold" (30%). Thermik des Solenoids testen.
+- [ ] Haptik-Sync: Audio ("Bang!") und Solenoid-Kick in der Software synchronisieren.
+
+#### Phase 3: Die "Optik & Sensorik" (Physik)
+**Ziel:** Reichweitentest.
+
+- [ ] Linsen-Test: Oslon Black LED auf Star-Platine + Carclo/LEDiL-Linse justieren (Abstand exakt einhalten).
+- [ ] Sensor-Array: TSOP-Sensoren für die Weste verdrahten. Outdoor-Test bei Sonne. Software-Filterung anpassen, um Reflexions-Fehler zu minimieren.
+
+#### Phase 4: Die "App & Logik" (System)
+**Ziel:** Spielsteuerung.
+
+- [ ] BLE Gateway: Leader-Box sendet Thread-Statusdaten via BLE an Smartphone (Web Bluetooth API oder nRF Toolbox App).
+- [ ] Web App: Einfache HTML/JS-Seite, die via Web Bluetooth API mit dem Leader spricht, um ein Spiel zu starten ("Start Game" als Thread Broadcast).
+
+#### Phase 5: Das "Custom PCB" (Hardware)
+**Ziel:** Miniaturisierung.
+
+- [ ] Schaltplan: Schaltungen in KiCad übertragen. Trennung von Analog-GND (Sensoren) und Power-GND (Solenoid) beachten.
+- [ ] Layout: Antennenplatzierung/Impedanz anpassen; Testpunkte für SWD vorsehen (Debug).
+
+### Grobe Zeitachsen (Richtwerte)
+
+| Phase | Ziel | Dauer (Richtwert) | Abhängigkeiten |
+| :--- | :--- | :--- | :--- |
+| 1 | Thread + IR PoC | 1–2 Wochen | HW: nRF52840DK, Logic-Analyzer |
+| 2 | Audio + Solenoid | 2 Wochen | Phase 1 abgeschlossen |
+| 3 | Optik & Sensorik | 1–2 Wochen | Phase 2 abgeschlossen, Outdoor-Tests |
+| 4 | App & Steuerung | 1–2 Wochen | Phase 2 abgeschlossen, BLE-Gateway vorhanden |
+| 5 | Custom PCB | 3–4 Wochen | Phasen 1–3 verifiziert, Schaltplan stabil |
 
 ## Technologie-Stack
 - **Hardware:** nRF52840 (DK & Custom PCBs)