Nightly: deterministic plugin loading and docs refresh

docs/PLUGIN_DEVELOPMENT.md

@@ -6,6 +6,7 @@ Diese Doku beschreibt, wie Plugins im ViewIT‑Addon aufgebaut sind und wie neue
 - Jedes Plugin ist eine einzelne Datei unter `addon/plugins/`.
 - Dateinamen **ohne** `_`‑Prefix werden automatisch geladen.
 - Jede Datei enthält eine Klasse, die von `BasisPlugin` erbt.
+- Optional: `Plugin = <Klasse>` als expliziter Einstiegspunkt (bevorzugt vom Loader).
 
 ## Pflicht‑Methoden (BasisPlugin)
 Jedes Plugin muss diese Methoden implementieren:
@@ -22,6 +23,7 @@ Wesentliche Rückgaben an die Hauptlogik:
 - `episodes_for(...)` → Liste von Episoden-Labels
 - `stream_link_for(...)` → Hoster-/Player-Link (nicht zwingend finale Media-URL)
 - `resolve_stream_link(...)` → finale/spielbare URL nach Redirect/Resolver
+- `metadata_for(...)` → Info-Labels/Art (Plot/Poster) aus der Quelle
 - Optional `available_hosters_for(...)` → auswählbare Hoster-Namen im Dialog
 - Optional `series_url_for_title(...)` → stabile Detail-URL pro Titel für Folgeaufrufe
 - Optional `remember_series_url(...)` → Übernahme einer bereits bekannten Detail-URL
@@ -35,6 +37,9 @@ Standard für Film-Provider (ohne echte Staffeln):
 - `popular_series` → `popular_series()`
 - `genres` → `genres()` + `titles_for_genre(genre)`
 - `latest_episodes` → `latest_episodes(page=1)`
+- `new_titles` → `new_titles_page(page=1)`
+- `alpha` → `alpha_index()` + `titles_for_alpha_page(letter, page)`
+- `series_catalog` → `series_catalog_page(page=1)`
 
 ## Empfohlene Struktur
 - Konstanten für URLs/Endpoints (BASE_URL, Pfade, Templates)
@@ -60,6 +65,7 @@ Standard: `*_base_url` (Domain / BASE_URL)
   - `einschalten_base_url`
   - `topstream_base_url`
   - `filmpalast_base_url`
+  - `doku_streams_base_url`
 
 ## Playback
 - `stream_link_for(...)` implementieren (liefert bevorzugten Hoster-Link).
@@ -75,7 +81,8 @@ Standard: `*_base_url` (Domain / BASE_URL)
 2. **Navigation**: `series_url_for_title`/`remember_series_url` unterstützen, damit URLs zwischen Aufrufen stabil bleiben.
 3. **Auswahl Hoster**: Hoster-Namen aus der Detailseite extrahieren und anbieten.
 4. **Playback**: Hoster-Link liefern, danach konsistent über `resolve_stream_link` finalisieren.
-5. **Fallbacks**: bei Layout-Unterschieden defensiv parsen und Logging aktivierbar halten.
+5. **Metadaten**: `metadata_for` nutzen, Plot/Poster aus der Quelle zurückgeben.
+6. **Fallbacks**: bei Layout-Unterschieden defensiv parsen und Logging aktivierbar halten.
 
 ## Debugging
 Global gesteuert über Settings: