Allow K+ to override data it has set itself Fixes #3632 #3836

API/Controllers/ChapterController.cs

@@ -9,6 +9,7 @@ using API.DTOs;
 using API.DTOs.SeriesDetail;
 using API.Entities;
 using API.Entities.Enums;
+using API.Entities.MetadataMatching;
 using API.Entities.Person;
 using API.Extensions;
 using API.Helpers;
@@ -208,6 +209,7 @@ public class ChapterController : BaseApiController
         if (chapter.AgeRating != dto.AgeRating)
         {
             chapter.AgeRating = dto.AgeRating;
+            chapter.KPlusOverrides.Remove(MetadataSettingField.AgeRating);
         }
 
         dto.Summary ??= string.Empty;
@@ -215,6 +217,7 @@ public class ChapterController : BaseApiController
         if (chapter.Summary != dto.Summary.Trim())
         {
             chapter.Summary = dto.Summary.Trim();
+            chapter.KPlusOverrides.Remove(MetadataSettingField.ChapterSummary);
         }
 
         if (chapter.Language != dto.Language)
@@ -230,11 +233,13 @@ public class ChapterController : BaseApiController
         if (chapter.TitleName != dto.TitleName)
         {
             chapter.TitleName = dto.TitleName;
+            chapter.KPlusOverrides.Remove(MetadataSettingField.ChapterTitle);
         }
 
         if (chapter.ReleaseDate != dto.ReleaseDate)
         {
             chapter.ReleaseDate = dto.ReleaseDate;
+            chapter.KPlusOverrides.Remove(MetadataSettingField.ChapterReleaseDate);
         }
 
         if (!string.IsNullOrEmpty(dto.ISBN) && ArticleNumberHelper.IsValidIsbn10(dto.ISBN) ||
@@ -333,6 +338,7 @@ public class ChapterController : BaseApiController
             _unitOfWork
         );
 
