docs: organize diagrams to mirror code layout (util/ + features/)

Move flat docs/diagrams/*.puml into a hierarchy matching the source
package structure:

  docs/diagrams/
  ├── bootstrap-sequence.puml         (cross-cutting)
  ├── events-diagram.puml             (cross-feature)
  ├── util/
  │   ├── command-class-diagram.puml
  │   ├── database-diagram.puml
  │   ├── messages-class-diagram.puml
  │   ├── broadcasts-class-diagram.puml
  │   └── gui-class-diagram.puml
  └── features/
      ├── team/
      │   ├── team-class-diagram.puml
      │   ├── team-config-class-diagram.puml
      │   ├── builtin-commands-diagram.puml
      │   ├── team-create-sequence.puml
      │   ├── team-create-activity.puml
      │   └── team-join-sequence.puml
      ├── player/
      │   └── player-class-diagram.puml
      └── moderation/
          └── moderation-class-diagram.puml

README.md diagram index split into 4 sections (overview, util,
features/team, features/player, features/moderation) for readability;
all links updated. features.md auto-updated by sed for the new paths.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

docs/diagrams/features/team/team-config-class-diagram.puml

@@ -0,0 +1,119 @@
+@startuml team-config-class-diagram
+title CR-Core — Team config (class diagram, cascade per-team → global → default)
+
+skinparam classAttributeIconSize 0
+hide empty members
+
+package "fr.luc.crcore.features.team.config" {
+
+  class "TeamSetting<T>" as TeamSetting <<final>> {
+    - key: String
+    - type: Class<T>
+    - defaultValue: T
+    - kind: Kind
+    - parser: Function<Object,T>
+    - serializer: Function<T,Object>
+    --
+    + {static} ofBoolean(key, default): TeamSetting<Boolean>
+    + {static} ofInt(key, default): TeamSetting<Integer>
+    + {static} ofString(key, default): TeamSetting<String>
+    + {static} ofEnum(key, default): TeamSetting<E>
+    --
+    + parse(raw): T
+    + serialize(value): Object
+    + getKey() / getType() / getDefaultValue() / getKind()
+  }
+
+  enum "TeamSetting.Kind" as Kind {
+    BOOLEAN
+    INTEGER
+    STRING
+    ENUM
+  }
+  TeamSetting +-- Kind
+
+  class TeamSettings <<utility>> {
+    + {static} FRIENDLY_FIRE: TeamSetting<Boolean>
+    + {static} PVP_PROTECTION_SECONDS: TeamSetting<Integer>
+    + {static} MAX_SIZE: TeamSetting<Integer>
+    + {static} MIN_SIZE: TeamSetting<Integer>
+    + {static} RESPAWN_AT_TEAM_SPAWN: TeamSetting<Boolean>
+    + {static} TEAM_CHAT_ENABLED: TeamSetting<Boolean>
+    + {static} SHOW_TAG_ABOVE_HEAD: TeamSetting<Boolean>
+    + {static} TEAM_COLOR_IN_NAME: TeamSetting<Boolean>
+    --
+    + {static} register(setting): void
+    + {static} get(key): Optional<TeamSetting<?>>
+    + {static} all(): Collection<TeamSetting<?>>
+  }
+  TeamSettings ..> TeamSetting
+
+  interface TeamConfigService {
+    + get(team, setting): T
+    + getGlobal(setting): T
+    + setPerTeam(team, setting, value): void
+    + resetPerTeam(team, setting): void
+    + setGlobal(setting, value): void
+    + reload(): void
+    + hasPerTeamOverride(team, setting): boolean
+    + getGlobalSnapshot(): Map<TeamSetting<?>, Object>
+    + getGlobalFileName(): Optional<String>
+  }
+
+  package "fr.luc.crcore.features.team.config.impl" {
+    class YamlTeamConfigService {
+      - plugin: JavaPlugin
+      - teamRepository: TeamRepository
+      - userFile: File
+      - globalValues: Map<String, Object>
+      --
+      - ensureUserFile(): void
+      - rebuildGlobalValues(): void
+      - persistGlobals(): void
+    }
+    YamlTeamConfigService ..|> TeamConfigService
+  }
+
+  TeamConfigService ..> TeamSetting : reads/writes
+}
+
+package "fr.luc.crcore.features.team" {
+  class Team {
+    - settings: Map<String, Object>
+    + getSettings(): Map<String, Object>
+  }
+}
+
+package "fr.luc.crcore.features.team.config.gui" {
+  abstract class AbstractSettingsGui {
+    - rebuild() : peint la grille
+    # {abstract} getCurrentValue(setting): T
+    # {abstract} onChange(setting, newValue): void
+    # isOverride(setting): boolean
+    # renderFooter(): void
+  }
+  class GlobalSettingsGui
+  class TeamSettingsGui
+  GlobalSettingsGui --|> AbstractSettingsGui
+  TeamSettingsGui  --|> AbstractSettingsGui
+  AbstractSettingsGui --|> "fr.luc.crcore.util.gui.AbstractInventoryGui"
+
+  GlobalSettingsGui --> TeamConfigService
+  TeamSettingsGui --> TeamConfigService
+  TeamSettingsGui --> Team
+}
+
+YamlTeamConfigService --> "fr.luc.crcore.features.team.TeamRepository" : persists per-team via save()
+TeamConfigService ..> Team : reads/writes settings map
+
+note bottom of YamlTeamConfigService
+  Cascade de résolution :
+    1. team.getSettings().get(key)   ← override per-team (SQLite)
+    2. globalValues.get(key)         ← <plugin>-team-config.yml
+    3. setting.getDefaultValue()     ← constante Java
+
+  Le YAML global est ré-écrit à chaque setGlobal() (persistant à crash).
+  Les per-team sont écrits via teamRepository.save(team).
+end note
+
+@enduml