erweitere MMS Downloader

projects.md

@@ -157,7 +157,8 @@ Jedes Projekt/Kontext besteht aus einem Link bzw Quell, einer Beschreibung, den
 - Quelle: `vr-bits/AssetDownloader` und Telekom DevOps GitLab.
 - Kontext: Unity- und .NET-Standard-Bibliothek zum Herunterladen, Zwischenspeichern und Vorbereiten von 3D-Assets für eine Production-Manual-Anwendung.
 - Herausforderungen: Robuste asynchrone Downloads großer Dateien mit Fortschrittsanzeige, Abbruch und Wiederaufnahme; überprüfbare Cache-Konsistenz; Trennung einer Unity-agnostischen Kernbibliothek von der Unity-Anbindung; Unterstützung mehrerer 3D-Dateiformate.
-- Lösungen: HTTP-Streaming mit temporären Dateien und Range-Requests für wiederaufnehmbare Downloads; konfigurierbare parallele Download-Jobs, Fortschritts- und Fehlerereignisse sowie Dateicache mit Prüfsummen und Metadaten; Formatprüfung für glTF, GLB, USD und USDZ sowie Unity-Wrapper; testgetriebene Entwicklung mit NUnit, Moq, HTTP-Mocks und Arrange-Act-Assert-Tests für Download, Cache, Abbruch, Integrität, Import und Resume; Konzeption und Anforderungserhebung für den universellen Downloader, detaillierte CacheManager-Spezifikation sowie tägliche Fortschritts- und Testdokumentation.
+- Lösungen: HTTP-Streaming mit temporären Dateien und Range-Requests für wiederaufnehmbare Downloads; konfigurierbare parallele Download-Jobs, Fortschritts- und Fehlerereignisse sowie ein URL-basierter Dateicache mit MD5-Prüfsumme und Laufzeitmetadaten; Formatprüfung für glTF, GLB, USD und USDZ sowie Unity-Wrapper; testgetriebene Entwicklung mit NUnit, Moq, HTTP-Mocks und Arrange-Act-Assert-Tests für Download, Cache, Abbruch, Integrität, Import und Resume; Konzeption und Anforderungserhebung für den universellen Downloader, detaillierte CacheManager-Spezifikation sowie tägliche Fortschritts- und Testdokumentation.
+- Schnittstellenkontext: Der begleitende Telekom-MMS-Ordner enthält die OpenAPI-3.1-Spezifikation des Asset Service (v1.0.14). Sie definiert OAuth2-geschützte Verwaltung von Assets, Revisionen und Labels sowie binäre Download-Endpunkte. Die Unity-Bibliothek ist bewusst als generischer URL-basierter Download-, Cache- und Importclient abgegrenzt; sie implementiert nicht die Verwaltungs-, Such- oder Upload-Endpunkte des Service.
 - Das projekt wurde durch mich mehr oder weniger komplett mittels KI erstellt unter der Maßgabe verlässlches TestDriven Design anzuwenden. Das hat sehr gut funktioniert.
 
 ## Telekom MMS AI Assist – Avatar-/Voice-Agent-Integration

roles.md

@@ -44,7 +44,7 @@ Enthält alle Rollen in denen ich schon Tätig war
     - Erstellung von 3D-Vista-Rundgängen für TransnetBW und TenneT mit 360-Grad-Medien, Interaktionspunkten, Karten, Audio, Untertiteln und Web-Veröffentlichung;
     - Technische Umsetzung und Qualitätssicherung von VRBits SpeakUp: ID-Eingabe, UI- und Gaze-Interaktionen, Avatar- und `TrainerAgent`-Bugfixes, sprachabhängige TTS-Integration, Lokalisierung, Audioeffekte sowie VR-Headset-Tests;
     - Entwicklung eines testgetriebenen Unity- und .NET-AssetDownloaders mit HTTP-Streaming, Cache und Formatprüfung für 3D-Assets;
