# Cursor-Auftrag: Gelieferte Ensō-Animation integrieren **Stand:** 17.10.2026 · **Ziel:** Die fertige, aus den ausgewählten Originalmotiven abgeleitete Animation in den bestehenden Tsumugu-Login und App-Kopf einbinden. Auftrag zum Implementieren und Prüfen; keine neue Logo- oder Designrunde. ## Fertige Lieferung verwenden Lies zuerst [README und Einbindungsvertrag](C:/Dev/jinkendo-app-design-2026-10-17/assets/enso-motion-v1/README.md). Öffne die [GIF-Vorschau](C:/Dev/jinkendo-app-design-2026-10-17/assets/enso-motion-v1/tsumugu/preview-loop.gif) und die gelieferten Tsumugu-Bildebenen. Übernimm [JinkendoMark.jsx](C:/Dev/jinkendo-app-design-2026-10-17/assets/enso-motion-v1/JinkendoMark.jsx), die angrenzende CSS-Datei und die Tsumugu-Layer/Poster-Dateien in die vorhandene Frontend-Struktur. Der Standard-Asset-Pfad der Komponente ist `/brand/enso-motion-v1/tsumugu/`. Die Dateien sind fertig, nicht aus dem Logo erneut generieren, keine neuen SVG-Pfade oder Ringformen zeichnen. Die mitgelieferten SVGs sind Rastercontainer; für die steuerbare App-Einbindung die React-Komponente verwenden. ## Im aktuellen Bestand gezielt anpassen - `frontend/src/pages/icons.jsx` exportiert derzeit `Mark`, das `logo-original.png` zeigt. Diesen Einstieg als schmalen Adapter auf die gelieferte Komponente weiterverwenden oder passend auflösen; keine unabhängigen Funktionsicons verändern. Für allgemeine Mark-Verwendungen ist der Modus standardmäßig ruhend. - `frontend/src/pages/Login.jsx` zeigt aktuell ``. Dort die einmalige Intro-Animation einbinden, ungefähr 96px als Ausgangspunkt; auf schmalen Ansichten Platz und vorhandene Formularfelder erhalten. Die Rotation dauert 2,4 Sekunden, ausschließlich der Ring bewegt sich. - `frontend/src/pages/Shell.jsx` nutzt `Mark` im Desktop-Kopf und nochmals in der mobilen Darstellung. Beim ersten App-Einstieg darf das sichtbare Zeichen einmal animieren. Einen gemeinsamen verbrauchten Intro-Zustand für beide Darstellungen verwenden; der Callback `onIntroComplete` ist vorgesehen. Kein Neustart beim normalen Routenwechsel, Ein-/Ausklappen, Tippen oder bloßen Breitenwechsel. Keine Routen-Keys zur erneuten Montage einsetzen. - Eine fortlaufende Rotation ist als `motion="busy"` vorhanden. Nur bei einem echten laufenden Vorgang verwenden; kein dekorativer Dauerbetrieb. Die tatsächliche Pending-Phase steuert den Modus. Bei Erfolg/Fehler wieder ruhend. Vorhandene Lade-/Fehlertexte bleiben verständlich; eine Frist oder ein fachlicher Status wird durch die Markenanimation nicht verändert. ## Verhalten und Schutz der bestehenden Abläufe 1. Das Loginformular ist sofort bedienbar. Anmeldung, Betreiber-Bootstrap, Validierung, Fehlerbehandlung, Fokus und Navigation warten niemals auf die Animation oder ein Bildladeereignis. 2. Eingaben oder Loginfehler lösen kein neues Intro aus. Die Animation verdeckt keine Felder oder Aktionen und fängt keine Klicks ab. 3. Das Innenmotiv steht fest. Der Ring endet in der ursprünglichen Stellung. Der Hintergrund und die Form stammen aus der gelieferten Animation; keine zusätzlichen Symbole hinzufügen. 4. `prefers-reduced-motion: reduce` bedeutet ruhende Darstellung. Der Nutzer kann weiterhin erkennen, ob eine echte Anmeldung läuft, etwa am vorhandenen Buttontext und `aria-busy`. 5. Im verborgenen Dokument wird die React-Animation pausiert. Wenn Bildebenen fehlen oder nicht laden, steht der gelieferte Poster-Fallback bereit. Der Geschäftsablauf darf trotzdem funktionieren. 6. Favicons bleiben die statischen Innenmotive aus `favicons-v2`. Die Animation nicht als Favicon verwenden. Bestehende App-/Launcher-Icons werden durch diesen Auftrag nicht verändert. ## Prüfung vor Abschluss - Login bei Desktop- und Handybreite: Intro einmal, Motiv fest, korrekte Endstellung, Eingaben währenddessen möglich. Echte Loginanfrage nicht künstlich verzögern. - App-Kopf in beiden Anordnungen: erster Einstieg und anschließende Routen-/Breitenwechsel; keine wiederholte Markenanimation bei alltäglicher Navigation. - Reale Betriebssystem-/Browserpräferenz für reduzierte Bewegung prüfen. Ruhendes Verhalten nachweisen, nicht nur die zugehörige CSS-Zeile zitieren. - Wenn Busy eingebunden wird, tatsächliche Pending-, Erfolgs- und Fehlerphase prüfen. Keine Simulation eines dauerhaft beschäftigten Systems. - Fehlende Layer, langsames Laden, erneutes Rendern, Hintergrund-Tab und Rückkehr prüfen; keine neue Leerstelle oder verlorene Formulareingabe. - Relevante vorhandene Frontendchecks/Build ausführen. Screenshots für Login und App-Kopf sowie eine kurze Bildschirmaufnahme der Rotation liefern. Tatsächlich geprüfte Fälle und Grenzen benennen. Der Asset-Build und Einzelbildprüfungen sind bereits bestanden. Die lokale Codex-Browserprüfung der Demo scheiterte an der Erreichbarkeit der Loopback-Vorschau. Die Einbindung in die echte laufende App einschließlich Reduced Motion ist daher ausdrücklich noch nachzuweisen. Beachte [AGENTS.md](../../AGENTS.md), vorhandene Architektur-/Release-Regeln und laufende fremde Änderungen. Nutze den vorgesehenen Development-Weg; kein Production-Release und kein Umbau anderer Jinkendo-Repositories. Liefere die integrierte und geprüfte Änderung, keine erneute Spezifikation.