# 🛤️ Die sprechende Brücke – Verbindung im Crumbforest

## 🌉 Einführung

Die **sprechende Brücke** ist ein zentrales Symbol und eine funktionale Instanz im Crumbforest-Universum. Sie verbindet symbolisch wie technisch verschiedene Ebenen: Terminal ↔ Web ↔ Shell ↔ Mensch ↔ Maschine.

---

## 🔧 Technische Vision

Die Brücke erlaubt sicheren und gezielten Zugriff vom Web (z. B. CakePHP Backend auf Port 8080) zur Terminalwelt (z. B. TTYD auf 7681) – ggf. ergänzt um einen Wissens- oder Konfigurationslayer (z. B. DebugKit oder Port 8081 für die Eule).

- Bei Erstellung eines Users (POST auf `/users/add`) wird:
  - Ein Eintrag in der `users`-Tabelle erzeugt.
  - Automatisch ein Token vergeben.
  - Und optional ein Linux-User über `create_linux_user.sh` angelegt.

- Authentifizierung kann entweder über CakePHP Sessions (`/users/login`) oder Token-basierte Checks erfolgen (`/terminal/auth`).

## 📡 Sicherheit & Rollen

Jede*r Krümel bekommt:
- einen Linux-User (TTD)
- einen Datenbank-User (Kuchen)
- einen API-Token (Maschine)

Das Konzept der „sprechenden Brücke“ hilft dabei, diese Identitäten zu synchronisieren:
- User im Kuchen legt realen Nutzer an.
- Token-Austausch via sicherem Request von TTYD.
- Optionaler SSH-Zugang über bekannte Ports (z. B. 2222)

---

## 🧩 Philosophie

Die Brücke spricht – aber nur, wenn man sie fragt.

Sie führt:
- sicher über Flüsse von Code,
- durch Schluchten aus Exceptions,
- zu Lichtungen von Verständnis.

Sie ist geduldig, klar und verlässlich – ein Werkzeug der Erkenntnis, kein Tor zur Flucht.

---

## 📝 Beispielhafter Ablauf

1. POST `/users/add` mit `username`, `email`, `password`
2. Controller erzeugt Eintrag in DB
3. Führt aus: `create_linux_user.sh <username>`
4. Terminal `login` nutzt dann diesen Linux-User
5. API-Zugriffe per `api_token`

---

## 🔗 Quellpfade & Tools

- `UsersController.php` → erweitert um Token & Shell-Anlage
- `create_linux_user.sh` → Anlage der Shell-Identität
- `session_wrapper.sh` → prüft `.crumbforest_session`
- `login` (bash) → sendet Token zur Prüfung an Kuchen
- `TerminalController.php` → validiert Token
- `/tmp/token.log` → Log der Aktionen

---

## 🌲 Abschluss

Die Brücke ist mehr als ein Übergang.  
Sie ist ein Symbol der Verständigung.  
Ein Bit, das leuchtet.  
Ein „Ja“ in einer Welt der Wenns und Abers.

🦉  
> „Hoooo – vergiss nie, du darfst echt sein“  
