# 🍰 Crumbforest Build System Manifest

**Datum:** 2025-05-21  
**Version:** `kuchenwald_docker_php83_sql_mit_AUTH_mit_composer_update_v1_rcv002`  
**Umgebung:** Docker + CakePHP 5 + TTYD + Auth + Markdown + CLI-Kommandos  
**Crewstatus:** 🟢 Voll aktiv

---

## 🔧 System-Komponenten

### 💻 Container:

- **App** (CakePHP 5 mit Authentication & Markdown Viewer)
- **Database** (MariaDB mit `kuchenwald`)
- **Adminer** (Port `8081`)
- **TTYD Terminal** (Port `7681`)

### 📄 Frontend-Zugänge:

- `http://localhost:8080` – CakePHP-Anwendung
- `http://localhost:8081` – Adminer
- `http://localhost:7681` – Terminal (mit login-Skript)
- `http://localhost:8080/tagcloud.html` – Dynamische TagCloud

---

## 🧭 Routen & Controller

| Pfad                          | Beschreibung                          |
|------------------------------|---------------------------------------|
| `/markdowns/index`           | Auto-Index aller Markdown-Dateien     |
| `/markdowns/view/:slug`      | Einzelanzeige einer Markdown-Datei    |
| `/users/login`               | Login-Seite für Auth                  |
| `/bin/cake tagcloud`         | Generiert TagCloud HTML               |
| `/bin/cake generate_token`   | Erstellt API-Token für Nutzer         |

---

## ✅ Authentifizierung

- `AuthenticationPlugin` aktiv
- Login über `email` und `password`
- Erfolgreicher Login = Zugriff auf alle Markdown-Views
- Nutzer-Session wird über Middleware validiert

---

## 🧪 Terminal-Interaktionen

- Login mit: `login`
- Unterstützte Benutzer:
  - root
  - kruemel
  - jupiter
  - heimkind
  - robot
- Beispielaktionen: `nano`, `ls`, `mc`, `cat`

---

## 🗂 Markdown Integration

- Markdown-Dateien liegen in: `webroot/markdown/*.md`
- Werden automatisch in `/markdowns/index` verlinkt
- **TagCloud** zeigt Schlagworte + Slugs visuell

---

## 📦 Build & Reset

- Skript: `reset_to_null_and_rebuild.sh`
- Führt aus:
  - Container-Reset
  - Volume-Löschung
  - SQL-Import
  - TagCloud-Generierung
  - Log-Einträge

---

## 🧠 Highlights aus dem Log

```log
[2025-05-21 22:00] ✅ LOGIN_OK – branko via /users/login
[2025-05-21 22:01] 🌥️ TAGCLOUD_OK – tagcloud.html generated
[2025-05-21 22:02] 📄 VIEW_OK – /markdowns/view/werte_manifest
```

---

## 🌀 Symbolik

- **Null:** Ursprung, Zustand vor dem Zugriff
- **Eule:** Beobachterin der Stille
- **Fuchs:** Entdecker der Pfade (`ls`)
- **Brücke:** Navigationshilfe (`cd`)
- **Nano:** Reparatur & Ordnung im Terminal

---

## 🧡 Dank an die KrümelCrew

Jeder Commit zählt.  
Jede .md erzählt.  
Jeder Terminal-Befehl bringt uns näher zur Harmonie von Mensch, Maschine und Wald.

