schul-laptops/CLAUDE.md

# schul-laptops — Projektstatus

Status: aktiv · Stand: 2026-07-13 · Pull-Mechanik LAEUFT auf laptop03, Reimage-Skripte verteilt — es fehlt nur noch der Hardware-Teil (Stick/Platte)

## Worum es geht

Zentrale Verwaltung von 12–16 Linux-Mint-Schullaptops. Zwei Standbeine:

1. **Laufende Updates per `ansible-pull`** (Normalfall): Die Laptops ziehen sich
   Konfiguration/Software selbst aus Gitea (`git.lehrstun.de`, HTTPS) — Push per
   Ansible scheitert am Schul-WLAN (Client-Isolation).
2. **Komplett-Reimage ~1×/Jahr** von der externen Platte `DEZNTRSICHERUNG`
   (Clonezilla, neuestes Image gewinnt, Hostname bleibt erhalten).

Master-Laptop: **laptop03** (dieser Rechner). Details: `docs/architektur.md`.

## Quickstart

```bash
cd ~/projekte/schul-laptops

# Aenderung an den Laptops ausrollen: Repo aendern + pushen — mehr nicht.
git add -A && git commit -m "..." && git push
# Die Laptops ziehen es beim naechsten Timer-Lauf (Boot bzw. <=30 min).

# Pull-Lauf lokal testen (laptop03):
sudo systemctl start ansible-pull.service && journalctl -u ansible-pull -f
```

Benutzer auf den Laptops: `puettmann` (Admin, passwordless sudo), `schueler` (ohne Adminrechte).

## Blocker

- Keine Software-Blocker. Es fehlt nur Hardware am laptop03:
  CLONEZILLA-Stick + Platte DEZNTRSICHERUNG (siehe naechste Schritte).

## Naechste Schritte — GENAU IN DIESER REIHENFOLGE (naechste Sitzung: 2026-07-15)

**Als Erstes, BEVOR irgendein Image erstellt wird:**

1. [ ] **Herb prueft laptop03 auf Image-Reife.** Herb will kontrollieren, ob
   alles auf diesem Rechner ist, was geklont werden soll (Software, Einstellungen,
   schueler-Account). Die naechste Instanz soll ihn dabei aktiv unterstuetzen:
   installierte Programme durchgehen, Home-Verzeichnisse auf Muell/Privates
   pruefen (z.B. `~/RS41ng` bleibt — ist ok, wird mitgeklont), offene Fragen stellen.
   **Kein Master-Image erstellen, bevor Herb das freigegeben hat!**

**Danach (Stick + Platte muessen an laptop03 stecken):**

2. [ ] Clonezilla-Live-Dateien vom Stick (Ordner `/live/`: vmlinuz, initrd.img,
   filesystem.squashfs) nach `/boot/clonezilla/` kopieren
3. [ ] Bestandsimage auf der Platte umbenennen: `schule-laptop` →
   `schule-laptop-2026-02-01` (Datums-Schema, neuestes gewinnt)
4. [ ] Stick-Menue (syslinux.cfg + grub.cfg auf dem Stick) auf
   „neuestes Image“-Logik + `files/clonezilla/schul-reimage.sh` umstellen
5. [ ] Reimage-Kette TROCKEN testen (auf laptop03 nur den Check, nie den Restore:
   `sudo /usr/local/bin/reimage-check.sh` mit angesteckter Platte ausfuehren —
   wegen Hostname-Schutz muss er ohne Aktion beenden; Logik ggf. mit
   ueberschriebenem Hostname-Check auf einer Wegwerf-Kopie pruefen)
6. [ ] Neues Master-Image erstellen: laptop03 neu starten, GRUB-Eintrag
   „Schul-Neuinstallation“ → Taste `i` (IMAGE ERSTELLEN)
7. [ ] ECHTER Reimage-Test auf laptop10 (Opfer-Laptop): Platte dran, einschalten,
   warten — muss sich danach als laptop10 mit neuem Image melden
8. [ ] Rollout auf laptop01–16 (Erstinstallation per Stick, Weg 3 in
   `CLONEZILLA_AUTOMATISCH.md`)

## Hinweise

- Plan/Entscheidungen: `docs/decisions.md` · Historie: `CHANGELOG.md` · Vault-Start: `COCKPIT.md`
- Legacy-Push-Setup (inventory.yml, update-ips.sh, playbooks/) funktioniert nur im
  Heimnetz — siehe README.md.
- Auf laptop03 liegt auch das RS41ng-Wettersondenprojekt (`~/RS41ng/`), Vorsicht
  beim Image-Erstellen: laptop03 bespielt sich nie selbst (reimage-check deaktiviert).