Options de configuration¶

Copy of sumaris-pod/.agents/rules/configuration-option.md (rule written for AI coding agents, when adding or modifying configuration options, caching configuration values, or using SumarisConfiguration). Do not edit here: run npm run site:sync-rules to update it.

N'ajoute JAMAIS de lecture directe de configuration dans les méthodes métier. Lis les valeurs une seule fois et mets-les en cache dans des champs d'instance.
Utilise @PostConstruct et @EventListener({ConfigurationReadyEvent.class, ConfigurationUpdatedEvent.class}) sur une méthode onConfigurationReady().
Les options côté client vont dans SumarisConfigurationOption, côté serveur dans SumarisServerConfigurationOption.
Récupère les valeurs via les beans SumarisConfiguration / SumarisServerConfiguration et conserve-les dans des champs privées.
Exemple type :

@PostConstruct
@EventListener({ConfigurationReadyEvent.class, ConfigurationUpdatedEvent.class})
public void onConfigurationReady() {
    this.cachedValue = configuration.getConfigValue();
}