-    - Anforderungserhebung, CacheManager-Spezifikation sowie Fortschritts- und Testdokumentation für den MMS AssetDownloader; Vollständige Umsetzung mittels TestDriven Design und KI only.
+    - Anforderungserhebung, CacheManager-Spezifikation sowie Fortschritts- und Testdokumentation für den MMS AssetDownloader; Analyse des OpenAPI-Vertrags des Telekom-Asset-Service und klare Abgrenzung zum URL-basierten Unity-Downloadclient; vollständige Umsetzung mittels TestDriven Design und KI only.
     - Entwicklung der Roche Prozessrallye mit persistenter Lernspiel-Logik, Minispielen, Budget- und Zeitmodell sowie Navigation zwischen Weltkarte und Innenräumen;
     - Entwicklung der TenneT-2GW-Platform als mehrsprachige, interaktive Web- und WebXR-Visualisierung auf Basis von Unity, Needle Engine, TypeScript und Three.js;
     - Entwicklung eines Unity-WebGL-Trainings für Roche mit VR-Builder-Prozessen, Workplan-Steuerung,

technologies.md

@@ -137,13 +137,19 @@ Jede Technologie wird einzeln genannt und enthält das Level der verwendeten Kom
 ### .NET Standard, HttpClient und HTTP Range Requests
 
 - Komplexität: Unity-agnostische Kernbibliothek für parallele, asynchrone Dateiübertragungen mit Fehler- und Zustandsbehandlung.
-- Einsatz: `HttpClient` mit Streaming in temporäre Dateien, Fortschrittsereignissen, Abbruch, Retry-fähiger Fehlerdarstellung und Range-Requests zur Wiederaufnahme unterbrochener Downloads; Warteschlange mit konfigurierbarer Parallelität.
-- Projekt: MM`MMS-AssetDownloader` August 2025.
+- Einsatz: `HttpClient` mit Streaming in temporäre Dateien, Fortschrittsereignissen, Abbruch, Retry-fähiger Fehlerdarstellung und Range-Requests zur Wiederaufnahme unterbrochener Downloads; Warteschlange mit konfigurierbarer Parallelität; Behandlung von `401`/`403` als Authentifizierungsfehlern, `404` als nicht gefundenem Asset sowie `429` und 5xx-Antworten als Netzwerkfehlern.
+- Projekt: MMS-AssetDownloader, August 2025.
+
+### OpenAPI 3.1, REST-Asset-Service und OAuth2
+
+- Komplexität: Einordnung eines Unity-Downloadclients in den Vertrag eines mandanten- und projektbezogenen Enterprise-Asset-Service.
+- Einsatz: Analyse der OpenAPI-3.1-Spezifikation „Asset Service API“ v1.0.14: Assetlisten mit Filterung, Suche und Paginierung; Metadaten mit Organisation, Projekt, Content-Type, Quelle, Sicherheitsstufe, Labels und frei definierbaren Attributen; Asset- und Revisionsverwaltung mit Multipart-Upload sowie binären Download-Endpunkten; Zugriff über OAuth2-Scopes für Lesen, Erstellen, Ändern und Löschen. Abgrenzung des eigenen Unity-Downloaders auf die URL-basierte Download-, Cache- und Importfunktion.
+- Projekt: MMS-AssetDownloader, Juli bis August 2025; API-Spezifikation im begleitenden Telekom-MMS-Ordner.
 
 ### glTF, GLB, USD und USDZ
 
 - Komplexität: Formatprüfung und Vorbereitung unterschiedlicher 3D-Assetformate für Unity.
-- Einsatz: Erkennung und grundlegende Validierung von glTF, GLB, USD, USDA, USDC und USDZ; Einbindung von glTFast und USD Importer in das Unity-Projekt.
+- Einsatz: Erkennung und grundlegende Validierung von glTF, GLB, USD, USDA, USDC und USDZ; Einbindung von glTFast und USD Importer in das Unity-Projekt. Der DownloadJob akzeptiert im dokumentierten Entwicklungsstand URL-Endungen für GLB und USDZ; die breitere Formatunterstützung liegt im Importer.
 - Projekt: MMS-AssetDownloader Juli bis August 2025.
 
 ### Drupal 8.7 und XML-Schnittstellen