# GeoGraSim — Inbox Protokoll

Asynchroner Nachrichten-Austausch zwischen der **Zentrale** (Plattform-Instanz)
und den einzelnen **Modul-Instanzen**. Der Nutzer (Thomas) muss Nachrichten
nicht mehr manuell hin- und herkopieren.

## Ordnerstruktur

```
App/sims/_inbox/
├── README.md                ← Dieses Protokoll
├── zentrale/                ← Eingang für die Zentrale (Fragen/Feedback von Modulen)
│   └── YYYY-MM-DD-HHMM-<absender>-<stichwort>.md
├── klima/                   ← Eingang für die Klima-Instanz
├── fluss/                   ← Eingang für die Fluss-Instanz (spaeter)
├── heli/                    ← Eingang für die Heli-Instanz (spaeter)
└── stadt/                   ← Eingang für die Stadt-Instanz (spaeter)
```

## Dateiname-Konvention

`YYYY-MM-DD-HHMM-<stichwort>.md`

Beispiele:
- `2026-04-16-1830-spiellogik-aus-3d.md`
- `2026-04-16-1900-frage-zu-glossar.md`

Die alphabetische Sortierung ergibt automatisch die chronologische Reihenfolge.

## Nachrichten-Format

Jede Nachricht beginnt mit YAML-Frontmatter:

```markdown
---
von: zentrale | klima | fluss | heli | stadt
an: zentrale | klima | fluss | heli | stadt
datum: 2026-04-16 18:30
status: neu | gelesen | beantwortet
betrifft: kurze Themenbeschreibung
---

# Betreff

Nachrichtentext mit Details...
```

## Workflow

### Für Modul-Instanzen (z.B. Klima)

1. **Vor jedem groesseren Arbeitsschritt** den eigenen Eingang pruefen:
   ```
   ls App/sims/_inbox/klima/
   ```

2. **Neue Nachrichten** (status: neu) lesen, beruecksichtigen, dann Status auf
   `gelesen` setzen (Frontmatter editieren).

3. **Eigene Fragen oder Feedback** an die Zentrale als neue Datei in
   `App/sims/_inbox/zentrale/` anlegen:
   ```
   App/sims/_inbox/zentrale/2026-04-16-1845-klima-frage-glossar.md
   ```

### Für die Zentrale

1. **Vor jedem Turn mit dem Nutzer** den Eingang pruefen:
   ```
   ls App/sims/_inbox/zentrale/
   ```

2. Neue Nachrichten lesen, dem Nutzer erwaehnen, Status aktualisieren.

3. **Anweisungen oder Antworten** an Module in deren Eingangsordner ablegen.

## Wichtig

- **Keine Nachrichten loeschen** — sie bleiben als Audit-Trail.
- **Status ehrlich setzen** — so sieht die andere Seite sofort, was neu ist.
- **Kurze Nachrichten bevorzugen** — lieber mehrere kleine als eine riesige.
- **Bei dringenden Themen** den Nutzer explizit erwaehnen ("Bitte an Thomas
  weiterleiten: ...")