+        // TODO: If changes; remove ChapterPublisher from KPlusOverrides
         // Update publishers
         await PersonHelper.UpdateChapterPeopleAsync(
             chapter,

API/Controllers/SeriesController.cs

@@ -14,6 +14,7 @@ using API.DTOs.Recommendation;
 using API.DTOs.SeriesDetail;
 using API.Entities;
 using API.Entities.Enums;
+using API.Entities.MetadataMatching;
 using API.Extensions;
 using API.Helpers;
 using API.Services;
@@ -224,6 +225,7 @@ public class SeriesController : BaseApiController
             needsRefreshMetadata = true;
             series.CoverImage = null;
             series.CoverImageLocked = false;
+            series.Metadata.KPlusOverrides.Remove(MetadataSettingField.Covers);
             _logger.LogDebug("[SeriesCoverImageBug] Setting Series Cover Image to null: {SeriesId}", series.Id);
             series.ResetColorScape();
 

API/Controllers/UploadController.cs

@@ -6,6 +6,7 @@ using API.Data;
 using API.Data.Repositories;
 using API.DTOs.Uploads;
 using API.Entities.Enums;
+using API.Entities.MetadataMatching;
 using API.Extensions;
 using API.Services;
 using API.Services.Tasks.Metadata;
@@ -112,8 +113,10 @@ public class UploadController : BaseApiController
 
             series.CoverImage = filePath;
             series.CoverImageLocked = lockState;
+            series.Metadata.KPlusOverrides.Remove(MetadataSettingField.Covers);
             _imageService.UpdateColorScape(series);
             _unitOfWork.SeriesRepository.Update(series);
+            _unitOfWork.SeriesRepository.Update(series.Metadata);
 
             if (_unitOfWork.HasChanges())
             {
@@ -277,6 +280,7 @@ public class UploadController : BaseApiController
 
             chapter.CoverImage = filePath;
             chapter.CoverImageLocked = lockState;
+            chapter.KPlusOverrides.Remove(MetadataSettingField.ChapterCovers);
             _unitOfWork.ChapterRepository.Update(chapter);
             var volume = await _unitOfWork.VolumeRepository.GetVolumeAsync(chapter.VolumeId);
             if (volume != null)

API/Data/DataContext.cs

@@ -4,7 +4,6 @@ using System.Linq;
 using System.Text.Json;
 using System.Threading;
 using System.Threading.Tasks;
-using API.DTOs.KavitaPlus.Metadata;
 using API.Entities;
 using API.Entities.Enums;
 using API.Entities.Enums.UserPreferences;
@@ -18,7 +17,6 @@ using Microsoft.AspNetCore.Identity;
 using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.ChangeTracking;
-using Microsoft.EntityFrameworkCore.Diagnostics;
 
 namespace API.Data;
 
@@ -43,7 +41,7 @@ public sealed class DataContext : IdentityDbContext<AppUser, AppRole, int,
     public DbSet<ServerSetting> ServerSetting { get; set; } = null!;
     public DbSet<AppUserPreferences> AppUserPreferences { get; set; } = null!;
     public DbSet<SeriesMetadata> SeriesMetadata { get; set; } = null!;
-    [Obsolete]
+    [Obsolete("Use AppUserCollection")]
     public DbSet<CollectionTag> CollectionTag { get; set; } = null!;
     public DbSet<AppUserBookmark> AppUserBookmark { get; set; } = null!;
     public DbSet<ReadingList> ReadingList { get; set; } = null!;
@@ -72,7 +70,7 @@ public sealed class DataContext : IdentityDbContext<AppUser, AppRole, int,
     public DbSet<ExternalSeriesMetadata> ExternalSeriesMetadata { get; set; } = null!;
     public DbSet<ExternalRecommendation> ExternalRecommendation { get; set; } = null!;
     public DbSet<ManualMigrationHistory> ManualMigrationHistory { get; set; } = null!;
-    [Obsolete]
+    [Obsolete("Use IsBlacklisted field on Series")]
     public DbSet<SeriesBlacklist> SeriesBlacklist { get; set; } = null!;
     public DbSet<AppUserCollection> AppUserCollection { get; set; } = null!;
     public DbSet<ChapterPeople> ChapterPeople { get; set; } = null!;
@@ -286,6 +284,22 @@ public sealed class DataContext : IdentityDbContext<AppUser, AppRole, int,
                 v => JsonSerializer.Serialize(v, JsonSerializerOptions.Default),
                 v => JsonSerializer.Deserialize<List<int>>(v, JsonSerializerOptions.Default) ?? new List<int>())
             .HasColumnType("TEXT");
+
+        builder.Entity<SeriesMetadata>()
+            .Property(sm => sm.KPlusOverrides)
+            .HasConversion(
+                v => JsonSerializer.Serialize(v, JsonSerializerOptions.Default),
+                v => JsonSerializer.Deserialize<IList<MetadataSettingField>>(v, JsonSerializerOptions.Default) ??
+                     new List<MetadataSettingField>())
+            .HasColumnType("TEXT")
+            .HasDefaultValue(new List<MetadataSettingField>());
+        builder.Entity<Chapter>()
+            .Property(sm => sm.KPlusOverrides)
+            .HasConversion(
+                v => JsonSerializer.Serialize(v, JsonSerializerOptions.Default),
+                v => JsonSerializer.Deserialize<IList<MetadataSettingField>>(v, JsonSerializerOptions.Default) ?? new List<MetadataSettingField>())
+            .HasColumnType("TEXT")
+            .HasDefaultValue(new List<MetadataSettingField>());
     }
 
     #nullable enable

API/Data/Migrations/20250626162548_TrackKavitaPlusMetadata.cs

@@ -0,0 +1,40 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace API.Data.Migrations
+{
+    /// <inheritdoc />
+    public partial class TrackKavitaPlusMetadata : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "KPlusOverrides",
+                table: "SeriesMetadata",
+                type: "TEXT",
+                nullable: true,
+                defaultValue: "[]");
+
+            migrationBuilder.AddColumn<string>(
+                name: "KPlusOverrides",
+                table: "Chapter",
+                type: "TEXT",
+                nullable: true,
+                defaultValue: "[]");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "KPlusOverrides",
+                table: "SeriesMetadata");
+
+            migrationBuilder.DropColumn(
+                name: "KPlusOverrides",
+                table: "Chapter");
+        }
+    }
+}

