Skip to content

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();
}