From cc2ccd1bf344ec38059164d1aa9b261e50807eac Mon Sep 17 00:00:00 2001
From: Shadowghost <Ghost_of_Stone@web.de>
Date: Sat, 17 Jan 2026 15:02:26 +0100
Subject: Add LinkedChildren database table for normalized relationships

Introduces a new database table to store linked child relationships for
boxsets, playlists, and video alternate versions. This replaces the
JSON-serialized Data column approach with a proper relational structure.

- Add LinkedChildEntity and LinkedChildType enum
- Add entity configuration with proper foreign keys
- Add EF Core migration for SQLite
---
 .../Entities/BaseItemEntity.cs                     | 10 ++++++
 .../Entities/LinkedChildEntity.cs                  | 39 ++++++++++++++++++++++
 .../Entities/LinkedChildType.cs                    | 27 +++++++++++++++
 3 files changed, 76 insertions(+)
 create mode 100644 src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildEntity.cs
 create mode 100644 src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildType.cs

(limited to 'src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities')

diff --git a/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/BaseItemEntity.cs b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/BaseItemEntity.cs
index d58466e5ca..73e6e338ec 100644
--- a/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/BaseItemEntity.cs
+++ b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/BaseItemEntity.cs
@@ -178,6 +178,16 @@ public class BaseItemEntity
 
     public ICollection<BaseItemImageInfo>? Images { get; set; }
 
+    /// <summary>
+    /// Gets or sets the linked children (for BoxSets, Playlists, etc.).
+    /// </summary>
+    public ICollection<LinkedChildEntity>? LinkedChildEntities { get; set; }
+
+    /// <summary>
+    /// Gets or sets the items this entity is linked to as a child.
+    /// </summary>
+    public ICollection<LinkedChildEntity>? LinkedChildOfEntities { get; set; }
+
     // those are references to __LOCAL__ ids not DB ids ... TODO: Bring the whole folder structure into the DB
     // public ICollection<BaseItemEntity>? SeriesEpisodes { get; set; }
     // public BaseItemEntity? Series { get; set; }
diff --git a/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildEntity.cs b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildEntity.cs
new file mode 100644
index 0000000000..7361775711
--- /dev/null
+++ b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildEntity.cs
@@ -0,0 +1,39 @@
+using System;
+
+namespace Jellyfin.Database.Implementations.Entities;
+
+/// <summary>
+/// Represents a linked child relationship between items (e.g., BoxSet to Movies, Playlist to tracks).
+/// </summary>
+public class LinkedChildEntity
+{
+    /// <summary>
+    /// Gets or sets the parent item ID (BoxSet, Playlist, etc.).
+    /// </summary>
+    public required Guid ParentId { get; set; }
+
+    /// <summary>
+    /// Gets or sets the child item ID.
+    /// </summary>
+    public required Guid ChildId { get; set; }
+
+    /// <summary>
+    /// Gets or sets the type of linked child (Manual or Shortcut).
+    /// </summary>
+    public required LinkedChildType ChildType { get; set; }
+
+    /// <summary>
+    /// Gets or sets the sort order.
+    /// </summary>
+    public int? SortOrder { get; set; }
+
+    /// <summary>
+    /// Gets or sets the parent item navigation property.
+    /// </summary>
+    public BaseItemEntity? Parent { get; set; }
+
+    /// <summary>
+    /// Gets or sets the child item navigation property.
+    /// </summary>
+    public BaseItemEntity? Child { get; set; }
+}
diff --git a/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildType.cs b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildType.cs
new file mode 100644
index 0000000000..09b4b84aba
--- /dev/null
+++ b/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/LinkedChildType.cs
@@ -0,0 +1,27 @@
+namespace Jellyfin.Database.Implementations.Entities;
+
+/// <summary>
+/// The linked child type.
+/// </summary>
+public enum LinkedChildType
+{
+    /// <summary>
+    /// Manually linked child.
+    /// </summary>
+    Manual = 0,
+
+    /// <summary>
+    /// Shortcut linked child.
+    /// </summary>
+    Shortcut = 1,
+
+    /// <summary>
+    /// Local alternate version (same item, different file path).
+    /// </summary>
+    LocalAlternateVersion = 2,
+
+    /// <summary>
+    /// Linked alternate version (different item ID).
+    /// </summary>
+    LinkedAlternateVersion = 3
+}
-- 
cgit v1.2.3