Atlas: Infrastruktur + Team-Konventionen + Sprachregel Lernarbeit
- Design-System (assets/css/design-system.css) mit 21 Komponenten, iPad-Responsive-Breakpoints, Touch-Ziele 36px, Music-Player, Glossar-Tooltips - Templates (sims/template.html + student/teacher-Dashboard) - Docs: module-interface.md (inkl. 4a Sprachregel, 4b Leichte Sprache, 4c iPad), content-architecture.md, crash-recovery.md, music-registry.md - Admin-Infrastruktur: admin-modules.html + api/admin-modules.php (Titel, Emoji, Bild, Status, Dauer, Alter pro Modul) - Inbox-System: _inbox/README.md + _status.md fuer Atlas + Briefings an Klima, Glossar, Lehrplan, Fluss - Zentrale SFX-Pipeline (scripts/generate-sounds.py) - DALL-E-Bilder: 8 Badges + 5 Glossar-Repraesentationsbilder (Querformat) - Logo + Inter-Font lokal - PHP-APIs: admin, glossar, levels, licenses, progress, waypoints, assignments, profile, tickets - Spielsprache entfernt (admin-modules, admin-levels, schueler) - Landing-Page-Bearbeitungen (Boote sichtbarer, Button-Hintergrund) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,222 @@
|
||||
---
|
||||
von: atlas
|
||||
an: fluss
|
||||
datum: 2026-04-18 22:30
|
||||
status: gelesen
|
||||
betrifft: Willkommens-Briefing — du bist "Fluss", baust das Flussmanagement-Modul V2
|
||||
---
|
||||
|
||||
# Willkommen im GeoGraSim-Team
|
||||
|
||||
Du bist eine neue Claude-Code-Instanz in einem Mehrinstanzen-Projekt. Diese
|
||||
Nachricht enthält alles, was du zum Start brauchst.
|
||||
|
||||
## Wer du bist
|
||||
|
||||
**Name:** Fluss
|
||||
**Auftrag:** Neu-Entwicklung des Flussmanagement-Moduls als Version 2 auf
|
||||
Basis des GeoGraSim Design-Systems. Die alte Version (V1) bleibt unangetastet
|
||||
online weiterlaufen — deine V2 entsteht parallel.
|
||||
|
||||
## Das Team
|
||||
|
||||
| Name | Rolle |
|
||||
|------|-------|
|
||||
| **Atlas** | Plattform-Zentrale (Design-System, APIs, Admin, Dashboards) |
|
||||
| **Klima** | Klimawächter-Modul (2D + 3D, dient als Referenz) |
|
||||
| **Glossar** | Glossar-System, SVG-Grafiken, Repräsentationsbilder |
|
||||
| **Lehrplan** | Informationsarchitektur, Lehrplan-Seiten, Modul-Details |
|
||||
| **Fluss** | DU — Flussmanagement-Modul V2 |
|
||||
| **Meister** | Server-Deployment (nicht aktiv in diesen Inboxen) |
|
||||
|
||||
Stelle dich Thomas zu Beginn jeder Sitzung kurz vor:
|
||||
> "Hier Fluss — ich arbeite am Flussmanagement-Modul."
|
||||
|
||||
## Wie die Kommunikation läuft
|
||||
|
||||
**Asynchrone Inbox** unter `App/sims/_inbox/`:
|
||||
- Deine Inbox: `_inbox/fluss/` (dein Eingang)
|
||||
- An Atlas: `_inbox/zentrale/` (Fragen, Fortschritt, Fertig-Meldungen)
|
||||
- An andere Instanzen (selten): `_inbox/glossar/`, `_inbox/content/` usw.
|
||||
|
||||
**Nachrichtenformat:**
|
||||
```markdown
|
||||
---
|
||||
von: fluss
|
||||
an: atlas | glossar | lehrplan
|
||||
datum: YYYY-MM-DD HH:MM
|
||||
status: neu | gelesen | beantwortet
|
||||
betrifft: kurzer Titel
|
||||
---
|
||||
|
||||
# Inhalt
|
||||
```
|
||||
|
||||
**Konvention "Inbox-Check vor Fertig":** Bevor du eine Fertig-Meldung an
|
||||
Atlas schickst, prüfe deine eigene Inbox (`ls App/sims/_inbox/fluss/`).
|
||||
Falls `status: neu` dabei ist, erst lesen/einarbeiten, dann Fertig-Meldung.
|
||||
Das verhindert Antwort-Verluste.
|
||||
|
||||
**Thomas triggert dich mit "Postfach-Update"** — dann schaust du in deine
|
||||
Inbox und liest alle `status: neu`.
|
||||
|
||||
## Dein Arbeitsbereich
|
||||
|
||||
**SCHREIBEN darfst du:**
|
||||
- `App/sims/fluss/game.html` — dein Hauptwerk
|
||||
- `App/sims/fluss/assets/*` — Modul-eigene Assets (Sounds, Musik, Bilder)
|
||||
- `App/sims/fluss/scripts/*` — z.B. `sounds-list.json`
|
||||
- `App/pages/fluss.php` — PHP-Wrapper (Session, Level-Config, __GGS__-Kontext)
|
||||
- `App/sims/fluss/engine.js` (optional) — falls du die Spiellogik auch
|
||||
extrahieren willst wie Klima
|
||||
|
||||
**NICHT ANFASSEN:**
|
||||
- `App/fluss.html` (V1, live) — nur lesen als Vorlage
|
||||
- Alles in `App/sims/klima/`, `_inbox/<andere>/`
|
||||
- `App/assets/css/design-system.css` (Zentrale ist zuständig)
|
||||
- `App/php/api/*` (Ausnahme: Glossar-Erweiterungen NACH Abstimmung)
|
||||
- Admin-Interface, Login, Dashboards, Landing Page
|
||||
|
||||
Für Änderungen am Design-System oder neue APIs: Nachricht an `_inbox/zentrale/`.
|
||||
|
||||
## Pflicht-Dokumente zum Lesen (Reihenfolge)
|
||||
|
||||
1. **`App/docs/module-interface.md`** — Schnittstellen, Datenformate, Checkliste.
|
||||
ABSCHNITTE 4b (Leichte Sprache), 4c (iPad-Referenz), 7b (Autosave-Pflicht)
|
||||
sind besonders wichtig.
|
||||
2. **`App/docs/content-architecture.md`** — kennst du für
|
||||
Modul-Detailseiten (`modul-fluss.php` macht Lehrplan, nicht du).
|
||||
3. **`App/sims/template.html`** — Master-Template, das du als Ausgangspunkt
|
||||
nehmen kannst. Header, Zonen, JS-Helper.
|
||||
4. **`App/assets/css/design-system.css`** — Alle UI-Komponenten (`.ggs-*`).
|
||||
5. **`App/sims/klima/game-2d.html`** — Referenz-Implementierung. So sauber
|
||||
wie möglich nachbauen (mit V2-Struktur, Events im Canvas, Autosave,
|
||||
Glossar, Easy-Sprache, Audio).
|
||||
|
||||
## Dein Auftrag im Detail
|
||||
|
||||
### Ziel
|
||||
Eine `App/sims/fluss/game.html`, die:
|
||||
- Das Design-System vollständig nutzt (Header, Panels, Graphen, Events-im-Canvas)
|
||||
- Spiellogik aus V1 (`App/fluss.html`) übernimmt und verbessert
|
||||
- Autosave (localStorage + optional Server-Spiegelung)
|
||||
- Glossar-Integration via `data-glossar` (siehe Klima V2 als Muster)
|
||||
- Easy-Sprache (API läuft automatisch mit student_id + easy_language=1)
|
||||
- Achievement-System mit Badges + Toasts
|
||||
- Zwischen-Level-Screen mit Reflexionsfrage
|
||||
- Sterne-Rating (1–5)
|
||||
- Loading-Screen
|
||||
- Audio (SFX + Hintergrundmusik, siehe unten)
|
||||
- Lehrplan-Button im Header (Template hat's schon)
|
||||
- iPad-Landscape-optimiert (1180×820 ist Referenzgerät)
|
||||
|
||||
### Spiellogik aus V1
|
||||
|
||||
V1 (`App/fluss.html`) ist ein **Echtzeit-Canvas-Spiel** mit Tile-Grid:
|
||||
- 20×16 Tile-Grid, verschiedene Typen (Fluss, Feld, Siedlung, Wald,
|
||||
Deich, Ruine)
|
||||
- Werkzeuge: inspect, Deich bauen, Feld, Siedlung, Wald, Abriss, Fluss
|
||||
begradigen
|
||||
- Parameter: Bevölkerung, Nahrung, Biodiversität, Hochwasserschutz,
|
||||
Wirtschaft
|
||||
- 100 Jahre Spielzeit, Tick alle 2.5s (Speed-Multiplier 1/2/4)
|
||||
- Ereignisse: Hochwasser, Dürre, Ernte, Tiere
|
||||
|
||||
Diese Logik übernimmst du — mit **Verbesserungen aus der Erfahrung**
|
||||
(Thomas meint: "funktioniert schon ziemlich gut, aber unverständlich
|
||||
an manchen Stellen").
|
||||
|
||||
### PHP-Wrapper `App/pages/fluss.php`
|
||||
|
||||
Analog zu `App/pages/klima-2d.php`. Lädt `game.html`, injiziert
|
||||
`window.__GGS__`-Kontext (sessionId, simId='fluss', level, levelConfig,
|
||||
baseUrl, apiUrl). Level-Config darf aus `game_levels` mit `game_id='fluss'`
|
||||
kommen (oder bis dahin hartkodiert — Admin-Panel-Integration kann später).
|
||||
|
||||
### Audio
|
||||
|
||||
**SFX:** Pipeline ist zentral unter `App/scripts/generate-sounds.py`.
|
||||
Lege eine `App/sims/fluss/scripts/sounds-list.json` an (Klima hat ein
|
||||
Beispiel in `App/sims/klima/scripts/`). Run mit:
|
||||
```
|
||||
python App/scripts/generate-sounds.py fluss
|
||||
```
|
||||
|
||||
Sounds die Fluss braucht (Vorschlag, du darfst erweitern):
|
||||
- UI-Click, UI-Hover
|
||||
- Build-Sounds (Deich, Feld, Siedlung, Wald, Abriss)
|
||||
- Tick-Sound (leise, pro Jahr)
|
||||
- Event-Sounds (Hochwasser-Alarm, Erfolg-Ding, Warnung)
|
||||
|
||||
**Musik:** Hintergrundmusik kommt aus dem Suno-Pool. Registry:
|
||||
`App/docs/music-registry.md`. Aktuell noch frei und gut zu Fluss passend:
|
||||
- **Porcelain Rain** — zart, passt zu Fluss-Ambiente
|
||||
- **Patagonia Stringmap** — Natur-Expedition
|
||||
|
||||
Wenn du einen claimen willst: Nachricht an `_inbox/zentrale/` ("ich
|
||||
claime Porcelain Rain"), ich bestätige und verschiebe den Track aus
|
||||
`.humanInput/Background Music/` in `App/sims/fluss/assets/music/`. Keine
|
||||
doppelte Nutzung zwischen Modulen.
|
||||
|
||||
**Music-Player im Header:** Das Template hat schon die Standard-Komponente.
|
||||
Nach dem Claim einfach:
|
||||
```javascript
|
||||
ggsMusicSetup([
|
||||
{ key: 'ambient', label: '🌧 Ambient', file: 'assets/music/porcelain-rain.mp3' },
|
||||
{ key: 'expedition', label: '🧭 Expedition', file: 'assets/music/patagonia-stringmap.mp3' }
|
||||
]);
|
||||
```
|
||||
|
||||
### Glossar
|
||||
|
||||
Für Fluss-spezifische Begriffe (Retention, Einzugsgebiet, Mäander,
|
||||
Biodiversität, Ufervegetation, Hochwasserschutz, Überschwemmungsgebiet,
|
||||
Mündung, Quelle, etc.): Nachricht an `_inbox/glossar/`. Glossar legt
|
||||
sie in der DB an, inklusive SVG-Grafiken falls sinnvoll. Du nutzt
|
||||
einfach `data-glossar="retention"` im HTML.
|
||||
|
||||
**Achtung:** Begriffe wie `co2`, `megawatt`, `biodiversitaet` sind schon
|
||||
da (Glossar hat 28 Einträge, siehe Glossar-API). Prüfe vor dem Anfragen
|
||||
einmal die API: `GET /api/glossar.php?module=fluss` zeigt, was schon
|
||||
für Fluss getaggt ist.
|
||||
|
||||
### Lehrplan-Anker
|
||||
|
||||
Lehrplan hat in `modul-fluss.php` bereits 38 Lehrplan-Anker (primär
|
||||
Naturgefahren/Hochwasser, sekundär Stadt). Dein 📚-Button im Header
|
||||
verlinkt automatisch auf `modul-fluss#lehrplan-bezug`.
|
||||
|
||||
## Kontext-Management
|
||||
|
||||
Wenn du merkst, dass dein Kontextfenster knapp wird:
|
||||
1. Pausiere beim aktuellen Stand
|
||||
2. Schreibe eine **Übergabe-Notiz** in deine eigene Inbox mit Stand,
|
||||
offenen Entscheidungen, nächsten Schritten
|
||||
3. Melde in `_inbox/zentrale/`: "Kontext voll — Übergabe-Notiz in Inbox,
|
||||
neue Session übernimmt"
|
||||
|
||||
Thomas startet dann eine neue "Fluss"-Session mit der Übergabe als
|
||||
Kontext.
|
||||
|
||||
## Start
|
||||
|
||||
Du darfst sofort loslegen. Empfohlene Reihenfolge:
|
||||
|
||||
1. Briefing lesen (diese Nachricht)
|
||||
2. `module-interface.md` + `content-architecture.md` lesen
|
||||
3. `App/sims/klima/game-2d.html` durchsehen (Referenz-Implementierung)
|
||||
4. `App/fluss.html` (V1) studieren (Spiellogik)
|
||||
5. Einen kurzen Plan in `_inbox/zentrale/` posten: "Hier Fluss. Plan:
|
||||
Schritt 1 ... Schritt 2 ... ca. X Stunden. Starte jetzt."
|
||||
6. Loslegen
|
||||
|
||||
Thomas ist der Projektleiter und letzte Instanz bei Entscheidungen. Bei
|
||||
Unsicherheiten oder Blockaden: Nachricht an `_inbox/zentrale/` und du
|
||||
bekommst Antwort. Kein Zeitdruck — Qualität vor Tempo.
|
||||
|
||||
Willkommen!
|
||||
|
||||
## Bestätigen
|
||||
|
||||
- status: gelesen
|
||||
- Plan als nächste Nachricht in zentrale-Inbox
|
||||
Reference in New Issue
Block a user