refactor(core/audio): helper effectiveVolume compartit (DUP-02)

setSoundVolume i setMusicVolume repetien la mateixa lògica de clamp +
gate (enabled_ && channel_enabled_) + multiplicació pel master
config_.volume. S'extreu effectiveVolume(volume, channel_enabled) privat
i els dos setters es limiten a la crida Ja::*.

Any canvi futur a la política (p.ex. una corba logarítmica) queda en un
sol lloc.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

source/core/audio/audio.cpp

@@ -172,20 +172,22 @@ auto Audio::getRealMusicState() -> MusicState {
     }
 }
 
+// Aplica el gate master (enabled_) + el gate del canal (sound/music_enabled_)
+// i retorna el volum escalat pel master config_.volume. 0 si algun gate està
+// tancat. Així els dos setters comparteixen la mateixa política.
+auto Audio::effectiveVolume(float volume, bool channel_enabled) const -> float {
+    volume = std::clamp(volume, MIN_VOLUME, MAX_VOLUME);
+    return (enabled_ && channel_enabled) ? volume * config_.volume : 0.0F;
+}
+
 // Estableix el volum dels sons (float 0.0..1.0)
 void Audio::setSoundVolume(float sound_volume, Group group) const {
-    sound_volume = std::clamp(sound_volume, MIN_VOLUME, MAX_VOLUME);
-    const bool ACTIVE = enabled_ && sound_enabled_;
-    const float CONVERTED_VOLUME = ACTIVE ? sound_volume * config_.volume : 0.0F;
-    Ja::setSoundVolume(CONVERTED_VOLUME, static_cast<int>(group));
+    Ja::setSoundVolume(effectiveVolume(sound_volume, sound_enabled_), static_cast<int>(group));
 }
 
 // Estableix el volum de la música (float 0.0..1.0)
 void Audio::setMusicVolume(float music_volume) const {
-    music_volume = std::clamp(music_volume, MIN_VOLUME, MAX_VOLUME);
-    const bool ACTIVE = enabled_ && music_enabled_;
-    const float CONVERTED_VOLUME = ACTIVE ? music_volume * config_.volume : 0.0F;
-    Ja::setMusicVolume(CONVERTED_VOLUME);
+    Ja::setMusicVolume(effectiveVolume(music_volume, music_enabled_));
 }
 
 // Aplica una nova configuració (substitueix la cache i reaplica enables/volums)

source/core/audio/audio.hpp

@@ -124,9 +124,10 @@ class Audio {
     };
 
     // --- Métodos ---
-    explicit Audio(const Config& config);                                  // Constructor privat: rep la config
-    void initSDLAudio();                                                   // Inicializa SDL Audio
-    void playMusicInternal(Ja::Music* music, int loop, int crossfade_ms);  // Camí comú dels dos overloads de playMusic
+    explicit Audio(const Config& config);                                                   // Constructor privat: rep la config
+    void initSDLAudio();                                                                    // Inicializa SDL Audio
+    void playMusicInternal(Ja::Music* music, int loop, int crossfade_ms);                   // Camí comú dels dos overloads de playMusic
+    [[nodiscard]] auto effectiveVolume(float volume, bool channel_enabled) const -> float;  // Gate master+channel: 0 si algun està off, clamp 0..1 altrament
 
     // --- Variables miembro ---
     static std::unique_ptr<Audio> instance;  // Instància única d'Audio