Thomas Stallinger
cf59a9bb44
Direkte Folge des vorherigen Commits (sprechender Download-Dateiname) - die Anleitung auf /installationsmedium zeigte weiterhin 'tuxflotte-installationsmedium.iso'. Namensbildung in _iso_dateiname() extrahiert, von installationsmedium_ansicht() (fuer die Anzeige) UND installationsmedium_download() (fuer den echten Header) gemeinsam genutzt, damit beide nie auseinanderlaufen koennen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
kundenplattform
Kunden-Web-UI für den Tuxflotte-Auftragskatalog — von provisioning-server
(anode) bewusst getrennter Dienst, siehe ADR-0011.
Architektur
- FastAPI + Jinja2 (serverseitig gerendert, kein Frontend-Build).
- Eigene Postgres-Datenbank (
benutzer-Tabelle: E-Mail/Passwort-Hash pro Organisation) — getrennt von provisioning-servers Datenbank, keine Cross-Database-Referenzen. - Spricht mit anode ausschließlich über dessen HTTP-API, authentifiziert mit
einem eigenen Service-Token (
TUXFLOTTE_KUNDENPLATTFORM_TOKEN, getrennt vom Admin-Token). Organisationszugehörigkeits-Prüfung (darf dieser Login auf dieses Gerät zugreifen?) passiert hier in der Anwendung, vor jedem Aufruf gegen anode — siehefind_device_in_organization()inapp.py.
Setup (lokal)
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
KUNDENPLATTFORM_DATABASE_URL=postgresql://... .venv/bin/psql ... -f migrations/0001_initial_schema.sql
Env-Variablen:
TUXFLOTTE_ANODE_URL(Defaulthttp://127.0.0.1:8080)TUXFLOTTE_KUNDENPLATTFORM_TOKEN— muss mit dem gleichnamigen Wert in provisioning-servers/etc/tuxflotte/provisioning-server.envübereinstimmenKUNDENPLATTFORM_DATABASE_URLKUNDENPLATTFORM_SESSION_SECRET— beliebiger zufälliger String zum Signieren der Session-Cookie (z.B.openssl rand -base64 32)
Start: .venv/bin/uvicorn app:app --port 8081
Konto anlegen
Kein Self-Service in v1 (siehe ADR-0011) — Konten werden manuell angelegt:
KUNDENPLATTFORM_DATABASE_URL=... .venv/bin/python scripts/create_user.py \
--organization-id <organization-uuid> \
--email admin@schule-beispiel.de
Deploy (anode)
Wie bei provisioning-server, git-basiert statt scp:
git pull --ff-only
systemctl restart kundenplattform
Läuft unter einem eigenen, unprivilegierten System-User kundenplattform
(nicht root, anders als provisioning-server) — siehe kundenplattform.service.
Port 8081 (provisioning-server belegt 8080).
Öffentliche Erreichbarkeit über Pangolin ist nicht Teil dieses Repos — das ist ein separater Ops/DNS/Reverse-Proxy-Schritt.