fix(workspace): hide league reset settings when leagues are disabled

Author: FelixTJDietrich

server/application-server/openapi.yaml

@@ -4885,6 +4885,9 @@ components:
         leaderboardEnabled:
           type: boolean
           description: Enable the leaderboard ranking page
+        leaguesEnabled:
+          type: boolean
+          description: Enable league tiers and rankings
         practicesEnabled:
           type: boolean
           description: Enable the practice review feature
@@ -5122,6 +5125,9 @@ components:
           type: string
           description: Time for leaderboard notifications in HH:mm format
           example: 09:00
+        leaguesEnabled:
+          type: boolean
+          description: Whether league tiers and rankings are enabled
         practicesEnabled:
           type: boolean
           description: Whether the practice review feature is enabled
@@ -5163,6 +5169,7 @@ components:
       - id
       - isPubliclyViewable
       - leaderboardEnabled
+      - leaguesEnabled
       - practicesEnabled
       - progressionEnabled
       - providerType
@@ -5193,6 +5200,9 @@ components:
         leaderboardEnabled:
           type: boolean
           description: Whether the leaderboard is enabled
+        leaguesEnabled:
+          type: boolean
+          description: Whether league tiers and rankings are enabled
         practicesEnabled:
           type: boolean
           description: Whether the practice review feature is enabled
@@ -5220,6 +5230,7 @@ components:
       - displayName
       - id
       - leaderboardEnabled
+      - leaguesEnabled
       - practicesEnabled
       - progressionEnabled
       - providerType

server/application-server/src/main/java/de/tum/in/www1/hephaestus/workspace/WorkspaceFeatures.java

