# Kernel Panic — Bau dir dein Linux

Interaktives LPIC-1-Browsergame und Abschluss-Projektarbeit für einen Linux-Kurs.

Der Spieler repariert ein ausgefallenes Linux-System. Zehn Kapitel enthalten
je zehn eigenständig formulierte Fragen. Die Aufgaben folgen dem Muster
**Signal → Werkzeug → Entscheidung → Risiko**.

- **Kurslauf:** 30 Fragen, drei zufällige je Kapitel
- **Lernmodus:** alle 100 Fragen
- Auswahlmöglichkeiten und Sequenzbausteine werden neu gemischt
- animierter Erfolgsmoment mit Lernzusammenfassung nach jedem Kapitel
- Ergebnisübersicht zeigt Fehler und hilfefreie Lösungen je Kapitel
- falsche Antwort kostet sichtbar Punkte, zeigt die Lösung und schaltet weiter;
  drei Fehler starten das Kapitel neu, ohne Fortschritt zu vernichten
- persönlicher Lern-Spickzettel zum Abschluss, als Markdown-Download und
  Druckansicht
- optionale gemeinsame „Hall of Tux“ mit anonymen Aliasen
- versteckte SQLite-Schatzsuche für neugierige Fortgeschrittene

**Live:** <https://andrestiebitz.de/kernel-panic/>

**Vollständige Projektdokumentation (PDF):**
<https://andrestiebitz.de/kernel-panic/kernel-panic-projektarbeit.pdf>

**Weitergabe-ZIP:** <https://andrestiebitz.de/kernel-panic/kernel-panic-lpic-projekt.zip>

**Quellcode:** <https://codeberg.org/andremadstop/lpic-kernel-panic>

## Start

```bash
npm install
npm run dev
```

Danach `http://localhost:3000/kernel-panic/` öffnen.

## Qualitätsprüfung

```bash
npm run check
npx playwright test
```

## Datenschutz und Sicherheit

Das Lernspiel besitzt kein Login oder Tracking. Fortschritt bleibt im
`localStorage` des Browsers. Das Terminal ist eine Simulation und führt keine
Systembefehle aus.

Nur die optionale Bestenliste verwendet eine getrennte, gehärtete Score-API mit
privater SQLite-Datenbank. Gespeichert werden Alias und Ergebnisdaten, keine
Konten, E-Mail-Adressen oder IP-Adressen. Der Server berechnet den Score selbst;
die Bestenliste ist trotzdem kein manipulationssicherer Prüfungsnachweis.

Die öffentlich auffindbare Datei `scoreboard-backup.sqlite` ist absichtlich
eine harmlose Fake-Datenbank für die Schatzsuche. Sie enthält keinerlei echte
Scores oder Serverdaten. Details stehen in [SECURITY.md](SECURITY.md).

## Inhalt

Die 100 Fragen decken zentrale Lernziele von LPIC-1 101-500 und 102-500 ab.
Grundlage sind die offiziellen LPIC-1-Lernziele sowie neu formulierte Szenarien
aus den Themen des Linux-Kurses. Kursoriginale und Prüfungsbilder sind nicht
Bestandteil des Repositories.

Die zwölfseitige PDF ist das eigenständig lesbare Abgabedokument. Sie enthält
Projektauftrag, Lernkonzept, Kapitelübersicht, Spielablauf, Screenshots,
Architektur, Projektstruktur, lokale Nutzung, Tests, Scoreboard,
Sicherheitsmodell, Schatzsuche, Deployment, Lizenz, Präsentationsvorschlag und
Quellen.

Projekt: André Stiebitz, 2026.

## Lizenz

Quellcode und eigene Projekttexte stehen unter der
[MIT-Lizenz](LICENSE). Nutzung, Änderung und Weitergabe sind erlaubt, sofern
Copyright- und Lizenzhinweis erhalten bleiben. Kursoriginale und Prüfungsbilder
sind ausdrücklich nicht Bestandteil dieses Projekts.
