Styleguide/docs/portal_sync_flow.md

Portal Sync Flow

Ziel

Der Styleguide bleibt in diesem Repository die Source of Truth. Der Sync verteilt den freigegebenen Stand in beide Portal-Repos:

• den deploy-relevanten CSS-Upstream versioniert als public/assets/styleguide.upstream.css
• die vollstaendige Styleguide-Dokumentation gespiegelt nach docs/styleguide
• die portal-spezifische Fertig-CSS-Datei als public/assets/styles.css

Zielrepos:

• WebApp_Aktienberater
• erp_naurua

Vorbereitung

• Version in VERSION erhoehen, sobald ein freigegebener Stand vorliegt.
• Aenderungen im Styleguide committen und pushen.

Sync ausfuehren

Beispiel:

./scripts/sync_styleguide_to_webapp_aktienberater.sh \
  --commit-portal

Ergebnis im Portalrepo

• public/assets/styleguide.upstream.css aktualisiert
• public/assets/styleguide.upstream.meta.json aktualisiert (Version, Commit, Zeitstempel)
• docs/styleguide gespiegelt (mit --delete, ohne .git, .codex, AGENTS.md, scripts/)
• public/assets/styles.css aktualisiert
• Optional: automatischer Commit + Push im Portalrepo

Standardprozess je Release

1. Styleguide aendern
2. VERSION erhoehen
3. Styleguide commit + push
4. Sync-Skript ausfuehren
5. Beide Portalrepos Smoke-Testen