Crumbpages v2 🌲

Dokumentation und Lernsystem für System-Administration
Teil des Crumbforest-Ökosystems

📜 Lizenz & Kinderrechte

Dieses Projekt ist dual-lizenziert:
- MIT License für Code und allgemeine Nutzung
- CKL (Children's Knowledge License) für Bildungskontexte mit Kindern

Für Lernende: Deine Rechte sind geschützt. Lies hier mehr →

Für Entwickler: Frei nutzbar und forkbar. Compliance-Infos →

Was ist Crumbpages?

Crumbpages v2 kombiniert Bildungsdokumentation mit operationalen Tools für System-Administration:

📚 Lernpfade

• 20 Crumbpages (Markdown) zu Linux-Fundamenten, SSH, Netzwerk, Kernel, uvm.
• Template-basierte Struktur für konsistentes Lernen
• Progressive Learning Paths: von Basics zu Advanced Topics

🛠️ Operational Tools

• crumbpages-doktor.sh (496 Zeilen) - Hauptwerkzeug für Diagnostik & Operations
• ssh-agent-guard.sh - Produktions-SSH-Security-Daemon
• ssh-agent-screenlock_v4.sh - MATE Desktop SSH-Integration

🌳 Philosophie: Waldwächter

"Transparency over magic"
- Bash-zentrisch, klar lesbar, lehrbar
- Minimale Dependencies, einfache Patterns
- Education-First: Alle Tools sind verständlich und nachvollziehbar

Schnellstart

1. Haupttool starten

# Ausführbar machen (einmalig)
chmod +x crumbpages-doktor.sh

# Interaktives Menü starten
./crumbpages-doktor.sh

Das Doktor-Tool bietet 6 Module:
1. Git Workstation - Interaktive Git-Shell mit Health Checks
2. DNS Doktor - DNS-Diagnostik und Reporting
3. System Doktor - Host Vitals (Disk, RAM, OS Info)
4. Web Tools - API-Testing (api_search, api_get, api_ask)
5. Remote Tools - SSH-Helfer und SCP-Uploads
6. Werkzeugkasten - Tool-Verfügbarkeits-Checks

2. SSH-Security aktivieren

# SSH-Agent Guard starten (systemd/autostart)
./ssh-agent-guard.sh

# Für MATE Desktop Integration
./ssh-agent-screenlock_v4.sh

Beide Scripts:
- Killen und starten ssh-agent bei Screen Lock neu
- Loggen nach ~/.ssh-agent-screenlock.log
- Nutzen festen Socket-Path ~/.ssh/agent.sock

3. Lernpfade durcharbeiten

# Crumbpages lesen (Markdown)
ls crumbpage-*.md

# Template für neue Pages
cat crumbpage-template.md

Dokumentation

🔑 Wichtigste Dokumente

🗂️ Meta-Dokumentation

• CRUMBFOREST_PROJECT_INDEX.md - Komplette Projekthistorie & Milestones
• crumbforest-manifesto-guardian.md - Waldwächter-Philosophie
• Tagebuch-Dateien - Problem-Solving-Journeys

Das größere Ökosystem

Crumbpages v2 ist Teil des Crumbforest:

OZM⟡NEXUS (Träger/Manifest)
    ↓
branko.de/Crumbforest (Public Interface)
    ├─ 15 Charaktere (Krümeleule, FunkFox, SnakePy...)
    ├─ 4 Lernpfade (ESP32 → Pi Zero → Pi Server → Daten)
    └─ "Every child may ask. We protect this right."
    ↓
CrumbCore v1 (Local Engine)
    ├─ FastAPI + Qdrant RAG
    ├─ Role-based Chat (15 Personas)
    ├─ Multi-Theme (Accessible, High Contrast...)
    └─ Token-Management (Kids = free)
    ↓
Crumbpages v2 (dieser Repo) ← 📍 DU BIST HIER
    ├─ 20 Lernpfade (Markdown)
    ├─ Operational Tools (doktor, SSH guards)
    └─ Waldwächter-Philosophie

Mehr dazu: OZM-NEXUS-ECOSYSTEM.md

Die 8 Axiome

Alle Komponenten des Crumbforest folgen diesen Prinzipien:

✅ autonom - Du entscheidest deinen Lernweg
✅ zukunftsoffen - Erweiterbar, nicht fertig
✅ nicht interpretierbar - Kein "richtiger" Weg, nur funktionale
✅ nicht missbrauchbar - Schutz durch Design
✅ suchbar - Fragen führen zu Antworten
✅ wiedererkennbar - Krümel zeigen den Weg
✅ erweiterbar - Du kannst selbst pflanzen
✅ unendlich skalierbar - Für alle, immer, kostenlos

Mehr dazu: OZM-NEXUS-ECOSYSTEM.md Section II

Konfiguration

.env Datei

Das Doktor-Tool nutzt .env für Konfiguration (wird beim ersten Start erstellt):

# API Endpoints (für CrumbCore Integration)
CRUMB_API_URL="http://localhost:8000"
CRUMB_API_TOKEN="changeme"

# SSH/Remote Settings
CRUMB_SSH_USER="admin"
CRUMB_SCP_TARGET="backup.crumbforest.de:/var/backups"

# Qdrant Vector DB
CRUMB_QDRANT_URL="http://localhost:6333"
CRUMB_QDRANT_KEY=""

Tipp: Nie in Git committen! (ist bereits in .gitignore)

Für neue Mitwirkende

🌱 Willkommen im Wald!

Crumbforest ist ein offenes Lernökosystem. Jede/r kann Krümel pflanzen.

Voraussetzungen:
- Du akzeptierst die CKL (Kinder haben Vorrang)
- Du arbeitest transparent (keine Blackboxes)
- Du dokumentierst nachvollziehbar (andere sollen nachbauen können)

Wie du beitragen kannst:

Erste Schritte:

1. Lies die CKL: LICENSE-CKL.md
2. Verstehe das Ökosystem: OZM-NEXUS-ECOSYSTEM.md
3. Such ein TODO: Siehe Section VII in OZM-NEXUS-ECOSYSTEM.md
4. Melde dich: [Kontakt siehe unten]

Entwickler-Tipps

Wenn du Shell-Scripts editierst:

• Teste interaktiv vor dem Commit (Scripts sind für Menschen gedacht)
• Bewahre Farbschema-Konsistenz (GREEN, BLUE, RED, YELLOW, CYAN)
• Behalte Modul-Grenzen im doktor-Script bei
• Update HANDBUCH.md bei Änderungen an doktor-Modulen

Wenn du Crumbpages editierst:

• Folge crumbpage-template.md Struktur exakt
• Behalte Nummerierungsschema bei (crumbpage-##-topic.md)
• Füge Skill Checks und Hands-on Exercises ein
• Verlinke zu verwandten Pages im Navigation Footer

Wenn du debuggst:

• Check .env Konfiguration zuerst
• Review Logs: ~/.ssh-agent-screenlock.log für SSH Issues
• Nutze doktor's System Doktor Modul für Host-Diagnostik
• Git Workstation Modul hat check_health für Repo-Status

Sicherheit

SSH Agent Scripts

• Killen aktiv Credentials bei Screen Lock
• Einzelinstanz-Daemon-Pattern (kein Prozess-Spawning)
• Deep Work Mode: ssh-agent-guard.sh unterstützt Pause-File
• Fixed Socket Path für Terminal-Sharing

Allgemein

• API-Tokens in .env gespeichert (gitignored)
• Keine hardcoded Credentials
• MATE Screensaver Hardening empfohlen (lock-enabled true, lock-delay 0)

Status & Roadmap

✅ Aktueller Stand (2025-12-13)

Fertig:
- 20 Crumbpages (work in progress, noch nicht in CrumbCore integriert)
- Operational Tools (doktor, SSH guards)
- Dual-Lizenzierung (MIT + CKL v0.1)
- Ecosystem-Dokumentation
- Kinderrechte-Spezifikation

In Arbeit:
- Integration mit CrumbCore (automatisches Laden via load_content.sh)
- Export/Lösch-APIs für Kinderrechte
- OZM als rechtlicher Träger (Transition läuft)

🚀 Nächste Schritte

Sofort:
- [x] LICENSE.md, LICENSE-MIT.md, LICENSE-CKL.md
- [x] KINDERRECHTE.md
- [x] OZM-NEXUS-ECOSYSTEM.md
- [x] README.md
- [ ] DATENSCHUTZ.md

Q1 2025:
- [ ] CrumbCore Export-API (GET /api/v1/my-data)
- [ ] CrumbCore Lösch-API (DELETE /api/v1/my-data)
- [ ] Crumbpages → CrumbCore Integration
- [ ] CKL v0.1 → v1.0 Finalisierung

Q2 2025:
- [ ] OZM Governance formalisieren
- [ ] Trademark-Übertragung
- [ ] Community-Prozesse (CONTRIBUTING.md, Issue Templates)

Siehe: OZM-NEXUS-ECOSYSTEM.md Section VII für komplette Roadmap

Ressourcen

Related Repositories

• CrumbCore v1: https://194-164-194-191.sslip.io/git/kruemel/Crumb-Core-v.1
• Crumbforest Markdowns: https://194-164-194-191.sslip.io/git/kruemel/Crumbforest-Markdowns

Websites

• Crumbforest: https://crumbforest.com
• branko.de: https://branko.de (Public Interface)
• OZM: Open Futures Museum, Hamburg

Kontakt

• Lead Maintainer: Branko
• Custodian: OZM - Open Futures Museum (in transition)
• Email: [wird ergänzt]

Hashtags

#OZM #OPENSOURCE #CRUMBFOREST #CKL #KINDERRECHTE #BILDUNG #LINUX #BASH #SYSTEMADMINISTRATION

Warum das wichtig ist

Das Problem mit Bildungs-KI heute:

• ❌ Proprietäre Blackboxes (ChatGPT, Gemini...)
• ❌ Kinder als Datenquelle ("Training Data")
• ❌ Paywalls vor Wissen
• ❌ Keine Kontrolle, keine Transparenz
• ❌ Cloud-Zwang, Überwachungskapitalismus

Kinderrechte werden strukturell verletzt.

Die Crumbforest Alternative:

• ✅ Open Source (MIT + CKL)
• ✅ Lokal betreibbar (keine Cloud nötig)
• ✅ Transparent (jeder Schritt nachvollziehbar)
• ✅ Kind-zentriert (Urheberschaft bleibt beim Kind)
• ✅ Gemeinnützig (wird verschenkt, nicht verkauft)

Das ist keine "bessere EdTech-Plattform".
Das ist eine andere Art, über Lernen nachzudenken.

Zitat

"Wissen gehört dem Kind, solange es fragt."
"Nullfeld zuerst, dann Messung. Resonanz vor Regel."
— Waldwächter-Prinzip

Version: 2.0
Lizenz: MIT + CKL v0.1
Status: Active Development
Letzte Aktualisierung: 2025-12-13