Add blog series feature. New admin editing page, series selection when editing blog posts, and series display for readers.

Author: digitaldirk

src/LinkDotNet.Blog.Domain/BlogPost.cs

@@ -30,6 +30,8 @@ public sealed partial class BlogPost : Entity
 
     public int Likes { get; set; }
 
+    public int Order { get; set; }
+
     public bool IsScheduled => ScheduledPublishDate is not null;
 
     public string TagsAsString => string.Join(",", Tags);
@@ -40,6 +42,10 @@ public sealed partial class BlogPost : Entity
 
     public string? AuthorName { get; private set; }
 
+    public string? SeriesId { get; private set; }
+
+    public Series? Series { get; private set; }
+
     private string GenerateSlug()
     {
         if (string.IsNullOrWhiteSpace(Title))
@@ -95,7 +101,9 @@ public static BlogPost Create(
         DateTime? scheduledPublishDate = null,
         IEnumerable<string>? tags = null,
         string? previewImageUrlFallback = null,
-        string? authorName = null)
+        string? authorName = null,
+        string? seriesId = null,
+        int order = 0)
     {
         if (scheduledPublishDate is not null && isPublished)
         {
@@ -116,7 +124,9 @@ public static BlogPost Create(
             IsPublished = isPublished,
             Tags = tags?.Select(t => t.Trim()).ToImmutableArray() ?? [],
             ReadingTimeInMinutes = ReadingTimeCalculator.CalculateReadingTime(content),
-            AuthorName = authorName
+            AuthorName = authorName,
+            SeriesId = seriesId,
+            Order = order
         };
 
         return blogPost;
@@ -128,6 +138,22 @@ public void Publish()
         IsPublished = true;
     }
 
+    public void RemoveFromSeries()
+    {
+        SeriesId = null;
+        Series = null;
+        Order = 0;
+    }
+
+    public void AssignToSeries(string seriesId, int order)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(seriesId);
+
+        SeriesId = seriesId;
+        Series = null;
+        Order = order;
+    }
+
     public void Update(BlogPost from)
     {
         ArgumentNullException.ThrowIfNull(from);
@@ -148,5 +174,7 @@ public void Update(BlogPost from)
         Tags = from.Tags;
         ReadingTimeInMinutes = from.ReadingTimeInMinutes;
         AuthorName = from.AuthorName;
+        SeriesId = from.SeriesId;
+        Order = from.Order;
     }
 }

src/LinkDotNet.Blog.Domain/Series.cs

@@ -0,0 +1,8 @@
+using System;
+
+namespace LinkDotNet.Blog.Domain;
+
+public sealed class Series : Entity
+{
+    public string Name { get; set; } = default!;
+}

src/LinkDotNet.Blog.Infrastructure/Persistence/MongoDB/Repository.cs

@@ -40,7 +40,20 @@ public async ValueTask<HealthCheckResult> PerformHealthCheckAsync()
     {
         var filter = Builders<TEntity>.Filter.Eq(e => e.Id, id);
         using var result = await Collection.FindAsync(filter);
-        return await result.FirstOrDefaultAsync();
+        var entity = await result.FirstOrDefaultAsync();
+
+        if (entity is BlogPost { SeriesId: not null } blogPost)
+        {
+            var seriesCollection = database.GetCollection<Series>(nameof(Series));
+            var seriesFilter = Builders<Series>.Filter.Eq(s => s.Id, blogPost.SeriesId);
+            var seriesResult = await seriesCollection.FindAsync(seriesFilter);
+            var series = await seriesResult.FirstOrDefaultAsync();
+
+            var seriesProperty = typeof(BlogPost).GetProperty(nameof(BlogPost.Series));
+            seriesProperty?.SetValue(blogPost, series);
+        }
+
+        return entity;
     }
 
     public async ValueTask<IPagedList<TEntity>> GetAllAsync(Expression<Func<TEntity, bool>>? filter = null,
@@ -105,9 +118,9 @@ public async ValueTask StoreBulkAsync(IReadOnlyCollection<TEntity> records)
     {
         ArgumentNullException.ThrowIfNull(records);
 
-        if (records.Count != 0)
+        foreach (var record in records)
         {
-            await Collection.InsertManyAsync(records);
+            await StoreAsync(record);
         }
     }
 }

src/LinkDotNet.Blog.Infrastructure/Persistence/RavenDb/Repository.cs

