# Portal Sync Flow

## Ziel

Der Styleguide bleibt in diesem Repository die Source of Truth. Das Portal holt:

- den deploy-relevanten CSS-Upstream versioniert als `public/assets/styleguide.upstream.css`
- die vollstaendige Styleguide-Dokumentation gespiegelt nach `docs/styleguide`

## Vorbereitung

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

## Sync ausfuehren

Beispiel:

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

Optional kann der Zielpfad ueberschrieben werden:

```bash
./scripts/sync_styleguide_to_webapp_aktienberater.sh \
  --portal-repo "/absoluter/pfad/zum/portalrepo" \
  --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/`)
- Optional: automatischer Commit + Push im Portalrepo

## Standardprozess je Release

1. Styleguide aendern
2. `VERSION` erhoehen
3. Styleguide commit + push
4. Sync-Skript ausfuehren
5. Portal Smoke-Test