# Shared Assets — Pool

Gemeinsame Ressourcen, die mehrere V2-Module nutzen können. Atlas
pflegt diesen Pool, Modul-Instanzen verlinken via URL — kein eigenes
Generieren in den Modulen, keine Duplikate.

## Zweck

Vermeidet, dass jedes Modul, das Wien zeigt, sein eigenes Wien-Bild
generiert. Stilkonsistenz garantiert, Lizenzen zentral nachvollziehbar,
DALL-E/ElevenLabs-Kosten bleiben unter Kontrolle.

## Struktur

```
shared/
├── cities/      ← Stadt-Bilder (Wien, Berlin, Innsbruck, Linz, …)
├── icons/       ← UI-Icons (sound-on, sound-off, pause, ✓, ✗, …)
├── glossar/     ← Glossar-Bilder (160 aus V1 übernommen)
├── bg-music/    ← Suno-Hintergrundmusik-Pool
└── ui-sounds/   ← UI-Feedback-Töne (Klick, Erfolg, Fehler) — Phase 2
```

## Wie ein Modul ein Shared-Asset nutzt

1. Manifest deklariert die Abhängigkeit:
   ```json
   "sharedAssets": {
     "cities": ["wien", "innsbruck"],
     "bg-music": ["fjord-calm"]
   }
   ```
2. Im Modul-Code wird die URL gebaut:
   ```
   /v2beta/assets/shared/cities/wien.png
   ```
3. Konformitäts-Check prüft beim Lieferung-Empfang: existiert das Asset im Pool?

## Wenn ein Asset noch nicht da ist

Modul-Instanz pingt Atlas in `_inbox/zentrale/`:

```
Brauche 'linz' im Stadtbild-Pool. Stilbild Flat Scandinavian
(Standard-Prompt). Verwendung: Logistik-V2 Welle-4-Auftragsziel.
```

Atlas generiert lokal mit DALL-E (siehe `tools/asset-gen/image.php`),
committet ins Pool, antwortet mit URL + Lizenzinfo.

## Asset-Provenienz

Jeder Pool-Unterordner hat ein `PROVENIENZ.md`-File mit Auflistung:
welches Asset wann von wo (DALL-E Prompt / Lizenzquelle / Suno-Track-
ID), wer es bestellt hat, welche Module es nutzen.

## Was NICHT hier rein gehört

- **Modul-spezifische Assets** (z.B. Logistik-Auftragsbild) — bleiben in
  `v2-modules/<slug>/public/assets/`
- **Avatare** — separate Top-Level-Sektion `v2-platform/assets/avatars/`
- **Schüler-Uploads** — `v2-platform/uploads/<slug>/student-<id>/`
- **`.humanInput/`-Originale** — Thomas' persönliches Rohstoff-Lager,
  nicht im Repository deploybar