@@ -36,7 +36,16 @@ public async ValueTask<HealthCheckResult> PerformHealthCheckAsync()
     public async ValueTask<TEntity?> GetByIdAsync(string id)
     {
         using var session = documentStore.OpenAsyncSession();
-        return await session.LoadAsync<TEntity>(id);
+        var entity = await session.LoadAsync<TEntity>(id);
+
+        if (entity is BlogPost { SeriesId: not null } blogPost)
+        {
+            var series = await session.LoadAsync<Series>(blogPost.SeriesId);
+            var seriesProperty = typeof(BlogPost).GetProperty(nameof(BlogPost.Series));
+            seriesProperty?.SetValue(blogPost, series);
+        }
+
+        return entity;
     }
 
     public ValueTask<IPagedList<TEntity>> GetAllAsync(Expression<Func<TEntity, bool>>? filter = null,

src/LinkDotNet.Blog.Infrastructure/Persistence/Sql/BlogDbContext.cs

@@ -15,6 +15,8 @@ public BlogDbContext(DbContextOptions options)
 
     public DbSet<BlogPost> BlogPosts { get; set; }
 
+    public DbSet<Series> Series { get; set; }
+
     public DbSet<ProfileInformationEntry> ProfileInformationEntries { get; set; }
 
     public DbSet<Skill> Skills { get; set; }
@@ -38,6 +40,7 @@ protected override void OnModelCreating(ModelBuilder modelBuilder)
         ArgumentNullException.ThrowIfNull(modelBuilder);
 
         modelBuilder.ApplyConfiguration(new BlogPostConfiguration());
+        modelBuilder.ApplyConfiguration(new SeriesConfiguration());
         modelBuilder.ApplyConfiguration(new BlogPostRecordConfiguration());
         modelBuilder.ApplyConfiguration(new BlogPostTemplateConfiguration());
         modelBuilder.ApplyConfiguration(new BlogPostVersionConfiguration());

src/LinkDotNet.Blog.Infrastructure/Persistence/Sql/Mapping/BlogPostConfiguration.cs

@@ -19,9 +19,16 @@ public void Configure(EntityTypeBuilder<BlogPost> builder)
         builder.Property(x => x.ShortDescription).IsRequired();
         builder.Property(x => x.Likes).IsRequired();
         builder.Property(x => x.IsPublished).IsRequired();
+        builder.Property(x => x.Order).IsRequired();
 
         builder.Property(x => x.Tags).HasMaxLength(2048);
         builder.Property(x => x.AuthorName).HasMaxLength(256).IsRequired(false);
+        builder.Property(x => x.SeriesId).IsUnicode(false).IsRequired(false);
+
+        builder.HasOne(x => x.Series)
+            .WithMany()
+            .HasForeignKey(x => x.SeriesId)
+            .OnDelete(DeleteBehavior.SetNull);
 
         builder.HasIndex(x => new { x.IsPublished, x.UpdatedDate })
             .HasDatabaseName("IX_BlogPosts_IsPublished_UpdatedDate")

src/LinkDotNet.Blog.Infrastructure/Persistence/Sql/Mapping/SeriesConfiguration.cs

@@ -0,0 +1,17 @@
+using LinkDotNet.Blog.Domain;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace LinkDotNet.Blog.Infrastructure.Persistence.Sql.Mapping;
+
+internal sealed class SeriesConfiguration : IEntityTypeConfiguration<Series>
+{
+    public void Configure(EntityTypeBuilder<Series> builder)
+    {
+        builder.HasKey(c => c.Id);
+        builder.Property(c => c.Id)
+            .IsUnicode(false)
+            .ValueGeneratedOnAdd();
+        builder.Property(x => x.Name).HasMaxLength(256).IsRequired();
+    }
+}

src/LinkDotNet.Blog.Infrastructure/Persistence/Sql/Repository.cs

@@ -39,7 +39,14 @@ public async ValueTask<HealthCheckResult> PerformHealthCheckAsync()
     public async ValueTask<TEntity?> GetByIdAsync(string id)
     {
         await using var blogDbContext = await dbContextFactory.CreateDbContextAsync();
-        return await blogDbContext.Set<TEntity>().FirstOrDefaultAsync(b => b.Id == id);
+        var query = blogDbContext.Set<TEntity>().AsQueryable();
+
+        if (typeof(TEntity) == typeof(BlogPost))
+        {
+            query = query.Include("Series");
+        }
+
+        return await query.FirstOrDefaultAsync(b => b.Id == id);
     }
 
     public ValueTask<IPagedList<TEntity>> GetAllAsync(Expression<Func<TEntity, bool>>? filter = null,
@@ -150,7 +157,15 @@ async Task StoreBulkAsyncInBatchesAsync()
             var count = 0;
             foreach (var record in records)
             {
-                await blogDbContext.Set<TEntity>().AddAsync(record);
+                if (string.IsNullOrEmpty(record.Id))
+                {
+                    await blogDbContext.Set<TEntity>().AddAsync(record);
+                }
+                else
+                {
+                    blogDbContext.Entry(record).State = EntityState.Modified;
+                }
+
                 if (++count % 1000 == 0)
                 {
                     LogBatch(count);