5.2 KiB
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. Öffne die GIF-Vorschau und die gelieferten Tsumugu-Bildebenen.
Übernimm 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.jsxexportiert derzeitMark, daslogo-original.pngzeigt. 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.jsxzeigt aktuell<Mark size={72} />. 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.jsxnutztMarkim 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 CallbackonIntroCompleteist 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
- Das Loginformular ist sofort bedienbar. Anmeldung, Betreiber-Bootstrap, Validierung, Fehlerbehandlung, Fokus und Navigation warten niemals auf die Animation oder ein Bildladeereignis.
- Eingaben oder Loginfehler lösen kein neues Intro aus. Die Animation verdeckt keine Felder oder Aktionen und fängt keine Klicks ab.
- 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.
prefers-reduced-motion: reducebedeutet ruhende Darstellung. Der Nutzer kann weiterhin erkennen, ob eine echte Anmeldung läuft, etwa am vorhandenen Buttontext undaria-busy.- 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.
- 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, 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.