API/Data/Migrations/DataContextModelSnapshot.cs

@@ -1,6 +1,8 @@
 // <auto-generated />
 using System;
+using System.Collections.Generic;
 using API.Data;
+using API.Entities.MetadataMatching;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
@@ -957,6 +959,11 @@ namespace API.Data.Migrations
                     b.Property<bool>("IsSpecial")
                         .HasColumnType("INTEGER");
 
+                    b.Property<string>("KPlusOverrides")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT")
+                        .HasDefaultValue("[]");
+
                     b.Property<string>("Language")
                         .HasColumnType("TEXT");
 
@@ -1683,6 +1690,11 @@ namespace API.Data.Migrations
                     b.Property<bool>("InkerLocked")
                         .HasColumnType("INTEGER");
 
+                    b.Property<string>("KPlusOverrides")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT")
+                        .HasDefaultValue("[]");
+
                     b.Property<string>("Language")
                         .HasColumnType("TEXT");
 

API/Data/Repositories/SeriesRepository.cs

@@ -82,6 +82,7 @@ public interface ISeriesRepository
     void Attach(Series series);
     void Attach(SeriesRelation relation);
     void Update(Series series);
+    void Update(SeriesMetadata seriesMetadata);
     void Remove(Series series);
     void Remove(IEnumerable<Series> series);
     void Detach(Series series);
@@ -219,6 +220,11 @@ public class SeriesRepository : ISeriesRepository
         _context.Entry(series).State = EntityState.Modified;
     }
 
+    public void Update(SeriesMetadata seriesMetadata)
+    {
+        _context.Entry(seriesMetadata).State = EntityState.Modified;
+    }
+
     public void Remove(Series series)
     {
         _context.Series.Remove(series);

API/Entities/Chapter.cs

@@ -4,13 +4,14 @@ using System.Globalization;
 using API.Entities.Enums;
 using API.Entities.Interfaces;
 using API.Entities.Metadata;
+using API.Entities.MetadataMatching;
 using API.Entities.Person;
 using API.Extensions;
 using API.Services.Tasks.Scanner.Parser;
 
 namespace API.Entities;
 
-public class Chapter : IEntityDate, IHasReadTimeEstimate, IHasCoverImage
+public class Chapter : IEntityDate, IHasReadTimeEstimate, IHasCoverImage, IHasKPlusMetadata
 {
     public int Id { get; set; }
     /// <summary>
@@ -125,6 +126,10 @@ public class Chapter : IEntityDate, IHasReadTimeEstimate, IHasCoverImage
     /// </summary>
     public string WebLinks { get; set; } = string.Empty;
     public string ISBN { get; set; } = string.Empty;
+    /// <summary>
+    /// Tracks which metadata has been set by K+
+    /// </summary>
+    public IList<MetadataSettingField> KPlusOverrides { get; set; }
 
     /// <summary>
     /// (Kavita+) Average rating from Kavita+ metadata

API/Entities/Interfaces/IHasKPlusMetadata.cs

@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+using API.Entities.MetadataMatching;
+
+namespace API.Entities.Interfaces;
+
+public interface IHasKPlusMetadata
+{
+    /// <summary>
+    /// Tracks which metadata has been set by K+
+    /// </summary>
+    public IList<MetadataSettingField> KPlusOverrides { get; set; }
+}

API/Entities/Metadata/SeriesMetadata.cs

@@ -4,13 +4,14 @@ using System.ComponentModel.DataAnnotations;
 using System.Linq;
 using API.Entities.Enums;
 using API.Entities.Interfaces;
+using API.Entities.MetadataMatching;
 using API.Entities.Person;
 using Microsoft.EntityFrameworkCore;
 
 namespace API.Entities.Metadata;
 
 [Index(nameof(Id), nameof(SeriesId), IsUnique = true)]
-public class SeriesMetadata : IHasConcurrencyToken
+public class SeriesMetadata : IHasConcurrencyToken, IHasKPlusMetadata
 {
     public int Id { get; set; }
 
@@ -42,6 +43,10 @@ public class SeriesMetadata : IHasConcurrencyToken
     /// </summary>
     /// <remarks>This is not populated from Chapters of the Series</remarks>
     public string WebLinks { get; set; } = string.Empty;
+    /// <summary>
+    /// Tracks which metadata has been set by K+
+    /// </summary>
+    public IList<MetadataSettingField> KPlusOverrides { get; set; }
 
     #region Locks
 

API/Extensions/IHasKPlusMetadataExtensions.cs

@@ -0,0 +1,21 @@
+using API.Entities.Interfaces;
+using API.Entities.MetadataMatching;
+
+namespace API.Extensions;
+
+public static class IHasKPlusMetadataExtensions
+{
+
+    public static bool HasSetKPlusMetadata(this IHasKPlusMetadata hasKPlusMetadata, MetadataSettingField field)
+    {
+        return hasKPlusMetadata.KPlusOverrides.Contains(field);
+    }
+
+    public static void AddKPlusOverride(this IHasKPlusMetadata hasKPlusMetadata, MetadataSettingField field)
+    {
+        if (hasKPlusMetadata.KPlusOverrides.Contains(field)) return;
+
+        hasKPlusMetadata.KPlusOverrides.Add(field);
+    }
+
+}

API/Services/Plus/ExternalMetadataService.cs

@@ -16,6 +16,7 @@ using API.DTOs.Scrobbling;
 using API.DTOs.SeriesDetail;
 using API.Entities;
 using API.Entities.Enums;
+using API.Entities.Interfaces;
 using API.Entities.Metadata;
 using API.Entities.MetadataMatching;
 using API.Entities.Person;
@@ -526,6 +527,7 @@ public class ExternalMetadataService : IExternalMetadataService
                     if (madeMetadataModification)
                     {
                         _unitOfWork.SeriesRepository.Update(series);
+                        _unitOfWork.SeriesRepository.Update(series.Metadata);
                     }
                 }
                 catch (Exception ex)
@@ -782,7 +784,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (externalCharacters == null || externalCharacters.Count == 0) return false;
 
-        if (series.Metadata.CharacterLocked && !settings.HasOverride(MetadataSettingField.People))
+        if (series.Metadata.CharacterLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.People))
         {
             return false;
         }
@@ -864,7 +866,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (upstreamArtists.Count == 0) return false;
 
-        if (series.Metadata.CoverArtistLocked && !settings.HasOverride(MetadataSettingField.People))
+        if (series.Metadata.CoverArtistLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.People))
         {
             return false;
         }
