platform-docs/00-glossary.md
Thomas Stallinger 8ece25f954 docs: define Merkmal/Blueprint/Bereitstellungsvorlage model (ADR-0002)
Introduces the Merkmal-Backend-Blueprint realization model: a Merkmal
describes one distribution-independent workspace feature, a Blueprint
realizes exactly one Merkmal for exactly one backend (usually an
Ansible role applied post-first-boot via ansible-pull), and a
Bereitstellungsvorlage bundles workspace + backend + org-specific
installation directives (partitioning, encryption, secure boot).

Replaces the old flat profile model (profiles/profile.json/
distribution+version) throughout the provisioning API, data model,
interactive provisioning flow, and device enrollment docs with
templates/Bereitstellungsvorlage terminology. Moves 02-workspace-model.md
and 04-backend-model.md into architecture/, archives the superseded
flat organization-model.md.
2026-07-18 10:45:48 +02:00

97 lines
2.0 KiB
Markdown

# Tuxflotte Glossary
**Status:** Stable
**Datum:** 2026-07-07
## Workspace
Ein fachlich definierter Arbeitsplatz.
Ein Workspace beschreibt, welchen Zielzustand ein System haben soll.
Beispiele:
- Developer Workspace
- Office Workspace
- Kiosk Workspace
Ein Workspace ist nicht distributionsabhängig.
## Backend
Eine distributionsspezifische Implementierung.
Ein Backend beschreibt, wie ein Workspace auf einer bestimmten Distribution installiert wird.
Beispiele:
- Fedora Backend
- Mint Backend
- Debian Backend
## Organization
Eine Organisation beschreibt kunden- oder unternehmensweite Vorgaben.
Beispiele:
- Zertifikate
- LDAP
- Keycloak
- Paketquellen
- Proxy
- Branding
- VPN
- Monitoring
## Merkmal
Eine einzelne fachliche Eigenschaft eines Workspace, distributionsunabhängig benannt.
Beispiele:
- browser-brave
- office-onlyoffice
- guest-session-ephemeral
Ein Workspace besteht aus einer Menge von Merkmalen.
## Blueprint
Die technische Umsetzung genau eines Merkmals für genau ein Backend.
Ein Blueprint ist im Regelfall eine Ansible-Rolle beziehungsweise -Aufgabe, die nach dem ersten Start über den bestehenden Ansible-Pull-Mechanismus angewendet wird.
Details: `architecture/12-feature-blueprint-model.md`.
## Runtime Blueprint
Die zur Installationszeit erzeugte vollständige Zielbeschreibung.
Sie entsteht aus:
- den aufgelösten Blueprints der Merkmale des Workspace für das gewählte Backend
- direkten Organization- und Backend-Vorgaben (zum Beispiel Partitionierung, Verschlüsselung)
- optional Benutzerkontext
## Orchestrator
Die Komponente der Provisioning-ISO, die den Ablauf steuert.
Der Orchestrator erkennt Hardware, lädt Profile, erzeugt Runtime Blueprints und startet das passende Backend.
## Provisioning Agent
Der Agent läuft auf dem installierten System und übernimmt Registrierung, Nachkonfiguration, Inventarisierung und Lebenszyklusaufgaben.
## Native Installer
Der offizielle Installer der jeweiligen Distribution.
Beispiele:
- Anaconda
- Calamares
- Debian Installer
- Subiquity