A self-hosted media server and file management system
Vue ffmpegfile-serverjellyfinlaravelmediamedia-playermedia-servermediabrowsermediaservermusicmusic-librarymusic-playermusicplayerself-hostedvuejs
feat: basic folder relation backend
aminnausin15d1f32df05a
diff --git a/app/Enums/SeriesRelationType.php b/app/Enums/SeriesRelationType.phpnew file mode 100644index 00000000..55b2344c--- /dev/null+++ b/app/Enums/SeriesRelationType.php@@ -0,0 +1,43 @@+<?php++namespace App\Enums;++enum SeriesRelationType: string {+ case SEQUEL = 'sequel';+ case PREQUEL = 'prequel';+ case SPINOFF = 'spinoff';+ case SIDE_STORY = 'side_story';+ case ALTERNATIVE = 'alternative';+ case SUMMARY = 'summary';+ case RELATED = 'related';+ case PARENT = 'parent';+ case SOUNDTRACK = 'soundtrack';++ public function inverse(): ?self {+ return match ($this) {+ self::SEQUEL => self::PREQUEL,+ self::PREQUEL => self::SEQUEL,+ self::SPINOFF => self::PARENT,+ self::SIDE_STORY => self::PARENT,+ self::SUMMARY => self::PARENT,+ self::SOUNDTRACK => self::PARENT,+ self::PARENT => null,+ self::ALTERNATIVE, self::RELATED => $this,+ };+ }++ public function isStorable(): bool {+ return match ($this) {+ self::PREQUEL, self::PARENT => false,+ default => true,+ };+ }++ public function label(): string {+ return match ($this) {+ self::SPINOFF => 'Spin Off',+ self::SIDE_STORY => 'Side Story',+ default => ucfirst($this->value),+ };+ }+}diff --git a/app/Http/Controllers/Api/V1/FolderController.php b/app/Http/Controllers/Api/V1/FolderController.phpindex 0d91387a..405bb255 100755--- a/app/Http/Controllers/Api/V1/FolderController.php+++ b/app/Http/Controllers/Api/V1/FolderController.php@@ -68,6 +68,11 @@ class FolderController extends Controller {'videos.metadata.fonts' => function ($q) {$q->select(Font::getVisibleFields());},++ 'series.directRelations.folder',+ 'series.directRelations.primaryPoster',+ 'series.inverseRelations.folder',+ 'series.inverseRelations.primaryPoster',]);return response()->json(new FolderResource($folder));diff --git a/app/Http/Controllers/DirectoryController.php b/app/Http/Controllers/DirectoryController.phpindex b2461c94..3ecc0448 100755--- a/app/Http/Controllers/DirectoryController.php+++ b/app/Http/Controllers/DirectoryController.php@@ -100,6 +100,10 @@ class DirectoryController extends Controller {'series.primaryPoster','series.primaryBanner','series.images.user',+ 'series.directRelations.folder',+ 'series.directRelations.primaryPoster',+ 'series.inverseRelations.folder',+ 'series.inverseRelations.primaryPoster',])->where('category_id', $categoryId)->orderBy('name')diff --git a/app/Http/Resources/SeriesResource.php b/app/Http/Resources/SeriesResource.phpindex e9e383de..f9fec166 100644--- a/app/Http/Resources/SeriesResource.php+++ b/app/Http/Resources/SeriesResource.php@@ -17,7 +17,7 @@ class SeriesResource extends JsonResource {'uuid' => $this->uuid,'folder_id' => $this->folder_id,'editor_id' => $this->editor_id,- 'title' => $this->title ?? $this->folder->name,+ 'title' => $this->title ?? $this->folder?->name,'description' => $this->description,'studio' => $this->studio,'rating' => $this->rating,@@ -38,6 +38,30 @@ class SeriesResource extends JsonResource {'banner_image' => $this->whenLoaded('primaryBanner', fn () => $this->primaryBanner ? new ImageResource($this->primaryBanner) : null),'primary_banner_id' => $this->primary_banner_id,'images' => $this->whenLoaded('images', fn () => ImageResource::collection($this->images), []),++ 'related_series' => $this->when(+ $this->relationLoaded('directRelations') && $this->relationLoaded('inverseRelations'),+ fn () => $this->relatedSeriesPayload(),+ [],+ ),];}++ private function relatedSeriesPayload(): array {+ // should not lazy load+ return $this->allRelations()+ ->filter(fn ($r) => $r['series']->folder)+ ->map(function ($r) {+ $series = $r['series'];+ $series->folder->setRelation('series', $series);++ return [+ 'type' => $r['type']->value,+ 'label' => $r['type']->label(),+ 'folder' => new FolderResource($series->folder),+ ];+ })+ ->values()+ ->all();+ }}diff --git a/app/Models/Series.php b/app/Models/Series.phpindex 7037cf0a..f6a14228 100644--- a/app/Models/Series.php+++ b/app/Models/Series.php@@ -4,12 +4,15 @@ namespace App\Models;use App\Enums\ImageType;use App\Enums\MediaType;+use App\Enums\SeriesRelationType;use App\Traits\HasEditableFields;use Illuminate\Database\Eloquent\Factories\HasFactory;use Illuminate\Database\Eloquent\Model;use Illuminate\Database\Eloquent\Relations\BelongsTo;+use Illuminate\Database\Eloquent\Relations\BelongsToMany;use Illuminate\Database\Eloquent\Relations\HasMany;use Illuminate\Database\Eloquent\Relations\MorphMany;+use Illuminate\Support\Collection;class Series extends Model {use HasEditableFields, HasFactory;@@ -132,6 +135,31 @@ class Series extends Model {return $this->belongsTo(Image::class, 'primary_banner_id', 'id');}+ public function directRelations(): BelongsToMany {+ return $this->belongsToMany(Series::class, 'series_relations', 'series_id', 'related_series_id')->withPivot('type')->withTimestamps();+ }++ public function inverseRelations(): BelongsToMany {+ return $this->belongsToMany(Series::class, 'series_relations', 'related_series_id', 'series_id')->withPivot('type');+ }++ public function allRelations(): Collection {+ $this->loadMissing(['directRelations', 'inverseRelations']);++ $direct = $this->directRelations->map(fn (Series $s) => [+ 'series' => $s,+ 'type' => SeriesRelationType::tryFrom($s->pivot->type),+ ]);++ $inverse = $this->inverseRelations->map(fn (Series $s) => [+ 'series' => $s,+ 'type' => SeriesRelationType::tryFrom($s->pivot->type)?->inverse(),+ ]);++ // should sort this by type or something+ return $direct->concat($inverse)->filter(fn ($r) => $r['type'] !== null)->values();+ }+// This is only for demo reset so it is not super important, only include fields that may have bad contentprotected function getEditableFields(): array {return [diff --git a/database/migrations/2026_10_07_004541_create_series_relations_table.php b/database/migrations/2026_10_07_004541_create_series_relations_table.phpnew file mode 100644index 00000000..2f247d60--- /dev/null+++ b/database/migrations/2026_10_07_004541_create_series_relations_table.php@@ -0,0 +1,33 @@+<?php++use Illuminate\Database\Migrations\Migration;+use Illuminate\Database\Schema\Blueprint;+use Illuminate\Support\Facades\DB;+use Illuminate\Support\Facades\Schema;++return new class extends Migration {+ /**+ * Run the migrations.+ */+ public function up(): void {+ Schema::create('series_relations', function (Blueprint $table) {+ $table->foreignId('series_id')->constrained()->cascadeOnDelete();+ $table->foreignId('related_series_id')->constrained('series')->cascadeOnDelete();+ $table->string('type'); // only storable types from SeriesRelationType+ $table->timestampsTz();++ $table->primary(['series_id', 'related_series_id']);+ $table->index('related_series_id');+ });++ DB::statement('ALTER TABLE series_relations ADD CONSTRAINT series_relations_no_self CHECK (series_id <> related_series_id)');+ DB::statement('CREATE UNIQUE INDEX series_relations_pair_unique ON series_relations (LEAST(series_id, related_series_id), GREATEST(series_id, related_series_id))');+ }++ /**+ * Reverse the migrations.+ */+ public function down(): void {+ Schema::dropIfExists('series_relations');+ }+};