Krümel Branko
da67da3959
- LICENSE.md: Dual license explanation (MIT + CKL) - LICENSE-MIT.md: Full MIT text with plain language explanation - LICENSE-CKL.md: Full Children's Knowledge License v0.1-draft - OZM-NEXUS-ECOSYSTEM.md: Complete ecosystem architecture and governance - KINDERRECHTE.md: Children's rights operationalization (export/deletion processes) - README.md: Project overview with CKL badge and comprehensive documentation links - CLAUDE.md: Project instructions for Claude Code This establishes Crumbforest as part of the OZM⟡NEXUS ecosystem with: - Dual licensing strategy (developer freedom + child protection) - 8 axioms operationalized through CKL - Clear governance path (OZM as custodian) - DSGVO-compliant children's rights processes - Roadmap through Q4 2025 "Wissen gehört dem Kind, solange es fragt." 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
345 lines
10 KiB
Markdown
345 lines
10 KiB
Markdown
# Crumbpages v2 🌲
|
|
|
|
> **Dokumentation und Lernsystem für System-Administration**
|
|
> Teil des Crumbforest-Ökosystems
|
|
|
|
---
|
|
|
|
## 📜 Lizenz & Kinderrechte
|
|
|
|
[](LICENSE.md)
|
|
[](LICENSE-CKL.md)
|
|
|
|
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 →](KINDERRECHTE.md)
|
|
|
|
**Für Entwickler:** Frei nutzbar und forkbar. [Compliance-Infos →](LICENSE.md)
|
|
|
|
---
|
|
|
|
## 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Crumbpages lesen (Markdown)
|
|
ls crumbpage-*.md
|
|
|
|
# Template für neue Pages
|
|
cat crumbpage-template.md
|
|
```
|
|
|
|
---
|
|
|
|
## Dokumentation
|
|
|
|
### 🔑 Wichtigste Dokumente
|
|
|
|
| Dokument | Beschreibung |
|
|
|----------|--------------|
|
|
| **[OZM-NEXUS-ECOSYSTEM.md](OZM-NEXUS-ECOSYSTEM.md)** | 🌐 **Das große Bild**: Wie Crumbpages ins OZM⟡NEXUS Ökosystem passt |
|
|
| **[LICENSE.md](LICENSE.md)** | 📜 Dual-Lizenz erklärt (MIT + CKL) |
|
|
| **[LICENSE-CKL.md](LICENSE-CKL.md)** | 🛡️ Die vollständige Children's Knowledge License |
|
|
| **[KINDERRECHTE.md](KINDERRECHTE.md)** | 👶 Deine Rechte als Lernende/r (Export, Löschung, Eigentum) |
|
|
| **[CLAUDE.md](CLAUDE.md)** | 🤖 Anleitung für Claude Code (Codebase-Kontext) |
|
|
| **[HANDBUCH.md](HANDBUCH.md)** | 📖 Manual für crumbpages-doktor.sh |
|
|
| **[QUICKSTART.md](QUICKSTART.md)** | ⚡ Quick Reference für häufige Operationen |
|
|
|
|
### 🗂️ Meta-Dokumentation
|
|
- **[CRUMBFOREST_PROJECT_INDEX.md](CRUMBFOREST_PROJECT_INDEX.md)** - Komplette Projekthistorie & Milestones
|
|
- **[crumbforest-manifesto-guardian.md](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](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](OZM-NEXUS-ECOSYSTEM.md) Section II
|
|
|
|
---
|
|
|
|
## Konfiguration
|
|
|
|
### `.env` Datei
|
|
Das Doktor-Tool nutzt `.env` für Konfiguration (wird beim ersten Start erstellt):
|
|
|
|
```ini
|
|
# 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:
|
|
|
|
| Wenn du kannst... | Dann kannst du... |
|
|
|-------------------|-------------------|
|
|
| **Bash/Linux** | Crumbpages schreiben, doktor-Module erweitern |
|
|
| **Python/FastAPI** | An CrumbCore arbeiten (anderes Repo) |
|
|
| **Pädagogik** | Lernpfade testen, Charaktere verfeinern |
|
|
| **Design** | branko.de verbessern, Accessibility |
|
|
| **Recht** | CKL v1.0 reviewen, Governance helfen |
|
|
| **Übersetzen** | Crumbpages auf Englisch/andere Sprachen |
|
|
|
|
### Erste Schritte:
|
|
|
|
1. **Lies die CKL:** [LICENSE-CKL.md](LICENSE-CKL.md)
|
|
2. **Verstehe das Ökosystem:** [OZM-NEXUS-ECOSYSTEM.md](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](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
|