@@ -49,6 +49,11 @@ public class WorkspaceFeatures {
     @NotNull(message = "Progression enabled flag is required")
     private Boolean progressionEnabled = false;
 
+    /** Whether the league tiers and rankings are enabled */
+    @Column(name = "leagues_enabled", nullable = false)
+    @NotNull(message = "Leagues enabled flag is required")
+    private Boolean leaguesEnabled = false;
+
     /**
      * Applies a partial update from the request DTO (PATCH semantics).
      * Null fields in the request are ignored; non-null fields overwrite the current value.
@@ -66,5 +71,8 @@ public void applyPatch(UpdateWorkspaceFeaturesRequestDTO request) {
         if (request.progressionEnabled() != null) {
             this.progressionEnabled = request.progressionEnabled();
         }
+        if (request.leaguesEnabled() != null) {
+            this.leaguesEnabled = request.leaguesEnabled();
+        }
     }
 }

server/application-server/src/main/java/de/tum/in/www1/hephaestus/workspace/WorkspaceSettingsService.java

@@ -151,12 +151,13 @@ public Workspace updateFeatures(Long workspaceId, UpdateWorkspaceFeaturesRequest
         workspace.getFeatures().applyPatch(request);
 
         log.info(
-            "Updated workspace features: workspaceId={}, practices={}, achievements={}, leaderboard={}, progression={}",
+            "Updated workspace features: workspaceId={}, practices={}, achievements={}, leaderboard={}, progression={}, leagues={}",
             workspaceId,
             request.practicesEnabled(),
             request.achievementsEnabled(),
             request.leaderboardEnabled(),
-            request.progressionEnabled()
+            request.progressionEnabled(),
+            request.leaguesEnabled()
         );
         return workspaceRepository.save(workspace);
     }

server/application-server/src/main/java/de/tum/in/www1/hephaestus/workspace/dto/UpdateWorkspaceFeaturesRequestDTO.java

@@ -11,5 +11,6 @@ public record UpdateWorkspaceFeaturesRequestDTO(
     @Schema(description = "Enable the practice review feature") Boolean practicesEnabled,
     @Schema(description = "Enable the achievements system") Boolean achievementsEnabled,
     @Schema(description = "Enable the leaderboard ranking page") Boolean leaderboardEnabled,
-    @Schema(description = "Enable the league/progression system") Boolean progressionEnabled
+    @Schema(description = "Enable the league/progression system") Boolean progressionEnabled,
+    @Schema(description = "Enable league tiers and rankings") Boolean leaguesEnabled
 ) {}

server/application-server/src/main/java/de/tum/in/www1/hephaestus/workspace/dto/WorkspaceDTO.java

@@ -45,7 +45,8 @@ public record WorkspaceDTO(
     @NonNull @Schema(description = "Whether the practice review feature is enabled") Boolean practicesEnabled,
     @NonNull @Schema(description = "Whether the achievements system is enabled") Boolean achievementsEnabled,
     @NonNull @Schema(description = "Whether the leaderboard is enabled") Boolean leaderboardEnabled,
-    @NonNull @Schema(description = "Whether the league/progression system is enabled") Boolean progressionEnabled
+    @NonNull @Schema(description = "Whether the league/progression system is enabled") Boolean progressionEnabled,
+    @NonNull @Schema(description = "Whether league tiers and rankings are enabled") Boolean leaguesEnabled
 ) {
     public static WorkspaceDTO from(Workspace workspace) {
         return new WorkspaceDTO(
@@ -74,7 +75,8 @@ public static WorkspaceDTO from(Workspace workspace) {
             workspace.getFeatures().getPracticesEnabled(),
             workspace.getFeatures().getAchievementsEnabled(),
             workspace.getFeatures().getLeaderboardEnabled(),
-            workspace.getFeatures().getProgressionEnabled()
+            workspace.getFeatures().getProgressionEnabled(),
+            workspace.getFeatures().getLeaguesEnabled()
         );
     }
 }

server/application-server/src/main/java/de/tum/in/www1/hephaestus/workspace/dto/WorkspaceListItemDTO.java

@@ -22,7 +22,8 @@ public record WorkspaceListItemDTO(
     @NonNull @Schema(description = "Whether the practice review feature is enabled") Boolean practicesEnabled,
     @NonNull @Schema(description = "Whether the achievements system is enabled") Boolean achievementsEnabled,
     @NonNull @Schema(description = "Whether the leaderboard is enabled") Boolean leaderboardEnabled,
-    @NonNull @Schema(description = "Whether the league/progression system is enabled") Boolean progressionEnabled
+    @NonNull @Schema(description = "Whether the league/progression system is enabled") Boolean progressionEnabled,
+    @NonNull @Schema(description = "Whether league tiers and rankings are enabled") Boolean leaguesEnabled
 ) {
     public static WorkspaceListItemDTO from(Workspace workspace) {
         return new WorkspaceListItemDTO(
@@ -36,7 +37,8 @@ public static WorkspaceListItemDTO from(Workspace workspace) {
             workspace.getFeatures().getPracticesEnabled(),
             workspace.getFeatures().getAchievementsEnabled(),
             workspace.getFeatures().getLeaderboardEnabled(),
-            workspace.getFeatures().getProgressionEnabled()
+            workspace.getFeatures().getProgressionEnabled(),
+            workspace.getFeatures().getLeaguesEnabled()
         );
     }
 }

server/application-server/src/main/resources/db/changelog/1775000000000_changelog.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
+                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
+                   https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
+
+    <changeSet id="1775000000000-1" author="hephaestus">
+        <comment>Add leagues_enabled feature flag column to workspace table</comment>
+        <addColumn tableName="workspace">
+            <column name="leagues_enabled" type="BOOLEAN" defaultValueBoolean="false">
+                <constraints nullable="false"/>
+            </column>
+        </addColumn>
+    </changeSet>
+
+</databaseChangeLog>

server/application-server/src/main/resources/db/master.xml

@@ -67,4 +67,5 @@
     <include file="./changelog/1774785360089_changelog.xml" relativeToChangelogFile="true"/>
     <include file="./changelog/1774800000000_changelog.xml" relativeToChangelogFile="true"/>
     <include file="./changelog/1774900000000_changelog.xml" relativeToChangelogFile="true"/>
+    <include file="./changelog/1775000000000_changelog.xml" relativeToChangelogFile="true"/>
 </databaseChangeLog>

webapp/src/api/types.gen.ts

@@ -140,6 +140,10 @@ export type WorkspaceListItem = {
      * Whether the leaderboard is enabled
      */
     leaderboardEnabled: boolean;
+    /**
+     * Whether league tiers and rankings are enabled
+     */
+    leaguesEnabled: boolean;
     /**
      * Whether the practice review feature is enabled
      */
@@ -242,6 +246,10 @@ export type Workspace = {
      * Time for leaderboard notifications in HH:mm format
      */
     leaderboardScheduleTime?: string;
+    /**
+     * Whether league tiers and rankings are enabled
+     */
+    leaguesEnabled: boolean;
     /**
      * Whether the practice review feature is enabled
      */
@@ -460,6 +468,10 @@ export type UpdateWorkspaceFeaturesRequest = {
      * Enable the leaderboard ranking page
      */
     leaderboardEnabled?: boolean;
+    /**
+     * Enable league tiers and rankings
+     */
+    leaguesEnabled?: boolean;
     /**
      * Enable the practice review feature
      */

webapp/src/components/admin/AdminFeaturesSettings.stories.tsx

@@ -37,6 +37,7 @@ const meta = {
 		achievementsEnabled: false,
 		leaderboardEnabled: false,
 		progressionEnabled: false,
+		leaguesEnabled: false,
 		isSaving: false,
 		onToggle: fn(),
 	},