
### 🧁 crumbforest\_terminal\_final\_setup.md

**Stand: 2025-06-06**
**Status: STABIL – alle Ports online**
**Build: Docker + SSH + Blockly + TTYD + CakePHP5**

---

#### 🌍 Netzwerk & Dienste

| Dienst              | Port                         | Status     |
| ------------------- | ---------------------------- | ---------- |
| Apache (CakePHP)    | 8080                         | ✅ aktiv    |
| TTYD (Terminal Web) | 7780                         | ✅ aktiv    |
| SSH Zugang (robot)  | 2222                         | ✅ aktiv    |
| Blockly Bridge      | `/crumbapi/blockly-terminal` | ✅ JSON API |

---

#### 🔐 Login & Auth

* SSH Login:

  ```bash
  ssh robot@localhost -p 2222
  Passwort: kuchenpwd
  ```
* Achtung: Nach Rebuild wird ein neuer SSH-Host-Key generiert – ggf. alten Key aus `~/.ssh/known_hosts` entfernen.

---

#### 📦 Scripts im Container

Pfad: `/usr/local/bin/crumbmissions/`

| Skript                          | Funktion                             |
| ------------------------------- | ------------------------------------ |
| `intro.sh`                      | 🧁 Einführung in die Shell-Kommandos |
| `welcome_kruemel.sh`            | 🦉 Kindgerechte Kommando-Einführung  |
| `mission_selector.sh`           | 🌲 Auswahl von Rollen & Aufgaben     |
| `mission_selector_mission_1.sh` | 📦 Blockly-Integrationstest          |
| `create_linux_user.sh`          | 👤 Linux-User erstellen              |
| `setup_terminal_aliases.sh`     | 🛠️ Alias-Konfiguration für Benutzer |

---

#### 🔄 Blockly Verbindungstest

```bash
curl -X POST http://localhost:8080/crumbapi/blockly-terminal \
     -H "Content-Type: application/json" \
     -d '{"blockcode": "window.alert(42);"}'
```

✅ Antwort: `Blockcode received.`

---

#### 🐚 Terminal-Startprozess

```bash
# Im Container:
./intro.sh     # Erster Einstieg
./mission_selector.sh  # Rollenwahl & Missionsstart
```

---

#### ✨ Notizen für Pädagog\:innen & Admins

* Kein OpenRouter-Zwang beim ersten Einstieg: Eule, Fuchs, Maus, Waschbär etc. sind lokal ausführbar.
* Blockly → Terminal Bridge erlaubt spielerisches "Code bauen" & ausführen.
* Crumbforest versteht Lernen als Abenteuer im Wald – mit Maschinen, Frequenzen & Vertrauen.
* Projekt ist modular & offen (Open Source), aber API-Zugriff (z.B. GPT) kann nach Verbrauch abgerechnet werden (Tokenmodell).
* Ziel: Bildung als Raum für Fragen. Für jede neue Frage darf ein neuer Pfad entstehen. → Polyversität.

---

🎉 *Build verified. Ports open. Kinderterminal aktiviert. #seriousToys #crumbforest #teamblacksheep*
🛠️ *Letzter Check durch: `robot@bbf64aebcceb` auf `Mac M3 / Docker / PHP 8.4 / CakePHP 5`*

---

