Nightly: deterministic plugin loading and docs refresh

docs/PLUGIN_SYSTEM.md

@@ -17,6 +17,7 @@ Weitere Details:
 - `einschalten_plugin.py` – Einschalten
 - `aniworld_plugin.py` – Aniworld
 - `filmpalast_plugin.py` – Filmpalast
+- `dokustreams_plugin.py` – Doku-Streams
 - `_template_plugin.py` – Vorlage für neue Plugins
 
 ### Plugin-Discovery (Ladeprozess)
@@ -26,8 +27,9 @@ Der Loader in `addon/default.py`:
 1. Sucht alle `*.py` in `addon/plugins/`
 2. Überspringt Dateien, die mit `_` beginnen
 3. Lädt Module dynamisch
-4. Instanziert Klassen, die von `BasisPlugin` erben
-5. Ignoriert Plugins mit `is_available = False`
+4. Nutzt `Plugin = <Klasse>` als bevorzugten Einstiegspunkt (falls vorhanden)
+5. Fallback: instanziert Klassen, die von `BasisPlugin` erben (deterministisch sortiert)
+6. Ignoriert Plugins mit `is_available = False`
 
 Damit bleiben fehlerhafte Plugins isoliert und blockieren nicht das gesamte Add-on.
 
@@ -38,19 +40,29 @@ Definiert in `addon/plugin_interface.py`:
 - `async search_titles(query: str) -> list[str]`
 - `seasons_for(title: str) -> list[str]`
 - `episodes_for(title: str, season: str) -> list[str]`
+- optional `metadata_for(title: str) -> (info_labels, art, cast)`
 
 ### Optionale Features (Capabilities)
 
 Plugins können zusätzliche Features anbieten:
 
 - `capabilities() -> set[str]`
-  - `popular_series`: liefert beliebte Serien
-  - `genres`: Genre-Liste verfügbar
-  - `latest_episodes`: neue Episoden verfügbar
+- `popular_series`: liefert beliebte Serien
+- `genres`: Genre-Liste verfügbar
+- `latest_episodes`: neue Episoden verfügbar
+- `new_titles`: neue Titel verfügbar
+- `alpha`: A-Z Index verfügbar
+- `series_catalog`: Serienkatalog verfügbar
 - `popular_series() -> list[str]`
 - `genres() -> list[str]`
 - `titles_for_genre(genre: str) -> list[str]`
 - `latest_episodes(page: int = 1) -> list[LatestEpisode]` (wenn angeboten)
+- `new_titles_page(page: int = 1) -> list[str]` (wenn angeboten)
+- `alpha_index() -> list[str]` (wenn angeboten)
+- `series_catalog_page(page: int = 1) -> list[str]` (wenn angeboten)
+
+Metadaten:
+- `prefer_source_metadata = True` bedeutet: Plugin-Metadaten gehen vor TMDB, TMDB dient nur als Fallback.
 
 ViewIt zeigt im UI nur die Features an, die ein Plugin tatsächlich liefert.
 
@@ -62,6 +74,7 @@ Eine Integration sollte typischerweise bieten:
 - `search_titles()` mit Provider-Suche
 - `seasons_for()` und `episodes_for()` mit HTML-Parsing
 - `stream_link_for()` optional für direkte Playback-Links
+- `metadata_for()` optional für Plot/Poster aus der Quelle
 - Optional: `available_hosters_for()` oder Provider-spezifische Helfer
 
 Als Startpunkt dient `addon/plugins/_template_plugin.py`.
@@ -79,8 +92,9 @@ Als Startpunkt dient `addon/plugins/_template_plugin.py`.
 - Keine Netzwerkzugriffe im Import-Top-Level
 - Netzwerkzugriffe nur in Methoden (z. B. `search_titles`)
 - Fehler sauber abfangen und verständliche Fehlermeldungen liefern
-- Kein globaler Zustand, der across instances überrascht
+- Kein globaler Zustand, der über Instanzen hinweg überrascht
 - Provider-spezifische Parser in Helper-Funktionen kapseln
+- Reproduzierbare Reihenfolge: `Plugin`-Alias nutzen oder Klassenname eindeutig halten
 
 ### Debugging & Logs