Antone Barbaud
84735221f1
Package restructure to prepare future modularization. Three layers now:
1. fr.luc.crcore.util.* (always active)
- common, command framework, database, message, broadcast, gui,
placeholder
2. fr.luc.crcore.features.* (opt-in)
- team (entities, services, repos, events, exceptions, config + GUI,
command/Team*SubCommand)
- player (profile, ranking, services, repos, events, exceptions)
3. fr.luc.crcore.builtin.*
- CoreCommand + CoreReloadSubCommand (top-level routing — not a
feature, not an util)
FQN moves (game plugins importing these need their imports updated):
- fr.luc.crcore.common.* → fr.luc.crcore.util.common.*
- fr.luc.crcore.command.* → fr.luc.crcore.util.command.*
- fr.luc.crcore.command.builtin.team.*
→ fr.luc.crcore.features.team.command.*
- fr.luc.crcore.command.builtin.CoreCommand / CoreReloadSubCommand
→ fr.luc.crcore.builtin.*
- fr.luc.crcore.database.* → fr.luc.crcore.util.database.*
- fr.luc.crcore.message.* → fr.luc.crcore.util.message.*
- fr.luc.crcore.broadcast.* → fr.luc.crcore.util.broadcast.*
- fr.luc.crcore.gui.* → fr.luc.crcore.util.gui.*
- fr.luc.crcore.placeholder.* → fr.luc.crcore.util.placeholder.*
- fr.luc.crcore.team.* → fr.luc.crcore.features.team.*
- fr.luc.crcore.player.* → fr.luc.crcore.features.player.*
CRCoreConfig — features opt-in via fluent setup:
- setupTeams() enables team feature
- setupPlayers() enables player feature
- setupPlaceholders() enables PAPI integration
- setupAll() shortcut
By default no feature is active. Game plugin must opt-in.
CRCore.enable() now conditional:
- Util services always built (messages, broadcasts, gui listener).
- Team services + repos + config built only if setupTeams().
- Player services + repos built only if setupPlayers().
- Placeholder hook registered only if setupPlaceholders() (and PAPI
installed at runtime).
- Getters of disabled features throw IllegalStateException with a clear
message pointing to the missing setupX() call.
- CoreCommand only registers TeamGroupSubCommand if teamService and
teamConfig are non-null. CoreReloadSubCommand handles teamConfig=null
(just skips that reload). /core reload always available.
Docs:
- setup.md tree fully rewritten to reflect util/+features/+builtin
layout (~70 lines of arborescence).
- setup.md code snippet shows the three opt-in patterns (setupAll /
granular / with options).
- decisions.md logs both decisions (restructure + modular setup).
- All .puml diagrams auto-updated to new FQNs.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
87 lines
1.9 KiB
Plaintext
87 lines
1.9 KiB
Plaintext
@startuml database-diagram
|
|
title CR-Core — Database (SQLite wrapper)
|
|
|
|
skinparam classAttributeIconSize 0
|
|
hide empty members
|
|
|
|
package "fr.luc.crcore.util.database" {
|
|
|
|
class Database {
|
|
- connection: Connection
|
|
+ Database(file: File)
|
|
+ execute(sql, params...): void
|
|
+ update(sql, params...): int
|
|
+ queryOne(sql, mapper, params...): Optional<T>
|
|
+ query(sql, mapper, params...): List<T>
|
|
+ inTransaction(block: Runnable): void
|
|
+ table(name: String): TableBuilder
|
|
+ tableExists(name: String): boolean
|
|
+ getConnection(): Connection
|
|
+ close(): void
|
|
}
|
|
Database ..|> "java.lang.AutoCloseable"
|
|
|
|
class TableBuilder {
|
|
- database: Database
|
|
- name: String
|
|
- columns: List<ColumnDef>
|
|
- ifNotExists: boolean
|
|
+ ifNotExists(): TableBuilder
|
|
+ column(name, type): ColumnDef
|
|
+ create(): void
|
|
}
|
|
|
|
class "TableBuilder.ColumnDef" as ColumnDef {
|
|
- name: String
|
|
- type: ColumnType
|
|
- primaryKey: boolean
|
|
- notNull: boolean
|
|
- unique: boolean
|
|
- defaultValue: String
|
|
+ primaryKey(): ColumnDef
|
|
+ notNull(): ColumnDef
|
|
+ unique(): ColumnDef
|
|
+ defaultValue(expr: String): ColumnDef
|
|
+ column(name, type): ColumnDef
|
|
+ create(): void
|
|
}
|
|
|
|
enum ColumnType {
|
|
INTEGER
|
|
REAL
|
|
TEXT
|
|
BLOB
|
|
BOOLEAN
|
|
UUID
|
|
--
|
|
+ getSqlType(): String
|
|
}
|
|
|
|
interface "RowMapper<T>" as RowMapper {
|
|
+ map(rs: ResultSet): T
|
|
}
|
|
|
|
class DatabaseException
|
|
DatabaseException --|> RuntimeException
|
|
|
|
Database "1" *-- "*" TableBuilder : creates
|
|
TableBuilder "1" *-- "*" ColumnDef : contains
|
|
ColumnDef --> ColumnType : type
|
|
Database ..> RowMapper : uses
|
|
Database ..> DatabaseException : throws
|
|
}
|
|
|
|
note right of Database
|
|
Repositories SQLite de CR-Core
|
|
(SqliteTeamRepository,
|
|
SqlitePlayerProfileRepository)
|
|
utilisent Database pour
|
|
persister state team/player.
|
|
|
|
Les plugins de jeu utilisent
|
|
Database.table(...) pour
|
|
créer leurs tables custom.
|
|
end note
|
|
|
|
@enduml
|