Konventions-Geruest anlegen (CLAUDE.md, docs, Obsidian-Vault)

Projekt-CLAUDE.md mit Status, Entscheidungslog E-001..E-006,
Architektur mit Mermaid-Diagrammen, COCKPIT/CHANGELOG als Vault-Start.
Alt-Doku (CLAUDE_KONTEXT.md, ZUSAMMENFASSUNG_TODO.md) darin aufgegangen.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-13 13:11:35 +02:00
parent bd4384c36f
commit 9cd471d66e
6 changed files with 251 additions and 0 deletions

50
CLAUDE.md Normal file
View File

@@ -0,0 +1,50 @@
# schul-laptops — Projektstatus
Status: aktiv · Stand: 2026-07-13
## Worum es geht
Zentrale Verwaltung von 1216 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.
## Naechste Schritte
- [ ] Teil A: Server — DNS `git.lehrstun.de`, Nginx-vHost, Deploy-Key
- [ ] Teil B: Pull-Mechanik (local.yml, schul-pull.sh, systemd-Units, first-boot)
- [ ] Teil C: Jahres-Reimage (Clonezilla lokal, Boot-Check, Mini-Menue)
- [ ] Teil D: Aktivierung auf laptop03 + Verifikation
- [ ] Master-Image erstellen, Rollout auf laptop0116 (auch laptop10 neu)
## 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).