@@ -920,7 +922,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (upstreamWriters.Count == 0) return false;
 
-        if (series.Metadata.WriterLocked && !settings.HasOverride(MetadataSettingField.People))
+        if (series.Metadata.WriterLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.People))
         {
             return false;
         }
@@ -973,7 +975,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (!settings.EnableTags || processedTags.Count == 0) return false;
 
-        if (series.Metadata.TagsLocked && !settings.HasOverride(MetadataSettingField.Tags))
+        if (series.Metadata.TagsLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.Tags))
         {
             return false;
         }
@@ -1014,7 +1016,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (!settings.EnableGenres || processedGenres.Count == 0) return false;
 
-        if (series.Metadata.GenresLocked && !settings.HasOverride(MetadataSettingField.Genres))
+        if (series.Metadata.GenresLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.Genres))
         {
             return false;
         }
@@ -1044,7 +1046,7 @@ public class ExternalMetadataService : IExternalMetadataService
     {
         if (!settings.EnablePublicationStatus) return false;
 
-        if (series.Metadata.PublicationStatusLocked && !settings.HasOverride(MetadataSettingField.PublicationStatus))
+        if (series.Metadata.PublicationStatusLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.PublicationStatus))
         {
             return false;
         }
@@ -1058,6 +1060,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
             series.Metadata.PublicationStatus = status;
             series.Metadata.PublicationStatusLocked = true;
+            series.Metadata.AddKPlusOverride(MetadataSettingField.PublicationStatus);
             return true;
         }
         catch (Exception ex)
