feat: new user settings preview section

Jellyfin/backend/Api/MoonfinController.cs

@@ -358,6 +358,120 @@ public async Task<ActionResult<MoonfinUserSettings>> GetUserSettings([FromRoute]
         return Ok(settings);
     }
 
+    /// <summary>
+    /// Explains what a user gets on one device type, setting by setting, and which layer each
+    /// value comes from (admin only, read-only).
+    /// </summary>
+    /// <param name="userId">The user ID.</param>
+    /// <param name="profile">global, desktop, mobile or tv.</param>
+    [HttpGet("Admin/Settings/Explain/{userId}")]
+    [Authorize(Policy = "RequiresElevation")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status503ServiceUnavailable)]
+    public async Task<ActionResult<SettingsExplanation>> ExplainUserSettings(
+        [FromRoute] Guid userId,
+        [FromQuery] string profile = "global")
+    {
+        if (MoonfinPlugin.Instance?.Configuration?.EnableSettingsSync != true)
+        {
+            return StatusCode(StatusCodes.Status503ServiceUnavailable, new { Error = "Settings sync is disabled" });
+        }
+
+        if (userId == Guid.Empty || !MoonfinUserSettings.ValidProfiles.Contains(profile.ToLowerInvariant()))
+        {
+            return BadRequest(new { Error = "A valid userId and a profile of global, desktop, mobile or tv are required" });
+        }
+
+        return Ok(await _settingsService.ExplainProfileAsync(userId, profile));
+    }
+
+    /// <summary>
+    /// For every user on the server, how many settings each profile stores and how many only
+    /// repeat what the layers below give (admin only, read-only).
+    /// </summary>
+    [HttpGet("Admin/Settings/Overview")]
+    [Authorize(Policy = "RequiresElevation")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status503ServiceUnavailable)]
+    public async Task<ActionResult<List<SettingsOverviewEntry>>> GetSettingsOverview()
+    {
+        if (MoonfinPlugin.Instance?.Configuration?.EnableSettingsSync != true)
+        {
+            return StatusCode(StatusCodes.Status503ServiceUnavailable, new { Error = "Settings sync is disabled" });
+        }
+
+        var userIds = GetAllServerUserIds();
+        if (userIds == null)
+        {
+            return StatusCode(StatusCodes.Status503ServiceUnavailable, new { Error = "User manager unavailable" });
+        }
+
+        return Ok(await _settingsService.GetSettingsOverviewAsync(userIds));
+    }
+
+    /// <summary>
+    /// Removes, for the given users, the stored values that only repeat what they would inherit
+    /// anyway (admin only). What users get doesn't change. With dryRun, only counts.
+    /// </summary>
+    [HttpPost("Admin/Settings/RemoveRepeated")]
+    [Authorize(Policy = "RequiresElevation")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status503ServiceUnavailable)]
+    public async Task<ActionResult> RemoveRepeatedSettings([FromBody] MoonfinSettingsUsersRequest request, [FromQuery] bool dryRun = true)
+    {
+        if (MoonfinPlugin.Instance?.Configuration?.EnableSettingsSync != true)
+        {
+            return StatusCode(StatusCodes.Status503ServiceUnavailable, new { Error = "Settings sync is disabled" });
+        }
+
+        if (request.UserIds == null || request.UserIds.Count == 0)
+        {
+            return BadRequest(new { Error = "Pick at least one user" });
+        }
+
+        var (users, values) = await _settingsService.RemoveRepeatedValuesAsync(request.UserIds, dryRun);
+        return Ok(new { users, values, dryRun });
+    }
+
+    /// <summary>
+    /// Removes the named settings from one user's profiles, or every user's, so they fall back to
+    /// the admin defaults (admin only).
+    /// </summary>
+    [HttpPost("Admin/Settings/Clear")]
+    [Authorize(Policy = "RequiresElevation")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status503ServiceUnavailable)]
+    public async Task<ActionResult> ClearUserSettings([FromBody] MoonfinClearSettingsRequest request)
+    {
+        if (MoonfinPlugin.Instance?.Configuration?.EnableSettingsSync != true)
+        {
+            return StatusCode(StatusCodes.Status503ServiceUnavailable, new { Error = "Settings sync is disabled" });
+        }
+
+        if (request.Fields == null || request.Fields.Count == 0)
+        {
+            return BadRequest(new { Error = "Pick at least one setting to clear" });
+        }
+
+        if (request.UserIds == null || request.UserIds.Count == 0)
+        {
+            return BadRequest(new { Error = "Pick at least one user" });
+        }
+
+        try
+        {
+            var (users, values) = await _settingsService.ClearSettingsAsync(request.Fields, request.UserIds);
+            return Ok(new { users, values });
+        }
+        catch (ArgumentException ex)
+        {
+            return BadRequest(new { Error = ex.Message });
+        }
+    }
+
     /// <summary>
     /// Saves settings for the current authenticated user.
     /// </summary>
