Skip to content

A self-hosted media server and file management system

feat: basic folder relation backend

aminnausin15d1f32df05a
diff --git a/app/Enums/SeriesRelationType.php b/app/Enums/SeriesRelationType.php
new file mode 100644
index 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.php
index 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.php
index 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.php
index 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.php
index 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 content
protected 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.php
new file mode 100644
index 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');
+ }
+};