refactor(data): reorganitza data/ i centralitza paths a defaults.hpp

source/game/entities/entity_loader.cpp

@@ -6,6 +6,7 @@
 #include "core/resources/resource_helper.hpp"
 #include "game/entities/entity.hpp"
 #include "game/entities/entity_factory.hpp"
+#include "utils/defaults.hpp"
 
 namespace EntityLoader {
 
@@ -20,7 +21,7 @@ namespace EntityLoader {
         }
 
         auto templatePath(const std::string& name) -> std::string {
-            return "data/entities/" + name + "/" + name + ".yaml";
+            return std::string{Defaults::Paths::ENTITIES_DIR} + name + "/" + name + ".yaml";
         }
 
     }  // namespace

source/game/entities/entity_manager_loadlevel.cpp

@@ -21,6 +21,7 @@
 #include "game/entities/entity_manager.hpp"
 #include "game/entities/player.hpp"
 #include "game/map/map.hpp"
+#include "utils/defaults.hpp"
 
 // Render centralitzat al manager per confinar la dependència cap a
 // `Surface`. Les entitats exposen `getSurface()` + `getPixelRect()` i el
@@ -124,7 +125,7 @@ namespace {
         if (s.contains("path")) {
             const auto REL = s["path"].get_value<std::string>();
             info.key = std::filesystem::path(REL).filename().string();
-            info.full_path = "data/entities/" + type + "/" + REL;
+            info.full_path = std::string{Defaults::Paths::ENTITIES_DIR} + type + "/" + REL;
             info.valid = true;
         }
         if (s.contains("size")) {

source/game/entities/player.cpp

@@ -179,16 +179,16 @@ void Player::readJumpBlock(const fkyaml::node& yaml) {
     if (j.contains("gravity")) { jump_config.gravity_px_per_s2 = j["gravity"].get_value<float>(); }
     if (j.contains("landing_stun_ms")) { jump_config.landing_stun_ms = j["landing_stun_ms"].get_value<int>(); }
     if (j.contains("shadow_y_offset")) { jump_config.shadow_y_offset = j["shadow_y_offset"].get_value<int>(); }
-    // Sons opcionals: el nom del fitxer (relatiu a data/sounds/) val tant
-    // de clau al Resource::Cache com de basename per a la càrrega. Si el
-    // camp manca, la clau queda buida i `playSound` no es crida.
+    // Sons opcionals: el nom del fitxer (relatiu a Defaults::Paths::AUDIO_SOUNDS_DIR)
+    // val tant de clau al Resource::Cache com de basename per a la càrrega.
+    // Si el camp manca, la clau queda buida i `playSound` no es crida.
     if (j.contains("sound")) {
         jump_config.sound_key = j["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(jump_config.sound_key, "data/sounds/" + jump_config.sound_key);
+        Resource::Cache::get().loadSound(jump_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + jump_config.sound_key);
     }
     if (j.contains("land_sound")) {
         jump_config.land_sound_key = j["land_sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(jump_config.land_sound_key, "data/sounds/" + jump_config.land_sound_key);
+        Resource::Cache::get().loadSound(jump_config.land_sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + jump_config.land_sound_key);
     }
 }
 
@@ -201,7 +201,7 @@ void Player::readHurtBlock(const fkyaml::node& yaml) {
     // So d'entrada a HURT — mateix patró que `jump.sound` i `whip.sound`.
     if (h.contains("sound")) {
         hurt_config.sound_key = h["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(hurt_config.sound_key, "data/sounds/" + hurt_config.sound_key);
+        Resource::Cache::get().loadSound(hurt_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + hurt_config.sound_key);
     }
 }
 
@@ -220,10 +220,11 @@ void Player::readImmunityBlock(const fkyaml::node& yaml) {
     if (im.contains("duration_ms")) { immunity_config.duration_ms = im["duration_ms"].get_value<float>(); }
     if (im.contains("blink_period_ms")) { immunity_config.blink_period_ms = im["blink_period_ms"].get_value<int>(); }
     // Paleta del blink: el basename val tant de clau al Resource::Cache
-    // com de path (`data/player/<key>.pal`). Mateix patró que els sons.
+    // com de path (`Defaults::Paths::PLAYER_DIR + key + .pal`). Mateix patró
+    // que els sons.
     if (im.contains("palette")) {
         immunity_config.palette_key = im["palette"].get_value<std::string>();
-        Resource::Cache::get().loadPalette(immunity_config.palette_key, "data/player/" + immunity_config.palette_key + ".pal");
+        Resource::Cache::get().loadPalette(immunity_config.palette_key, std::string{Defaults::Paths::PLAYER_DIR} + immunity_config.palette_key + ".pal");
     }
 }
 
@@ -239,7 +240,7 @@ void Player::readWhipBlock(const fkyaml::node& yaml) {
     // clau al cache i de path. Si manca, queda buit i no es dispara.
     if (w.contains("sound")) {
         whip_config.sound_key = w["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(whip_config.sound_key, "data/sounds/" + whip_config.sound_key);
+        Resource::Cache::get().loadSound(whip_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + whip_config.sound_key);
     }
 }
 

source/game/entities/player.hpp

@@ -91,7 +91,7 @@ class Player : public AnimatedSprite {
         DYING,
     };
 
-    // Geometria carregada des del YAML del player (p.ex. `data/player/sam.yaml`).
+    // Geometria carregada des del YAML del player (p.ex. `data/entities/player/sam.yaml`).
     // `sprite_*` són
     // la mida del frame (sprite 12×24 amb perspectiva falsa: visualment, els
     // 12 píxels superiors són el cap i els 12 inferiors la base).
@@ -362,7 +362,7 @@ class Player : public AnimatedSprite {
     // al respawn post-mort: mateixa entrada cinemàtica.
     void spawnFromAir(float x, float y);
 
-    // Arma un preset de reverb (catàleg a `data/sounds.yaml`) per al
+    // Arma un preset de reverb (catàleg a `data/config/sounds.yaml`) per al
     // pròxim aterratge d'aquest jugador. Pensat per a la cinemàtica
     // d'INTRO de sala: GameScene crida aquesta funció just després de
     // `spawnFromAir`, i el primer LAND consumeix el preset (queda buit
@@ -529,7 +529,7 @@ class Player : public AnimatedSprite {
     // gestiona `intended_vx_/vy_` escalats pel resolver.
     bool being_pushed_{false};
 
-    // Preset de reverb (catàleg de `data/sounds.yaml`) que el pròxim
+    // Preset de reverb (catàleg de `data/config/sounds.yaml`) que el pròxim
     // LAND ha de fer servir; buit = so sec. L'arma `armNextLandReverb`
     // (cridada per GameScene al spawn aeri d'INTRO) i el consumeix
     // `integrateJump` quan el jugador toca terra. Cap altre punt
@@ -636,7 +636,7 @@ class Player : public AnimatedSprite {
     struct HurtConfig {
         float initial_speed_px_per_s{0.0F};  // Velocitat amb què surt projectat (px/s).
         int brake_time_ms{0};                // Temps en que la velocitat decau a 0.
-        // Fitxer .wav reproduït en entrar a HURT (relatiu a `data/sounds/`).
+        // Fitxer .wav reproduït en entrar a HURT (relatiu a `data/audio/sounds/`).
         // Mateixa convenció que la resta de sons del jugador: el basename val
         // de clau al Resource::Cache i de path. Buit o absent = entrada
         // silenciosa.
@@ -660,7 +660,7 @@ class Player : public AnimatedSprite {
         int cooldown_ms{0};
         int damage{0};
         // Fitxer .wav reproduït al moment de disparar el swing (relatiu a
-        // `data/sounds/`). Convenció: el basename val tant de clau al
+        // `data/audio/sounds/`). Convenció: el basename val tant de clau al
         // Resource::Cache com de path. Buit o absent = swing silenciós.
         std::string sound_key;
     };
@@ -697,7 +697,7 @@ class Player : public AnimatedSprite {
         float duration_ms{0.0F};
         int blink_period_ms{0};
         // Clau al Resource::Cache de la paleta plana usada al blink (basename
-        // del .pal a `data/player/`). Buida = no hi ha alternança visual,
+        // del .pal a `data/entities/player/`). Buida = no hi ha alternança visual,
         // només la finestra lògica d'immunitat (que sense feedback visual
         // pot ser confusa, però no és incorrecte).
         std::string palette_key;
@@ -706,7 +706,7 @@ class Player : public AnimatedSprite {
 
     // Llig el bloc `immunity:` del YAML i n'omple `immunity_config`. Si
     // hi ha `palette`, registra la paleta corresponent al Resource::Cache
-    // (path: `data/player/<palette_key>.pal`). Mateix patró que els altres
+    // (path: `data/entities/player/<palette_key>.pal`). Mateix patró que els altres
     // readers — `loadFrom` el crida al final.
     static void readImmunityBlock(const fkyaml::node& yaml);