Files
tsumugu/docs/product/TSUMUGU_ENSO_ANIMATION_AUFTRAG.md
LarsandCursor 97bffc6175
Deploy Development / deploy (push) Successful in 25s
Test Suite / pytest-backend (push) Successful in 56s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 8s
Halte die gewaehlte Inhaltsliste beim Oeffnen und mache Typ sowie das Logo auf dunkler Flaeche aus der Lieferung erkennbar.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-17 15:50:05 +02:00

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.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 <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.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, 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.