d9ed1bc2ff
Die Geraeteschicht — Abbild, zwei Wurzeln, Selbstprueflauf, Ruecksprung — verlaesst die Ablage der ersten Appliance und wird ein eigenes Erzeugnis mit eigenem Takt und eigenem Nachweis. Drei Gruende, nach Gewicht: Der Cyber Resilience Act verpflichtet fuer das gesamte Produkt einschliesslich der Betriebssystemschicht — vier gewachsene Basissysteme waeren vier Stuecklisten und vier Schwachstellenprozesse, eine gemeinsame Basis ist ein Dossier. Der Ruecksprung wird nur einmal richtig gebaut, weil er nur geprueft wird wenn ihn jemand braucht. Und eine abgegrenzte Aufgabe laesst sich ausschreiben, was unmittelbar auf das groesste benannte Risiko des Hauses einzahlt. Der Einwand der Vertraeglichkeitsmatrix wird durch den Nutzlast-Vertrag entkraeftet statt weggeredet: Die Nutzlast liegt in der Wurzel und wird mit ihr getauscht. Eine Fassung, ein Rueckweg, keine Matrix. Das OS kennt kein Produkt — Regel 1. Alle Namen sind entkoppelt, die Statusseite ist auf die Standardbibliothek umgestellt, weil jede Abhaengigkeit im Grund-OS eine Verpflichtung ueber die Produktlebensdauer ist. Nichts davon ist gelaufen. Der Inhalt gilt als Bauplan. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
77 lines
3.3 KiB
Markdown
77 lines
3.3 KiB
Markdown
# Briefing — XinionOS
|
|
|
|
> Für die Entwicklungsumgebung und für einen neu hinzukommenden Entwickler.
|
|
> **Erst lesen, dann anfangen.**
|
|
|
|
## Was dieses Erzeugnis ist
|
|
|
|
Das Betriebssystem der Xinion-Appliances. Ein Gerät, das startet, sich selbst prüft, sich sicher
|
|
aktualisieren lässt und im Fehlerfall **von allein** auf die vorherige Fassung zurückkehrt.
|
|
|
|
Es weiß nicht, was auf ihm läuft. Alles Fachliche kommt über den
|
|
[Nutzlast-Vertrag](nutzlast/VERTRAG.md).
|
|
|
|
## Rollenverteilung
|
|
|
|
| Wer | Was |
|
|
|---|---|
|
|
| Architektur (CIO und Entwurf) | entscheidet, **was** gebaut wird und warum |
|
|
| Entwicklung | baut es, bringt es zum Laufen, **misst** und legt den Nachweis ab |
|
|
|
|
**Begegnet der Bauplan der Wirklichkeit und verliert, ist das ein Befund und kein Auftrag zum
|
|
Umplanen.** Melde zurück, entwirf nicht neu. Faustregel: Musst Du eine Architekturentscheidung
|
|
anfassen, um weiterzukommen, ist es eine Entscheidung und keine Reparatur.
|
|
|
|
## Was zuerst zu bauen ist
|
|
|
|
**Das Abbild baut reproduzierbar, und der Rücksprung greift nachweislich.**
|
|
|
|
> Fällt der Selbstprüflauf auf einer Wurzel durch, kehrt das Gerät nach drei Startversuchen **von
|
|
> selbst** auf die andere zurück — und man kann hinterher nachlesen, warum.
|
|
|
|
### Der Nachweis, Schritt für Schritt
|
|
|
|
1. `abbild/bauen.sh <ubuntu-server.iso>` — Abbild bauen, in einer virtuellen Maschine installieren.
|
|
Das Gerät startet in **Wurzel A**.
|
|
2. Statusseite auf Anschluss 8080 aufrufen: Wurzel A, Fassung, Selbstprüflauf **bestanden**.
|
|
3. Wurzel B befüllen, Starteintrag mit drei Versuchen anlegen.
|
|
4. In Wurzel B `/etc/xinionos/selbstpruefung-scheitert` anlegen — der Prüfschalter.
|
|
5. Auf B umschalten, neu starten.
|
|
6. **Beobachten:** dreimal Fehlschlag, danach startet das Gerät **ohne Zutun** wieder in A.
|
|
7. Die Statusseite zeigt unter *Verlauf* drei durchgefallene Läufe auf B und darunter den
|
|
bestandenen auf A.
|
|
|
|
**Schritt 6 ist der Nachweis.** Ergebnis nach `docs/nachweise/`.
|
|
|
|
### Wo der erste Lauf voraussichtlich scheitert
|
|
|
|
Beim Anhängen von `autoinstall ds=nocloud;s=/cdrom/xinionos/` an die Startzeile — die Pfade zu
|
|
`grub.cfg` unterscheiden sich zwischen Ubuntu-Fassungen. **Startet das Medium und fragt trotzdem
|
|
nach der Sprache, liegt es dort und sonst nirgends.** Schnappschuss der VM vor dem ersten Versuch.
|
|
|
|
## Der Stand: nichts davon ist gelaufen
|
|
|
|
Der gesamte Inhalt ist auf einem Mac geschrieben worden, auf dem weder ein Ubuntu-Abbild gebaut
|
|
noch eine Unit gestartet werden kann. **Behandle ihn als Bauplan, nicht als Zustand.**
|
|
|
|
## Was Du nicht tust
|
|
|
|
* **Keine Architekturentscheidung treffen, keine ADR schreiben.** Melde zurück.
|
|
* **Keinen Produktnamen aufnehmen.** Weder NEXTgenIT noch OLYMPUS noch sonst einen — siehe Regel 1
|
|
in `CLAUDE.md`.
|
|
* **Keine Abhängigkeit ohne Begründung im Commit-Text.** Jede steht fünf Jahre in der Stückliste.
|
|
* **Keine Zahl erfinden und keine glätten.**
|
|
* **Kein `git add -A`.**
|
|
|
|
## Wo alles steht
|
|
|
|
| Was | Wo |
|
|
|---|---|
|
|
| Regeln | `CLAUDE.md` |
|
|
| Vertrag zur Nutzlast | `nutzlast/VERTRAG.md` |
|
|
| Startverfahren und Rücksprung | `docs/decisions/ADR-0002-startverfahren-und-ruecksprung.md` |
|
|
| Gemessene Ergebnisse | `docs/nachweise/` |
|
|
|
|
**Bei Widerspruch gilt:** ADR schlägt Dokumentation, **Messung schlägt ADR.** Eine Messung, die
|
|
einer Entscheidung widerspricht, ist der wertvollste Fund überhaupt — melde ihn, bevor Du
|
|
weiterbaust.
|