62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
# XinionOS — Regeln für diese Ablage
|
|
|
|
> Verbindlich für jeden, der hier arbeitet — Mensch wie Agent.
|
|
|
|
## Was hier gebaut wird
|
|
|
|
Die **Geräteschicht** unter den Appliance-Produkten des Hauses: Abbild, Ersteinrichtung, zwei
|
|
Wurzeln, Selbstprüflauf, Rücksprung, Statusseite. **Sonst nichts.**
|
|
|
|
## Die fünf Regeln
|
|
|
|
### 1 · Das Betriebssystem kennt kein Produkt
|
|
|
|
Nirgends in dieser Ablage steht der Name eines Produkts — kein XinionONE, kein NEXTgenIT, kein OLYMPUS, kein
|
|
COSMOS, keine Fachlichkeit. Was ein Produkt braucht, bekommt es über den
|
|
[Nutzlast-Vertrag](nutzlast/VERTRAG.md).
|
|
|
|
Sobald hier ein Produktname auftaucht, ist der Vertrag falsch geschnitten. **Dann wird der Vertrag
|
|
geändert, nicht der Name durchgereicht.**
|
|
|
|
### 2 · Jede Abhängigkeit ist eine Verpflichtung
|
|
|
|
Was hier eingebaut wird, steht in der Stückliste, muss im Schwachstellenprozess beobachtet und nach
|
|
dem Cyber Resilience Act über die Produktlebensdauer versorgt werden — **für jedes Gerät jedes
|
|
Kunden.**
|
|
|
|
Deshalb: **Standardbibliothek vor Paket, Paket vor Fremdablage.** Eine Bequemlichkeit heute ist
|
|
fünf Jahre Pflege. Wer eine Abhängigkeit aufnimmt, schreibt in den Commit-Text, warum es ohne sie
|
|
nicht ging.
|
|
|
|
### 3 · Was die Distribution liefert, bleibt unangetastet
|
|
|
|
Kern, Startlader und Prüfglied kommen aus dem offiziellen Ubuntu-Abbild. Wir legen darauf, wir
|
|
ersetzen nicht. Der Grund ist die Zertifizierung durch die Serverhersteller und die signierte
|
|
Startkette — ein selbstgebautes System hätte beides nicht.
|
|
|
|
### 4 · Der Rücksprung ist die Kernzusage
|
|
|
|
Alles hier dient dem einen Satz: *Kommt eine neue Fassung nicht sauber hoch, kehrt das Gerät von
|
|
selbst zur vorherigen zurück.* **Nichts darf ihn umgehen** — kein Aktualisierungsdienst am
|
|
Updatekanal vorbei, kein Zustand außerhalb der Wurzel, keine Nutzlast, die sich selbst nachlädt.
|
|
|
|
Und er wird nur geprüft, wenn ihn jemand auslöst. Deshalb gibt es den Prüfschalter, und deshalb
|
|
gehört zu jeder Änderung an diesem Pfad ein neuer Nachweis.
|
|
|
|
### 5 · Nachweis am Gerät, nicht im Kopf
|
|
|
|
Was hier geschrieben wird, ist **Bauplan**. Belegt ist nur, was in `docs/nachweise/` steht — mit
|
|
Gerät, Zeitpunkt, Ablauf und der **echten Systemmeldung** statt einer Zusammenfassung darüber. Ein
|
|
Fehlschlag ist ein vollwertiger Nachweis.
|
|
|
|
## Sprache
|
|
|
|
Fachobjekte deutsch — *Wurzel, Fassung, Selbstprüflauf, Rücksprung, Nutzlast, Bestand*. Technik
|
|
englisch — *boot, target, unit, service*.
|
|
|
|
Dokumentation für Menschen: erst ein Absatz Prosa, der sagt worum es geht und warum es zählt, dann
|
|
Tabellen. Eine Entscheidung nennt immer ihren Grund.
|
|
|
|
## Git
|
|
|
|
Nur eigene Dateien stagen, kein `git add -A`. Commit-Text sagt, **was sich fachlich ändert**.
|