@@ -1071,7 +1074,7 @@ public class ExternalMetadataService : IExternalMetadataService
     private bool UpdateAgeRating(Series series, MetadataSettingsDto settings, IEnumerable<string> allExternalTags)
     {
 
-        if (series.Metadata.AgeRatingLocked && !settings.HasOverride(MetadataSettingField.AgeRating))
+        if (series.Metadata.AgeRatingLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.AgeRating))
         {
             return false;
         }
@@ -1087,6 +1090,7 @@ public class ExternalMetadataService : IExternalMetadataService
             if (series.Metadata.AgeRating <= ageRating)
             {
                 series.Metadata.AgeRating = ageRating;
+                series.Metadata.AddKPlusOverride(MetadataSettingField.AgeRating);
                 return true;
             }
         }
@@ -1127,6 +1131,7 @@ public class ExternalMetadataService : IExternalMetadataService
             madeModification = UpdateChapterTitle(chapter, settings, potentialMatch.Title, series.Name) || madeModification;
             madeModification = UpdateChapterSummary(chapter, settings, potentialMatch.Summary) || madeModification;
             madeModification = UpdateChapterReleaseDate(chapter, settings, potentialMatch.ReleaseDate) || madeModification;
+            // TODO: Update to set KPlusOverride
             madeModification = await UpdateChapterPublisher(chapter, settings, potentialMatch.Publisher) || madeModification;
 
             madeModification = await UpdateChapterPeople(chapter, settings, PersonRole.CoverArtist, potentialMatch.Artists) || madeModification;
@@ -1245,17 +1250,18 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(summary)) return false;
 
-        if (chapter.SummaryLocked && !settings.HasOverride(MetadataSettingField.ChapterSummary))
+        if (chapter.SummaryLocked && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterSummary))
         {
             return false;
         }
 
-        if (!string.IsNullOrWhiteSpace(summary) && !settings.HasOverride(MetadataSettingField.ChapterSummary))
+        if (!string.IsNullOrWhiteSpace(summary) && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterSummary))
         {
             return false;
         }
 
         chapter.Summary = StringHelper.RemoveSourceInDescription(StringHelper.SquashBreaklines(summary));
+        chapter.AddKPlusOverride(MetadataSettingField.ChapterSummary);
         return true;
     }
 
@@ -1265,17 +1271,18 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(title)) return false;
 
-        if (chapter.TitleNameLocked && !settings.HasOverride(MetadataSettingField.ChapterTitle))
+        if (chapter.TitleNameLocked && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterTitle))
         {
             return false;
         }
 
-        if (!title.Contains(seriesName) && !settings.HasOverride(MetadataSettingField.ChapterTitle))
+        if (!title.Contains(seriesName) && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterTitle))
         {
             return false;
         }
 
         chapter.TitleName = title;
+        chapter.AddKPlusOverride(MetadataSettingField.ChapterTitle);
         return true;
     }
 
@@ -1285,17 +1292,18 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (releaseDate == null || releaseDate == DateTime.MinValue) return false;
 
-        if (chapter.ReleaseDateLocked && !settings.HasOverride(MetadataSettingField.ChapterReleaseDate))
+        if (chapter.ReleaseDateLocked && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterReleaseDate))
         {
             return false;
         }
 
-        if (!settings.HasOverride(MetadataSettingField.ChapterReleaseDate))
+        if (!HasForceOverride(settings, chapter, MetadataSettingField.ChapterReleaseDate))
         {
             return false;
         }
 
         chapter.ReleaseDate = releaseDate.Value;
+        chapter.AddKPlusOverride(MetadataSettingField.ChapterReleaseDate);
         return true;
     }
 
@@ -1305,12 +1313,12 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(publisher)) return false;
 
-        if (chapter.PublisherLocked && !settings.HasOverride(MetadataSettingField.ChapterPublisher))
+        if (chapter.PublisherLocked && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterPublisher))
         {
             return false;
         }
 
-        if (!string.IsNullOrWhiteSpace(publisher) && !settings.HasOverride(MetadataSettingField.ChapterPublisher))
+        if (!string.IsNullOrWhiteSpace(publisher) && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterPublisher))
         {
             return false;
         }
@@ -1332,7 +1340,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(coverUrl)) return false;
 
