System Architecture

animethemes-server/
├── app/                    # Application code
│   ├── Actions/           # Single-purpose action classes
│   ├── Concerns/          # Reusable traits
│   ├── Console/           # Artisan commands
│   ├── Constants/         # Configuration constants
│   ├── Contracts/         # Interfaces
│   ├── Discord/           # Discord integration
│   ├── Enums/             # Typed enumerations
│   ├── Events/            # Event classes
│   ├── Exceptions/        # Custom exceptions
│   ├── Features/          # Feature flags (Pennant)
│   ├── Filament/          # Admin panel resources
│   ├── GraphQL/           # GraphQL schemas & resolvers
│   ├── Http/              # HTTP layer
│   │   ├── Api/           # API controllers
│   │   ├── Middleware/    # HTTP middleware
│   │   └── Resources/     # API resources
│   ├── Jobs/              # Queue jobs
│   ├── Listeners/         # Event listeners
│   ├── Models/            # Eloquent models
│   │   ├── Admin/         # Admin models
│   │   ├── Auth/          # User models
│   │   ├── Document/      # Documentation models
│   │   ├── List/          # Playlist models
│   │   └── Wiki/          # Core wiki models
│   ├── Notifications/     # Notification classes
│   ├── Observers/         # Model observers
│   ├── Pivots/            # Pivot models
│   ├── Policies/          # Authorization policies
│   ├── Providers/         # Service providers
│   ├── Repositories/      # Data repositories
│   ├── Rules/             # Validation rules
│   ├── Scopes/            # Query scopes
│   ├── Scout/             # Search builders
│   └── Search/            # Search parsers
├── bootstrap/             # Framework bootstrap
├── config/                # Configuration files
├── database/              # Database files
│   ├── factories/         # Model factories
│   ├── migrations/        # Database migrations
│   └── seeders/           # Database seeders
├── elastic/               # Elasticsearch migrations
├── public/                # Public web root
├── resources/             # Views, assets
├── routes/                # Route definitions
│   ├── api.php           # REST API routes
│   ├── graphql.php       # GraphQL routes
│   ├── web.php           # Web routes
│   ├── video.php         # Video streaming
│   ├── audio.php         # Audio streaming
│   └── ...
├── storage/               # Application storage
├── tests/                 # Test suites
│   ├── Feature/          # Integration tests
│   └── Unit/             # Unit tests
└── vendor/                # Composer dependencies

// app/Models/Wiki/Video.php
class Video extends Model
{
    use HasFactory, SoftDeletes;
    
    protected $fillable = ['basename', 'filename', 'path', ...];
    
    public function animethemeentries(): BelongsToMany
    {
        return $this->belongsToMany(AnimeThemeEntry::class);
    }
}

// app/Http/Controllers/Api/Wiki/VideoController.php
class VideoController extends Controller
{
    public function show(Video $video): VideoJsonResource
    {
        return new VideoJsonResource($video, new Query());
    }
}

// app/Http/Resources/Wiki/Resource/VideoJsonResource.php
class VideoJsonResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            'id' => $this->id,
            'basename' => $this->basename,
            // ...
        ];
    }
}

// app/Repositories/
class VideoRepository
{
    public function findByBasename(string $basename): ?Video
    {
        return Video::where('basename', $basename)->first();
    }
}

// app/Actions/
class ProcessVideoUpload
{
    public function handle(UploadedFile $file): Video
    {
        // Video processing logic
    }
}

// app/Observers/VideoObserver.php
class VideoObserver
{
    public function creating(Video $video): void
    {
        // Set defaults before creation
    }
    
    public function forceDeleting(Video $video): void
    {
        // Clean up storage files
    }
}

// An anime has many themes
Anime → hasMany(AnimeTheme)

// A theme has many entries
AnimeTheme → hasMany(AnimeThemeEntry)

// Videos belong to many entries (pivot: AnimeThemeEntryVideo)
Video ↔ AnimeThemeEntry

// Artists perform many songs (pivot: ArtistSong)
Artist ↔ Song

// Artists can be members of groups (pivot: ArtistMember)
Artist ↔ Artist (self-referential)

// Images can belong to anime, artists, etc.
Image → morphTo(Imageable)

// External resources for various models
ExternalResource → morphTo(Resourceable)

/api/video                    # Video collection
/api/video/{video}            # Video resource
/api/anime                    # Anime collection
/api/anime/{anime}            # Anime resource
/api/anime/{anime}/theme      # Nested themes

# Migrate indices
php artisan elastic:migrate

# Import models
php artisan db:seed --class=ImportModelsSeeder

php artisan migrate              # Run migrations
php artisan migrate:rollback     # Rollback last batch
php artisan db:sync              # Custom sync command

enum VideoSource: int
{
    case WEB = 1;
    case RAW = 2;
    case BD = 3;
    case DVD = 4;
    
    public function localize(): string
    {
        return match($this) {
            self::BD => 'BD',
            self::DVD => 'DVD',
            default => '',
        };
    }
}

if (Feature::active('allow-video-streams')) {
    // Stream video
}