@@ -942,7 +1056,12 @@ public async Task<ActionResult<MoonfinSaveResponse>> SaveMyProfile(
 
         var existed = _settingsService.UserSettingsExist(userId.Value);
 
-        await _settingsService.SaveProfileAsync(userId.Value, profile, request.Profile, request.ClientId);
+        await _settingsService.SaveProfileAsync(
+            userId.Value,
+            profile,
+            request.Profile,
+            request.ClientId,
+            dropInheritedValues: true);
 
         return Ok(new MoonfinSaveResponse
         {
@@ -1646,6 +1765,22 @@ public class MoonfinProfileSaveRequest
     public string? ClientId { get; set; }
 }
 
+/// <summary>
+/// The users an admin settings action applies to.
+/// </summary>
+public class MoonfinSettingsUsersRequest
+{
+    public List<Guid>? UserIds { get; set; }
+}
+
+/// <summary>
+/// Settings for an admin to clear, and the users to clear them for.
+/// </summary>
+public class MoonfinClearSettingsRequest : MoonfinSettingsUsersRequest
+{
+    public List<string>? Fields { get; set; }
+}
+
 /// <summary>
 /// Response for saving settings.
 /// </summary>

Jellyfin/backend/Models/SettingsExplanation.cs

@@ -0,0 +1,93 @@
+using System.Text.Json.Nodes;
+using System.Text.Json.Serialization;
+
+namespace Moonfin.Server.Models;
+
+/// <summary>
+/// What one user gets on one device type, setting by setting, for the admin preview.
+/// </summary>
+public class SettingsExplanation
+{
+    [JsonPropertyName("profile")]
+    public string Profile { get; set; } = string.Empty;
+
+    /// <summary>False when the user never synced, so everything comes from the defaults.</summary>
+    [JsonPropertyName("hasSettingsFile")]
+    public bool HasSettingsFile { get; set; }
+
+    [JsonPropertyName("lastUpdated")]
+    public long? LastUpdated { get; set; }
+
+    [JsonPropertyName("lastUpdatedBy")]
+    public string? LastUpdatedBy { get; set; }
+
+    [JsonPropertyName("fields")]
+    public List<SettingExplanation> Fields { get; set; } = new();
+}
+
+/// <summary>
+/// One setting: the value the user gets, the layer it comes from, and what each layer holds.
+/// </summary>
+public class SettingExplanation
+{
+    [JsonPropertyName("name")]
+    public string Name { get; set; } = string.Empty;
+
+    /// <summary>device, global, default (the admin defaults) or none (the app's own default).</summary>
+    [JsonPropertyName("source")]
+    public string Source { get; set; } = "none";
+
+    [JsonPropertyName("effective")]
+    public JsonNode? Effective { get; set; }
+
+    [JsonPropertyName("device")]
+    public JsonNode? Device { get; set; }
+
+    [JsonPropertyName("global")]
+    public JsonNode? Global { get; set; }
+
+    [JsonPropertyName("default")]
+    public JsonNode? Default { get; set; }
+
+    /// <summary>The device value only repeats what global or the defaults would give.</summary>
+    [JsonPropertyName("deviceRedundant")]
+    public bool DeviceRedundant { get; set; }
+
+    /// <summary>The global value only repeats the admin default.</summary>
+    [JsonPropertyName("globalRedundant")]
+    public bool GlobalRedundant { get; set; }
+}
+
+/// <summary>
+/// How many settings one user has stored in each profile, for the admin overview.
+/// </summary>
+public class SettingsOverviewEntry
+{
+    [JsonPropertyName("userId")]
+    public Guid UserId { get; set; }
+
+    [JsonPropertyName("hasSettingsFile")]
+    public bool HasSettingsFile { get; set; }
+
+    [JsonPropertyName("lastUpdated")]
+    public long? LastUpdated { get; set; }
+
+    [JsonPropertyName("lastUpdatedBy")]
+    public string? LastUpdatedBy { get; set; }
+
+    [JsonPropertyName("desktop")]
+    public int Desktop { get; set; }
+
+    [JsonPropertyName("mobile")]
+    public int Mobile { get; set; }
+
+    [JsonPropertyName("tv")]
+    public int Tv { get; set; }
+
+    [JsonPropertyName("global")]
+    public int Global { get; set; }
+
+    /// <summary>How many stored values only repeat what the layers below give.</summary>
+    [JsonPropertyName("repeated")]
+    public int Repeated { get; set; }
+}