feat(api): Update player management API and enhance player entity structure

Author: TheMeinerLP

backend/src/main/java/net/onelitefeather/otis/OtisApplication.java

@@ -12,7 +12,7 @@
 @OpenAPIDefinition(
         info = @Info(
                 title = "Otis API",
-                version = "0.0.1",
+                version = "1.0.1",
                 description = "Simple user management system",
                 license = @License(name = "Apache-2.0"),
                 contact = @Contact(url = "https://onelitefeather.net", name = "Management", email = "admin@onelitefeather.net")

backend/src/main/java/net/onelitefeather/otis/controller/OtisRequestsController.java

@@ -60,7 +60,7 @@ public OtisRequestsController(OtisPlayerRepository repository) {
     public HttpResponse<OtisPlayerDTO> add(@Valid OtisPlayerDTO playerDTO) {
         LOGGER.info("Adding new player: {}", playerDTO);
         OtisPlayer otisPlayer = OtisPlayer.toEntity(playerDTO);
-        OtisPlayer saved = repository.update(otisPlayer);
+        OtisPlayer saved = repository.save(otisPlayer);
         LOGGER.info("Saved player: {}", saved);
         return HttpResponse.ok(saved.toDto());
     }
@@ -90,7 +90,7 @@ public HttpResponse<OtisPlayerDTO> add(@Valid OtisPlayerDTO playerDTO) {
     @Validated
     @Get("/byId/{owner}")
     public HttpResponse<OtisPlayerDTO> getById(@Valid UUID owner) {
-        OtisPlayer entity = this.repository.findById(owner).orElse(null);
+        OtisPlayer entity = this.repository.findByPlayerUuid(owner).orElse(null);
         if (entity == null) {
             return HttpResponse.notFound();
         }

backend/src/main/java/net/onelitefeather/otis/database/entity/OtisPlayer.java

@@ -22,13 +22,18 @@
 
 @Serdeable
 @Entity
-@Table(name = "otis_player", indexes = @Index(columnList = "uuid"))
+@Table(name = "otis_player", indexes = {
+        @Index(name = "idx_player_uuid", columnList = "playerUuid"),
+        @Index(name = "idx_player_name", columnList = "playerName")
+})
 public class OtisPlayer {
 
     @Id
     @GeneratedValue(strategy = GenerationType.UUID)
     private UUID uuid;
 
+    private UUID playerUuid;
+
     private String playerName;
 
     private long firstJoin;
@@ -45,6 +50,7 @@ public class OtisPlayer {
     public static OtisPlayer toEntity(OtisPlayerDTO otisPlayerDTO) {
         return new OtisPlayer(
                 otisPlayerDTO.uuid(),
+                otisPlayerDTO.playerUuid(),
                 otisPlayerDTO.playerName(),
                 otisPlayerDTO.firstJoin(),
                 otisPlayerDTO.lastJoin(),
@@ -64,14 +70,17 @@ public OtisPlayer() {
      * Creates a new instance of the {@link OtisPlayer} with all required values.
      *
      * @param uuid           the unique identifier from the player
+     * @param playerUuid     the unique player UUID from mojang
      * @param playerName     the name from the player
      * @param firstJoin      the first join from the player
      * @param lastJoin       the last join from the player
      * @param profileTexture the profile texture from the player
      * @param locale         the locale from the player
      */
-    public OtisPlayer(UUID uuid, String playerName, long firstJoin, long lastJoin, Map<String, Object> profileTexture, Locale locale) {
+    public OtisPlayer(UUID uuid, UUID playerUuid, String playerName, long firstJoin, long lastJoin,
+                      Map<String, Object> profileTexture, Locale locale) {
         this.uuid = uuid;
+        this.playerUuid = playerUuid;
         this.playerName = playerName;
         this.firstJoin = firstJoin;
         this.lastJoin = lastJoin;
@@ -118,6 +127,7 @@ public Locale getLocale() {
     public OtisPlayerDTO toDto() {
         return new OtisPlayerDTO(
                 this.uuid,
+                this.playerUuid,
                 this.playerName,
                 this.firstJoin,
                 this.lastJoin,

backend/src/main/java/net/onelitefeather/otis/database/repository/OtisPlayerRepository.java

@@ -14,4 +14,7 @@ public interface OtisPlayerRepository extends PageableRepository<OtisPlayer, UUI
 
     @Query("SELECT player FROM OtisPlayer player WHERE player.playerName = :name")
     Optional<OtisPlayer> findByName(@Param("name") String name);
+
+    @Query("SELECT player FROM OtisPlayer player WHERE player.playerUuid = :uuid")
+    Optional<OtisPlayer> findByPlayerUuid(@Param("uuid") UUID uuid);
 }

backend/src/main/java/net/onelitefeather/otis/dto/OtisPlayerDTO.java

@@ -2,6 +2,7 @@
 
 import io.micronaut.core.annotation.Introspected;
 import io.micronaut.serde.annotation.Serdeable;
+import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.Size;
 
@@ -12,13 +13,33 @@
 @Serdeable
 @Introspected
 public record OtisPlayerDTO(
+        @Schema(description = "Unique identifier for the player in the Otis system.",
+                example = "123e4567-e89b-12d3-a456-426614174000", type = "string", format = "uuid")
         UUID uuid,
+        @Schema(description = "Unique identifier for the player from mojang.",
+                example = "123e4567-e89b-12d3-a456-426614174001", type = "string", format = "uuid"
+        )
+        UUID playerUuid,
         @Size(min = 3, max = 16, message = "Username must be between 3 and 16 characters.")
         @Pattern(regexp = "^[a-zA-Z0-9_]+$", message = "Username can only contain alphanumeric characters and underscores.")
+        @Schema(description = "The player's username.",
+                example = "Player123", type = "string", format = "username",
+                minimum = "3", maximum = "16", pattern = "^[a-zA-Z0-9_]+$"
+        )
         String playerName,
+        @Schema(description = "The timestamp of the player's first join in milliseconds since epoch.",
+                example = "1633072800000", type = "integer", format = "int64"
+        )
         long firstJoin,
+        @Schema(description = "The timestamp of the player's last join in milliseconds since epoch.",
+                example = "1633072800000", type = "integer", format = "int64"
+        )
         long lastJoin,
+        @Schema(description = "A map containing the player's profile textures, such as skin and cape.")
         Map<String, Object> profileTextures,
+        @Schema(description = "The locale of the player, used for localization purposes.",
+                example = "en-US", type = "string", format = "locale"
+        )
         Locale locale
 ) {
 }

java-client/build.gradle.kts

@@ -18,7 +18,7 @@ dependencies {
 openApiGenerate {
     generatorName.set("java")
     library.set("native")
-    inputSpec.set("$projectDir/specs/otis-api-0.0.1.yml")
+    inputSpec.set("$projectDir/specs/otis-api-1.0.1.yml")
     outputDir.set(outDir.get().asFile.absolutePath)
     apiPackage.set("net.onelitefeather.otis.client.api")
     invokerPackage.set("net.onelitefeather.otis.client.invoker")