Phase 3

src/audio/sfx.rs

@@ -1,3 +1,9 @@
+//! Sound-Manager für atmosphärische Effekte (siehe PLAN.md, `audio::sfx`).
+//!
+//! Es gibt noch keine Audio-Assets im Projekt; sobald welche existieren,
+//! kann `play_sound` über `bevy_audio` (`AudioPlayer`/`AssetServer`) echte
+//! Dateien abspielen, gemappt über die Effekt-IDs unten.
+
 pub struct SfxEngine;
 
 impl SfxEngine {
@@ -5,8 +11,14 @@ impl SfxEngine {
         Self
     }
 
+    /// Effekt-IDs, die aktuell im Spiel ausgelöst werden:
+    /// - "shuffle": Karten werden gemischt (Spielstart).
+    /// - "chip": Einsatz/Call/Raise/Gewinn (Chip-Geräusch).
+    /// - "fold": Spieler foldet (Karten werden weggelegt).
+    /// - "flip": Community Cards werden aufgedeckt (Flop/Turn/River).
     pub fn play_sound(&self, effect_id: &str) {
-        // TODO(Phase 3): echte Wiedergabe via bevy_audio; bislang nur Log-Ausgabe.
+        // TODO(Phase 3 Rest): echte Wiedergabe via bevy_audio, sobald
+        // Audio-Assets vorhanden sind. Bislang nur Log-Ausgabe.
         println!("Playing SFX: {}", effect_id);
     }
 }