-        if (chapter.CoverImageLocked && !settings.HasOverride(MetadataSettingField.ChapterCovers))
+        if (chapter.CoverImageLocked && !HasForceOverride(settings, chapter, MetadataSettingField.ChapterCovers))
         {
             return false;
         }
@@ -1343,6 +1351,7 @@ public class ExternalMetadataService : IExternalMetadataService
         }
 
         await DownloadChapterCovers(chapter, coverUrl);
+        chapter.AddKPlusOverride(MetadataSettingField.ChapterCovers);
         return true;
     }
 
@@ -1352,7 +1361,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (staff?.Count == 0) return false;
 
-        if (chapter.IsPersonRoleLocked(role) && !settings.HasOverride(MetadataSettingField.People))
+        if (chapter.IsPersonRoleLocked(role) && !HasForceOverride(settings, chapter, MetadataSettingField.People))
         {
             return false;
         }
@@ -1401,7 +1410,7 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(externalMetadata.CoverUrl)) return false;
 
-        if (series.CoverImageLocked && !settings.HasOverride(MetadataSettingField.Covers))
+        if (series.CoverImageLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.Covers))
         {
             return false;
         }
@@ -1412,6 +1421,7 @@ public class ExternalMetadataService : IExternalMetadataService
         }
 
         await DownloadSeriesCovers(series, externalMetadata.CoverUrl);
+        series.Metadata.AddKPlusOverride(MetadataSettingField.Covers);
         return true;
     }
 
@@ -1422,17 +1432,18 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (!externalMetadata.StartDate.HasValue) return false;
 
-        if (series.Metadata.ReleaseYearLocked && !settings.HasOverride(MetadataSettingField.StartDate))
+        if (series.Metadata.ReleaseYearLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.StartDate))
         {
             return false;
         }
 
-        if (series.Metadata.ReleaseYear != 0 && !settings.HasOverride(MetadataSettingField.StartDate))
+        if (series.Metadata.ReleaseYear != 0 && !HasForceOverride(settings, series.Metadata, MetadataSettingField.StartDate))
         {
             return false;
         }
 
         series.Metadata.ReleaseYear = externalMetadata.StartDate.Value.Year;
+        series.Metadata.AddKPlusOverride(MetadataSettingField.StartDate);
         return true;
     }
 
@@ -1440,12 +1451,12 @@ public class ExternalMetadataService : IExternalMetadataService
     {
         if (!settings.EnableLocalizedName) return false;
 
-        if (series.LocalizedNameLocked && !settings.HasOverride(MetadataSettingField.LocalizedName))
+        if (series.LocalizedNameLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.LocalizedName))
         {
             return false;
         }
 
-        if (!string.IsNullOrWhiteSpace(series.LocalizedName) && !settings.HasOverride(MetadataSettingField.LocalizedName))
+        if (!string.IsNullOrWhiteSpace(series.LocalizedName) && !HasForceOverride(settings, series.Metadata, MetadataSettingField.LocalizedName))
         {
             return false;
         }
@@ -1471,6 +1482,7 @@ public class ExternalMetadataService : IExternalMetadataService
         }
 
 
+        series.Metadata.AddKPlusOverride(MetadataSettingField.LocalizedName);
         return true;
     }
 
@@ -1480,17 +1492,18 @@ public class ExternalMetadataService : IExternalMetadataService
 
         if (string.IsNullOrEmpty(externalMetadata.Summary)) return false;
 
-        if (series.Metadata.SummaryLocked && !settings.HasOverride(MetadataSettingField.Summary))
+        if (series.Metadata.SummaryLocked && !HasForceOverride(settings, series.Metadata, MetadataSettingField.Summary))
         {
             return false;
         }
 
-        if (!string.IsNullOrWhiteSpace(series.Metadata.Summary) && !settings.HasOverride(MetadataSettingField.Summary))
+        if (!string.IsNullOrWhiteSpace(series.Metadata.Summary) && !HasForceOverride(settings, series.Metadata, MetadataSettingField.Summary))
         {
             return false;
         }
 
         series.Metadata.Summary = StringHelper.RemoveSourceInDescription(StringHelper.SquashBreaklines(externalMetadata.Summary));
