Antone Barbaud
b02e532563
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>
120 lines
3.6 KiB
Plaintext
120 lines
3.6 KiB
Plaintext
@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
|