+        series.Metadata.AddKPlusOverride(MetadataSettingField.Summary);
         return true;
     }
 
@@ -1509,7 +1522,8 @@ public class ExternalMetadataService : IExternalMetadataService
     {
         try
         {
-            await _coverDbService.SetSeriesCoverByUrl(series, coverUrl, false, true);
+            // Only choose a better image if we're overriding a user provided cover
+            await _coverDbService.SetSeriesCoverByUrl(series, coverUrl, false, !series.Metadata.HasSetKPlusMetadata(MetadataSettingField.Covers));
         }
         catch (Exception ex)
         {
@@ -1881,4 +1895,10 @@ public class ExternalMetadataService : IExternalMetadataService
 
         return null;
     }
+
+    private static bool HasForceOverride(MetadataSettingsDto settings, IHasKPlusMetadata kPlusMetadata,
+        MetadataSettingField field)
+    {
+        return settings.HasOverride(field) || kPlusMetadata.HasSetKPlusMetadata(field);
+    }
 }

API/Services/SeriesService.cs

@@ -11,7 +11,9 @@ using API.DTOs.Person;
 using API.DTOs.SeriesDetail;
 using API.Entities;
 using API.Entities.Enums;
+using API.Entities.Interfaces;
 using API.Entities.Metadata;
+using API.Entities.MetadataMatching;
 using API.Entities.Person;
 using API.Extensions;
 using API.Helpers;
@@ -120,23 +122,27 @@ public class SeriesService : ISeriesService
             {
                 series.Metadata.ReleaseYear = updateSeriesMetadataDto.SeriesMetadata.ReleaseYear;
                 series.Metadata.ReleaseYearLocked = true;
+                series.Metadata.KPlusOverrides.Remove(MetadataSettingField.StartDate);
             }
 
             if (series.Metadata.PublicationStatus != updateSeriesMetadataDto.SeriesMetadata.PublicationStatus)
             {
                 series.Metadata.PublicationStatus = updateSeriesMetadataDto.SeriesMetadata.PublicationStatus;
                 series.Metadata.PublicationStatusLocked = true;
+                series.Metadata.KPlusOverrides.Remove(MetadataSettingField.PublicationStatus);
             }
 
             if (string.IsNullOrEmpty(updateSeriesMetadataDto.SeriesMetadata.Summary))
             {
                 updateSeriesMetadataDto.SeriesMetadata.Summary = string.Empty;
+                series.Metadata.KPlusOverrides.Remove(MetadataSettingField.Summary);
             }
 
             if (series.Metadata.Summary != updateSeriesMetadataDto.SeriesMetadata.Summary.Trim())
             {
                 series.Metadata.Summary = updateSeriesMetadataDto.SeriesMetadata?.Summary.Trim() ?? string.Empty;
                 series.Metadata.SummaryLocked = true;
+                series.Metadata.KPlusOverrides.Remove(MetadataSettingField.Summary);
             }
 
             if (series.Metadata.Language != updateSeriesMetadataDto.SeriesMetadata?.Language)
@@ -195,6 +201,7 @@ public class SeriesService : ISeriesService
                 series.Metadata.AgeRating = updateSeriesMetadataDto.SeriesMetadata?.AgeRating ?? AgeRating.Unknown;
                 series.Metadata.AgeRatingLocked = true;
                 await _readingListService.UpdateReadingListAgeRatingForSeries(series.Id, series.Metadata.AgeRating);
+                series.Metadata.KPlusOverrides.Remove(MetadataSettingField.AgeRating);
             }
             else
             {
@@ -206,6 +213,7 @@ public class SeriesService : ISeriesService
                     if (updatedRating > series.Metadata.AgeRating)
                     {
                         series.Metadata.AgeRating = updatedRating;
+                        series.Metadata.KPlusOverrides.Remove(MetadataSettingField.AgeRating);
                     }
                 }
             }
@@ -319,6 +327,7 @@ public class SeriesService : ISeriesService
                 return true;
             }
 
+            _unitOfWork.SeriesRepository.Update(series.Metadata);
             await _unitOfWork.CommitAsync();
 
             // Trigger code to clean up tags, collections, people, etc