452 lines
35 KiB
Markdown
452 lines
35 KiB
Markdown
# Verbindliche Projektentscheidungen
|
||
|
||
Stand: **2026-11-16**, Spezifikation **1.28** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
|
||
|
||
## Windows-Abgleich 205 ausdrücklich historienerhaltend wiederherstellen (Version 1.28)
|
||
|
||
Der Betreiber hat den [konkreten Vorschlag](windows-sync-alignment-205-proposal.md)
|
||
am 16. November ausdrücklich mit „Ja, historienerhaltend wiederherstellen“
|
||
freigegeben. Der enge Fall betrifft genau die erhaltenen Entscheidungen
|
||
1a4758ad/2af359c5, die abgeschlossene Echohistorie und einen abgelaufenen
|
||
allgemeinen Auftrag ohne Grant. Ein neuer administrativer WebUI-Beleg,
|
||
unabhängige Originalprüfung und dauerhafte Herkunfts-/Anwendungszeile sind
|
||
Pflicht. Keine Identitäts-/Journalrücksetzung, keine Ready-/Unlockwirkung,
|
||
keine Anwendung mit künstlicher historischer Uhr. Erst regulärer neuer
|
||
SignedSync beider Rollen und jeder feste neue WebUI-Plan erlauben neue Jobs.
|
||
Die Freigabe gilt nicht für beliebige andere Abweichungen oder Unknowns.
|
||
|
||
## Technische Selbstupdatepräzisierung (Version 1.27)
|
||
|
||
Innerhalb des beauftragten Windows-MVP erhält der stabile Updater eine eigene
|
||
signierte Zeitrolle mit eigener geschützter Qualifikation. Er verwendet keine
|
||
Helperzeit als Ersatz. Das separate Handoffschema2 normiert den endlichen
|
||
einmaligen Rückweg mit Originalowner, unverlängerten Fristen, erhaltenen
|
||
Dateiversionen und neuem signiertem Vorgänger-Healthbeleg. Unklare Wirkungen
|
||
bleiben Unknown. Private Recordrechte werden durch einen authentisierten
|
||
lesenden Full-Metadatenbeleg erhalten, statt sie für den Agenten aufzuweiten.
|
||
Dies ändert weder die WebUI-Genehmigung noch den Umfang zu einem freien
|
||
Installer oder Updater-Selbstupdate. Die technischen Grenzen stehen in
|
||
Spezifikation0.1; native Installation/Apply/Rückführung werden weiterhin
|
||
ausdrücklich erst nach tatsächlicher Prüfung ausgewiesen.
|
||
|
||
## Windows-MVP vollständig fortsetzen (Version 1.26)
|
||
|
||
Der Betreiber beauftragt die verbleibenden Windows-MVP-Arbeiten möglichst
|
||
parallel. Der vorhandene dev/test-Login und die ausdrücklich gekennzeichnete
|
||
simulierte WebUI-Bedienung reichen auch für die folgenden festen Abnahmepläne;
|
||
OIDC wird keine neue MVP-Voraussetzung. Die zusätzliche Einschränkung auf den
|
||
bereits erfolgreich ausgeführten Echoauftrag darf nur durch einen eigenen
|
||
interaktiven administrativen Abschluss mit unabhängig geprüften Originalen
|
||
und append-only Nachweisen historienerhaltend beendet werden. Keine direkte
|
||
API-/DB-Jobgenehmigung, keine Journal- oder Identitätsrücksetzung. Der Abschluss
|
||
verleiht weder Bereitschaft noch eine Jobgenehmigung. Regulärer unabhängiger
|
||
SignedSync beider Rollen und jeder feste WebUI-genehmigte Job bleiben nötig.
|
||
|
||
Die parallelen Quellarbeiten und tatsächlichen nativen Abnahmen werden in
|
||
[windows-mvp-completion.md](windows-mvp-completion.md) getrennt protokolliert.
|
||
Ein Updater-OS-Port oder ein Build ist kein durchgeführtes Selbstupdate.
|
||
|
||
## MVP-Verwaltung über SSH-Tunnel ohne OIDC (Version 1.25)
|
||
|
||
Der Betreiber hat klargestellt, dass kein OIDC-Anbieter vorhanden ist.
|
||
WebUI und MCP sollen für den MVP nur an Loopback erreichbar sein. Die
|
||
Bedienung erfolgt durch einen SSH-Tunnel. Der vorhandene Entwicklungslogin
|
||
und die ausdrücklich erlaubte simulierte WebUI-Genehmigung werden für
|
||
den PowerShell-Test verwendet. Die zusätzliche OIDC-Abhängigkeit war eine
|
||
Implementierungsentscheidung der KI, keine ursprüngliche MVP-Anforderung.
|
||
Die tatsächlichen Dienst- und Abnahmenachweise bleiben erforderlich.
|
||
|
||
## Historienerhaltende Windows-Recovery ausdrücklich beauftragt (Version 1.24)
|
||
|
||
Der Betreiber hat die Wiederherstellung des dokumentierten wirkungslosen
|
||
Windows-Testfalls mit Erhalt von Identität und allen Journalen erlaubt.
|
||
Kapitel 0 bindet die beiden erhaltenen Originalentscheidungen 6755 und 6756.
|
||
Die bisherigen Regeln für ungesendete Requests behandeln diesen Fall nicht.
|
||
Der neue administrative Weg braucht einen überprüfbaren historischen
|
||
Abgleich, dauerhaftes Audit und anschließend einen normalen signierten Sync.
|
||
Die Ausführungsjobs erhalten jeweils ihren eigenen WebUI-genehmigten Plan.
|
||
Implementierung und tatsächliche Abnahmen bleiben getrennt nachzuweisen.
|
||
|
||
## Aktives Windows-KVM-Zeitprofil ausdrücklich erlaubt (Version1.23)
|
||
|
||
2026-11-15: „Ja, dieses begrenzte Zeitprofil umsetzen“. Der ausdrücklich
|
||
versionierte Opt-in-Modus `trusted_os_active_guest` vertraut den dokumentierten
|
||
Windows-/KVM-/Hardwarezeitgebern als nomineller OS-Intervalluhr. Eine zusätzliche
|
||
unabhängige physikalische Timerkalibrierung entfällt ausschließlich hier; keine
|
||
willkürliche Kalibrierungszahl oder gemessene SI-Genauigkeit behaupten.
|
||
Geschützte Rollen-/Image-/Plattform-/Belegbindung, eigene konservative
|
||
Softwarebrackets, signierter Serververgleich, kurze Fristen und WebUI bleiben.
|
||
Vor Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend müssen
|
||
Agent und Helper beendet und danach frisch gestartet werden. Laufende Prozesse
|
||
über solche Ereignisse sind nicht unterstützt; keine lückenlose Erkennung
|
||
ohne VMGenID behaupten. Kein automatischer Konfigurations-/Clockgatewechsel.
|
||
[Angenommener konkreter Vertrag](windows-kvm-clock-contract-proposal.md),
|
||
normativ SpezifikationKapitel0/1.23. Neue reale Nachweise weiter erforderlich.
|
||
|
||
## Signierter Windows-Zeitvergleich ausdrücklich erlaubt (Version1.22)
|
||
|
||
2026-11-14 hat der User den konkret beschriebenen alternativen Zeitvergleich
|
||
mit „Ja, signierten Zeitvergleich umsetzen“ angenommen. Die unabhängige
|
||
Agent-/SYSTEM-Prüfung und bestehende WebUI-/Zeitgrenzen bleiben verbindlich.
|
||
Kapitel0 der Spezifikation1.22 ersetzt den früheren Ausschluss eines
|
||
Serverzeitankers ausschließlich durch den gebundenen Onlinevergleich mit dem
|
||
festgelegten Server. Separater Ed25519-Pin, eigene Challenges/Timer je Verifier,
|
||
mTLS-Geräte-/Verbindungsbindung, vollständiger RTT im Unsicherheitsintervall,
|
||
kein Holdover und kein neuer Grant durch Belegrefresh. W32Time-Rohstatus bleibt
|
||
separat; keine Zeitstellung, kein manueller Resync hiermit genehmigt.
|
||
|
||
[Vertrag und offene Nachweise](windows-clock-attestation-proposal.md).
|
||
Angenommene Produktentscheidung, noch keine qualifizierte Zeitquelle oder
|
||
Windowsjobfreigabe. Fehlende tatsächliche Server-/Timerqualität bleibt deny.
|
||
|
||
## Präzisierung des engen Updatervertrags (Version1.21)
|
||
|
||
Healthsignatur und vor Genehmigung gebundener lokaler öffentlicher Healthpin
|
||
verwenden einen separat provisionierten Schlüssel; kein Jobsignerfallback.
|
||
Auf Linux autorisiert und prüft Full den Updateowner. General bleibt während
|
||
des Inflightfalls geschlossen, ohne aus Nichtzuständigkeit Unknown zu erzeugen.
|
||
Keine Capabilitylockerung umgeht die tatsächliche Prozessimageprüfung.
|
||
Native Dateiteilintents und Stop-/Startbeobachtungen gehören append-only an den
|
||
Originalhandoff im selben Ledger. ReturnIntent und feste Startreservation
|
||
committen vor Lockabgabe; keine Zeile erlaubt späteren Workerresume.
|
||
Details und offene Runtimegrenzen stehen in Spezifikation0.1 und
|
||
[agent-updater-handoff.md](agent-updater-handoff.md).
|
||
|
||
## Agent-Selbstupdate parallel, eng gebunden (Version1.21)
|
||
|
||
Auf ausdrücklichen Userwunsch wird ausschließlich der signierte Agentupdater
|
||
parallel ausM7 vorgezogen. `update_agent` bleibt fester, tatsächlich WebUI-
|
||
genehmigter Job mit `updates:apply` plus Root-/SYSTEM-Recht für beide Akteure,
|
||
separatem immutable Releasekatalog und zwei gebundenen Rohbinaries. Altes
|
||
Paketlimit bleibt bestehen; Update-only-Streaming ist keine allgemeine
|
||
Installer-/Dateiupload-/Rootskriptfreigabe. Passive Beobachtung `agent.update`
|
||
alle60s ist von Baseinventar und täglichem Releasecheck getrennt; fehlende
|
||
Provisionierung/Qualifikation erzeugt `not_configured`, niemals Applybereitschaft.
|
||
|
||
Der verbindliche Handoff-/Owner-/Inflight-/Healthvertrag steht in Kapitel0.1.
|
||
Atomarer Originalverbrauch+Start+Handoff+Delegation+Stopintent im erhaltenen
|
||
Helperledger, echter gemeinsamer Lock nur während Helperstop, Rückgabe vor
|
||
neuem Helperstart und exakter eigener Inflightabgleich bei Ready=false sind
|
||
Pflicht. Kein zusätzlicher ungebundener Server-Journalslot oder Unknown-Healing.
|
||
Die nur für diese Aktion signierte `agent_update_plan_id` erhält alte Grantbytes
|
||
bei allen anderen Aktionen. Fullpins werden eng aus konkreten geschützten
|
||
Rawbytes gerendert; zentrale Fullrechte werden nicht automatisch migriert.
|
||
|
||
Erste Baseline und erlaubtes Rollback müssen bereits die neue Update-/Handoff-
|
||
Historie dekodieren können. Das aktuelle1.20-Codepaar ist daher kein späteres
|
||
Rollbackziel. Erhaltender kompatibler Bootstrap, separat release-signierter
|
||
InstalledRecord/Floor und tatsächliche Linux-first-Qualifikation sind vor dem
|
||
ersten Apply erforderlich. Keine Daten-/PKI-/Generation-/Journalrücksetzung.
|
||
|
||
Quelle ist kein Applynachweis: isolierter Verifier/Handoffkernel und lokale
|
||
OS-/SQL-/UIteile sind getrennt dokumentiert. Unabhängige Reviews und tatsächliche
|
||
Messwerte stehen in den verlinkten Updaterberichten; Workerinstallation,
|
||
genehmigter realer Codewechsel und Windowsnachweis bleiben eigene Gates.
|
||
|
||
## Skriptkonsole und vollständige Hostwartung (Version1.20)
|
||
|
||
Der User stellt die Batch-Skriptkonsole vor weitere Paketfixture-Erweiterungen:
|
||
KI/MCP schreibt vollständige Shell-/PowerShell-Skripte und beantragt feste
|
||
Aufträge; der Mensch genehmigt exakt gespeicherte Bytes, Ziele, Interpreter,
|
||
Argumente, Rechte und Limits in der WebUI. Status und abschließende begrenzte
|
||
Rohbyteausgabe verwenden die bestehende Jobstrecke. Keine neue PTY-/ConPTY-
|
||
Sitzung und kein behauptetes laufendes Streaming. Regelmäßiges passives
|
||
Inventar/Heartbeat ist getrennt; Live-Erhebung per Skript bleibt Job.
|
||
|
||
Das neue additive Feld `privileged_script_profile="full_maintenance_v1"`
|
||
bindet die ausdrücklich gewünschte Root-/SYSTEM-Hostwartung vor Genehmigung.
|
||
Fehlend bleibt es aus alten Bytes ausgelassen; null/unbekannt/agent_service mit
|
||
Profil verweigert. Bestehende Linux-Root-Skripte ohne Profil behalten ihre
|
||
bisherige begrenzte Runtime. Windows-SYSTEM-Skripte brauchen das neue Profil;
|
||
SCM-/MSI-Policies erben keine Skripterlaubnis. Die historische Aussage1.18
|
||
„SYSTEM-Skripte außerhalb des engen SCM-Vertrags“ bleibt für dessen Profile
|
||
richtig; sie verbietet nicht den nun gesondert beauftragten Vollwartungspfad.
|
||
|
||
Zentrale/lokale Policy erlauben Vollwartung nur ausdrücklich versioniert über
|
||
`allowed_script_profiles`: Linuxversion2, Windowsversion3; fehlend bedeutet deny,
|
||
vorhandene null/unbekannte Profile verweigern. `scripts:execute` plus jeweiliges
|
||
`root:execute`/`system:execute` gelten für Ersteller und Freigeber aktuell;
|
||
zusätzlich exakte Geräte-/Helperpins, qualifizierte Capability
|
||
`script.full_maintenance/1`, TrustedClock und unabhängiger signierter Sync.
|
||
Linux bekommt ein eigenes explizites Helperprofil; bisherige General-/APT-
|
||
Sandboxprofile bleiben erhalten. Windows verwendet SID18 und einen eigenständig
|
||
geprüften SYSTEM-Pfad. Volle Originalsignaturen, dauerhafter Einmalverbrauch,
|
||
Intent/Dispatch/RawMirror/Abandon und Journalidentitäten werden weiterverwendet.
|
||
|
||
Vollwartung ist volle Hostautorität, einschließlich möglicher Agent-/PKI-
|
||
Änderungen und Neustarts. Keine Sandbox-/No-Reboot-/Rollbackzusage für beliebigen
|
||
Root-/SYSTEM-Code; nachgeladener Inhalt ist nicht automatisch gebunden. Jede
|
||
Wirkung braucht ihren festen WebUI-Plan. Kein ungeplanter destruktiver Test,
|
||
keine Rebootabnahme aus einem Skript. Timeout/Abbruch/unklare Wirkung bleiben
|
||
ehrlich `unknown`, kein automatischer Retry oder nachträgliches Heilen durch
|
||
Exit0. Eigene Prozesse werden kontrolliert beendet, fremde nicht übernommen.
|
||
Die konkreten Bounds und Kompatibilitätsregeln stehen in Spezifikation0.1.
|
||
|
||
Dies ändert den Produktauftrag, behauptet keine Implementierung oder native
|
||
Abnahme. Linux-Cloud-VM zuerst; Windows-VM separat; Notebook nur Entwicklung.
|
||
Die zusätzliche tatsächliche Linux-Helperbinarybindung des Fullprofils ist
|
||
verpflichtend: geschützter Schema2-Pin, gehaltenes laufendes Rootimage,
|
||
authentisierte Probe und passende zusätzliche Binärcapability; keine
|
||
Agent-/proc-Lesebehauptung und keine Änderung der General-/APT-Legacybytes.
|
||
Lokale frühere Qualifikation und noch offener separater Korrekturdurchlauf:
|
||
[deploy/linux/full-maintenance-README.md](../deploy/linux/full-maintenance-README.md).
|
||
Agent-Selbstupdates sind ein getrennter signierter Updatepfad; APT/MSI-
|
||
Paketfixtures und Vollwartungsskripte sind keine fertigen Agent-Autoupdater.
|
||
|
||
## Enger Windows-M4-MSI-Schnitt (Version1.19)
|
||
|
||
Die beauftragte Windows-MVP-Fortsetzung erhält als nächsten getrennten Schnitt
|
||
zwei feste eigene MSI-Rezepte1.0 und1.0→1.1. Dies ist eine explizite technische
|
||
Präzisierung innerhalb des bereits beauftragten M4-Umfangs, keine neue pauschale
|
||
Userfreigabe für Paketwirkungen. Kapitel0 bindet vollständiges optionales
|
||
Windowsmanifest, unveränderlichen Tenantkatalog, exakte automatisch abgeleitete
|
||
Job-/Versuch-/Artefaktreferenz, neue getrennte SYSTEM-Paketerlaubnis und sichtbare
|
||
Planbytes. Alte SCM-only-Policies erteilen keine Paketrechte. Native
|
||
Installation/Upgrade/Noop bleiben jeweils eigene WebUI-genehmigte Jobs.
|
||
|
||
APT-/Windowsmanifest schließen sich aus; alte Linuxbytes und freie Linux-
|
||
Artefaktpfade behalten ihre bisherigen Verträge. Kein freier Installer oder
|
||
Rezeptargumentvektor, kein Repair/Downgrade/Fresh1.1, keine EXE-/Skript-/Reboot-
|
||
Erlaubnis in diesem Schnitt. Cache-/Provider-/Installerwirkung bleibt bei
|
||
Abandon ausgeschlossen. Noop und tatsächliche Nachbedingungen müssen innerhalb
|
||
des ursprünglichen Budgets unter gültigem Clock-/Fence-/Abbruchkontext liegen.
|
||
Ein später belegter Zustand heilt keinen Timeout. Die ursprünglichen MSI-
|
||
Artefakt- und Nativeberichte bleiben unverändert. Quelle/Build/Unitnachweis
|
||
öffnet keine Capability und ist keine tatsächliche Paketabnahme.
|
||
|
||
## Begrenzte Windowsfreigaben des Users (Version1.18)
|
||
|
||
- `RemoteSigned` ist ausschließlich für den einzelnen zuvor WebUI-genehmigten
|
||
Windows-PowerShell5.1-Jobprozess erlaubt. Die feste Prozessoption muss vor
|
||
Genehmigung sichtbar im unveränderlichen Plan stehen und in den signierten
|
||
Originaljobbytes gebunden sein. Kein stilles Nachrüsten alter Pläne, kein
|
||
`Bypass`/`Unrestricted`, keine persistente CurrentUser-/Maschinen-/GPOänderung
|
||
durch den Executor. GPO-Vorgaben bleiben wirksam; Linux und andere Interpreter
|
||
erhalten keinen solchen Override. SYSTEM-Skripte bleiben außerhalb des engen
|
||
SYSTEM-SCM-Vertrags. [Entwurf und Nachweisgrenzen](windows-powershell-policy.md).
|
||
- Der bestehende `W32Time` darf gezielt gestartet werden. Startart, NTPserver/
|
||
Peers und ACLs dürfen hierfür nicht verändert werden. Ein laufender Dienst
|
||
eröffnet keine TrustedClock-/Syncbereitschaft; diese braucht eigene tatsächliche
|
||
Status-/Unsicherheits-/Bootnachweise.
|
||
- Ein manueller Windows-VM-Konsolenneustart ist für später zugesagt, erst nach
|
||
ausdrücklicher Zeitabstimmung. Kein Remote-Reboot, kein RMM-Reboottest und kein
|
||
daraus erfundener Rebootjob-Erfolgsnachweis. Der Notebookhost bleibt reiner
|
||
Entwicklungsrechner.
|
||
|
||
Diese Userfreigaben sind dokumentierte Entscheidungen, keine Ausführungs- oder
|
||
Implementierungsnachweise. Die RemoteSigned-Vertragserweiterung ist zunächst
|
||
ein Entwurf; laufende qualifizierte Quellbindungen werden dafür nicht verändert.
|
||
Clock-, Boot-, Genehmigungs- und native Capabilitygates bleiben geschlossen,
|
||
solange ihr jeweiliger tatsächlicher Nachweis fehlt.
|
||
|
||
## Nachgewiesener Nichtstart vor SYSTEM-Delegation (Version1.17)
|
||
|
||
Der Source-Review der vorbereiteten SCM-Runtime zeigte, dass vorzeitiger lokaler
|
||
Verbrauch ohne Helperzeile den strengen gemeinsamen Sync dauerhaft sperren würde.
|
||
Der Fix erhält sämtliche Missing-Row-Grenzen: dauerhafter Intent vor Socket,
|
||
atomarer Dispatchmarker, deny-only Abandon nur bei belegter Nichtübergabe und
|
||
vollständiger authentisierter Snapshotabgleich vor Network-Ledgerspiegelung.
|
||
Abandon erhält den Originalgrant und darf ausschließlich unter geprüfter
|
||
Signatur/Identität/Clock/Boot/Helper-Lineage einen Nichtstart-Tombstone anlegen;
|
||
nie bestehende Outcomes/Unknown überschreiben oder eine OS-Aktion ausführen.
|
||
Mehrdeutige Übergaben bleiben Unknown, kein Execute-Retry und keine neue
|
||
Genehmigung durch Policy oder Abandon. Historische Signaturprüfung ist keine
|
||
Live-Ausführungsberechtigung. Dies ist ein Implementierungsvertrag, noch keine
|
||
ausgeführte Abnahme; [Details](windows-system-abandon.md).
|
||
|
||
## Getrennte Windows-SYSTEM-Identität (Version1.16)
|
||
|
||
Technische Präzisierung der beauftragten Windows-Helpertrennung:
|
||
`execution_identity=system` benötigt eigenes `system:execute`; Linux-Rootrechte
|
||
enthalten dieses Recht nicht. Die erste enge Aktionsstrecke betrifft nur eigene
|
||
Fixturedienste und `running|stopped`. Zentrale konkrete Geräte-/Principal-/
|
||
Helperhashpolicy und unabhängig prüfender lokaler SYSTEM-Helper begrenzen beide;
|
||
keine Policy genehmigt einen Job. Alle bisherigen Plan-/WebUI-/Signatur-/Clock-/
|
||
Journal-/Einmalwirkungsgrenzen bleiben erhalten, einschließlich beider aktuellen
|
||
Akteursrechte bei Genehmigung/Zustellung/Start. Kein Start ohne tatsächlichen
|
||
Helperjournalbezug und bestätigten Sync. Standard ist deaktiviert; keine
|
||
Windowscapability aus Linux-Units, Crossbuild oder Bootstrap ableiten.
|
||
Dies ist keine ausgeführte Windowsaktion oder zusätzliche Scopeerteilung.
|
||
[Implementierung und tatsächliche Nachweise](windows-system-policy.md).
|
||
|
||
## Rechtzeitiger Rebootkontakt und spätere frische Verifikation (Version1.14)
|
||
|
||
Die feste180s-MVP-Frist wird nicht verändert. Ein rechtzeitig gespeicherter
|
||
Originalbeleg wird bei späterer Erstverifikation zusammen mit einem zweiten,
|
||
frischen Beleg derselben aktuellen Boot-ID und dem tatsächlichen aktuellen
|
||
authentisierten Gerätekontext geprüft. Signiertes Ergebnis bindet Original-
|
||
`inventory_message_id`/`inventory_received_at` und zusätzliche
|
||
`verification_inventory_message_id`/`verification_inventory_received_at`;
|
||
Audit bindet Job/Versuch/Grant/Boot/Generation und beide Datenbankbelege.
|
||
Verspäteter Originalkontakt, falscher Boot/Kunde/Agent/Generation oder fehlende
|
||
aktuelle Verifikation bleiben verweigert. Grundlage: tatsächlicher rechtzeitiger
|
||
Rebootkontakt bei zunächst clock-bedingt ausgefallenem Helper, keine neue
|
||
Rebootfreigabe oder erfundene rückwirkende Fristeinhaltung. Details:
|
||
[Rebootabnahme](reboot-acceptance.md).
|
||
|
||
## Gebundene Paket- und Rebootnachbedingungen (Version1.13)
|
||
|
||
`no_reboot` verbietet einen ungeplanten Neustart, kein wahrheitsgemäßes
|
||
`reboot_required=true` bei vollständig verifiziertem Paket. Die harmlosen
|
||
APT-Fixturen müssen das Hostflag vor/nach der Wirkung unverändert nachweisen;
|
||
Sandbox-/Hostbeobachtung sind getrennt. Alte fehlende Vorhermessungen bleiben
|
||
fehlend, keine rückwirkende erfolgreiche Acceptance oder Markerbereinigung.
|
||
|
||
Die zentrale Rebootfrist beginnt konservativ an der dauerhaften
|
||
Startreservierung. Erfolg benötigt unabhängig empfangenes neues Bootinventar
|
||
innerhalb dieser Frist; Unknown bleibt bei fehlendem/verspätetem Nachweis.
|
||
Späterer signierter Sync verwendet ausschließlich den ursprünglichen
|
||
rechtzeitigen Erfolgsbeleg. Quelle: Spezifikation0 und
|
||
[Rebootvertrag samt tatsächlichen lokalen Prüfungen](reboot-acceptance.md).
|
||
Diese Präzisierung ist keine native Paket-/Rebootabnahme.
|
||
|
||
## Einzelner signierter APT-Wiederaufnahmeversuch (2026-11-13)
|
||
|
||
Die ausdrücklich beauftragte Fortsetzung des bekannten Pre-Hook-Fehlers erhält
|
||
keinen Markerreset. Ein neuer UI-genehmigter Plan bindet im Manifestschema 3
|
||
ursprünglichen Grant/Versuch und Markerhash. Helper prüft die ursprüngliche
|
||
Signatur und eindeutigen Fehlschlag im gleichen Ledger, unveränderte Transaktion
|
||
und Baseline. Genau ein eigener dauerhafter Retrymarker; bei Unknown, Hook,
|
||
geändertem Zustand oder bestehendem Retry keine Wirkung. Schema 2 bleibt
|
||
bytekompatibel. Vertrag und reale Nachweise separat in Spezifikation 0.1 und
|
||
`implementation-status.md`; keine implizite Produktions-/MVP-Freigabe.
|
||
|
||
## Windows parallel auf ausdrücklichen Userwunsch (2026-11-13)
|
||
|
||
- Windows 11 darf jetzt parallel entwickelt/nativ getestet werden, obwohl die
|
||
Linux-MVP-Abnahme noch offen ist. Dies überstimmt ausschließlich die frühere
|
||
Wartepflicht; Linux-Abnahme bleibt eigenständig und wird nicht vorgetäuscht.
|
||
- Windows-Gast auf dem Notebook ist ein eigenes Testgerät. Notebook-Host bleibt
|
||
Entwicklungsrechner ohne RMM-Agenten. Endgültiger Server bleibt unverändert.
|
||
- User wünscht ein PowerShell-Bootstrap-Skript mit Reverse-Tunnel zum Cloudserver.
|
||
Eng begrenzter separater Tunnelzugang, nur Loopbacklistener, eigener temporärer
|
||
Schlüssel; keine Weitergabe des Notebook-Hauptschlüssels. SSH-Hostprüfung gilt
|
||
auch für den neuen Windows-Gast. Installation/Ausführung noch nicht nachgewiesen.
|
||
- RMM-Jobs auf Windows weiterhin nur nach festem WebUI-genehmigtem Plan.
|
||
|
||
## Serverumzug auf ausdrücklichen Userwunsch (2026-11-13)
|
||
|
||
- Dieses Notebook ausschließlich zur Entwicklung nutzen: weder RMM-Server noch
|
||
installierter/enrollter RMM-Client. Ausdrückliche Userkorrektur nach der
|
||
vorübergehenden Clientinstallation, die gestoppt/deinstalliert und widerrufen wurde.
|
||
- Aktueller Testaufbau: Cloud-Test-VM als Client, endgültiger Cloudserver
|
||
`discovery.ease-technologies.de` als Server. Backend, PostgreSQL und TLS dort;
|
||
Cloud-VM und später beauftragte weitere Geräte verbinden sich direkt ausgehend.
|
||
- Frühere lokale Docker-/Reverse-SSH-Topologie ist historisch überstimmt.
|
||
Dockerports bleiben Loopback; Datenbank nicht veröffentlichen. Separater
|
||
öffentlicher TLS-Ingress, keine öffentliche Dev-Anmeldung. Verwaltung zunächst
|
||
nur über SSH-Tunnel, bis Domain/öffentliche Anmeldung sicher eingerichtet sind.
|
||
- Root ausschließlich Bootstrap, unprivilegierter Anwendungsdienst. Keine
|
||
Ausnahme von TLS/mTLS, Mandantengrenzen oder WebUI-Jobgenehmigung.
|
||
- Der User hat die Neuerzeugung des nicht verfügbaren alten lokalen Serverstands
|
||
erlaubt. Neuer Testbestand ist keine Wiederherstellung alter Historie oder
|
||
Vertrauenskontinuität; vorhandene VM-Identitäten/Journale bleiben erhalten.
|
||
- Details, Konfigurationslücken und reale Nachweise: [server-deployment.md](server-deployment.md).
|
||
|
||
## Produkt und Ausbaustufen
|
||
|
||
- **Linux-first für ALLE Features:** Zuerst tatsächliche Ausführung und Nachweis auf der Linux-Test-VM, nicht nur PC-/Containerlauf, Simulator oder Cross-Build.
|
||
- **Erstes Phasenziel Linux-MVP (M0–M5):** Eigenständiger Linux-Agent x86-64, WebUI, MCP und autorisierte dauerhafte Jobs. Windows-x86-64-Implementierung und native Abnahmen folgen erst nach dokumentierter Linux-MVP-Abnahme. Physische Geräte und beliebige VMs sind gleichberechtigt; ein Gast mit unbekanntem Host/Hypervisor ist vollständig verwaltbar. Kein PVE-Agent, Proxmox-Host oder Hypervisorzugang erforderlich.
|
||
- **Noch später:** M6a: Monitoringausbau und ARM64 mit nativen Tests. M6b: Proxmox-Modul/-Client auf demselben Linux-Agenten, Cluster und Backupbeobachtung samt Abnahmen; PBS optional. Keine vorgezogene PVE-Implementierung/-Abnahme als Teil des Linux-MVP oder vor der Windows-Phase.
|
||
- **Weitere Betriebsreife (M7):** Terminal, signierte Agentupdates, Restoreverfahren, Lasttests und belastbarer Betrieb. M8 bewahrt optionale Geschäftsleistungen und zusätzliche Provider.
|
||
- Keine eigene grafische Fernsteuerung; RustDesk bleibt eine getrennte Anwendung mit eigener Infrastruktur.
|
||
- **Neuer Useroverride 2026-11-12:** „rustdesk musst du nicht machen ... das lasse aus“. RustDesk entfällt vollständig aus dieser Umsetzung: keine Installation, Profile/Provisionierung oder externe Desktopabnahme. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft die drei übrigen Referenzabläufe ohne RustDesk. Bestehende RustDesk-Architekturtexte sind nur spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Keine eigene Desktop-Engine als Ersatz.
|
||
|
||
## WebUI-Genehmigung für alle Jobs
|
||
|
||
Die folgenden Produktregeln bleiben unverändert. Ausschließlich für diese Entwicklungsabnahme gilt die danach dokumentierte Bedienungsausnahme; kein Job darf die UI-Genehmigung überspringen.
|
||
|
||
- Jeder zur Ausführung eingestellte Job aus Menschen/UI, MCP oder Automatik benötigt vorher explizite Genehmigung eines berechtigten Menschen in der WebUI. Das gilt bereits für Hello World und ebenso für Live-Diagnosen, Reboot-Folgejobs und Retry/neue Versuche.
|
||
- `operations.plan` speichert einen unveränderlichen Plan. `operations.submit` speichert ausschließlich einen dauerhaften Antrag `pending_approval` mit `operation_id`, noch keine ausführbaren Jobs oder Outbox. `jobs.get(operation_id)` zeigt diesen Antrag auch ohne Jobs.
|
||
- Die WebUI zeigt alle festen Einzeljobs/Versuche, Zielanzahl und Zielgeräte, Inhalte und Skript-/Paketbyteshash, Fristen und Auswirkungen. Explizite Sammelgenehmigung dieses festen Pakets ist möglich; Dauer-/Wildcardfreigaben nicht. Erst Genehmigung erzeugt atomar Nachweis, Ausführung, Jobs und Outbox. JobOffer und Startgrant sind vorher verboten.
|
||
- Policies dürfen nur begrenzen oder verweigern. MCP darf vorbereiten und beantragen, niemals genehmigen. MCP-/Automatisierungstokens sind selbst mit Approver-Rolle nicht freigabefähig; Freigabe verlangt authentisierten interaktiven WebUI-Kontext.
|
||
- Geänderte Ziele, Bytes, Parameter, Fristen oder neue Versuche erfordern einen neuen menschlich genehmigten Plan. Redelivery desselben Versuchs erfordert keine neue Genehmigung, erlaubt aber keine zweite Wirkung. Technischer Grant-Ersatz nur bei nachgewiesenem Nichtstart und gültiger ursprünglicher Genehmigung.
|
||
- Passive Standardtelemetrie/Heartbeat und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Neue Live-Erhebung darf nicht als passive Telemetrie umgangen werden. Gebundene Nachprüfungen gehören zum genehmigten Job.
|
||
|
||
### Explizite Userentscheidung zur Entwicklungsabnahme (2026-11-12)
|
||
|
||
Der User hat neu ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“.
|
||
|
||
- Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des angezeigten unveränderlichen Plans durchführen. Der Testprincipal muss deutlich sichtbar als **simulierter Testprincipal** gekennzeichnet sein; keine tatsächliche menschliche Identität vortäuschen.
|
||
- Dies ist die einzige erlaubte simulierte Freigabe/Testausnahme, keine Dev-Autofreigabe, Testpolicy oder Code-Abkürzung. Jeder Job bleibt bis zur interaktiven UI-Genehmigung `pending_approval`; vorher keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten.
|
||
- Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr kennzeichnen und Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar zuordnen. Das sind Umsetzungsanforderungen, keine Behauptung bereits vorhandener Auditfelder oder bestandener Tests. Simulation und tatsächliche menschliche Genehmigung getrennt nachweisen; **kein Produktions-Freigabenachweis**.
|
||
- KI/MCP dürfen weiterhin **keine direkten API-/DB-Freigaben** vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale, über die WebUI ausgelöste Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten und tatsächliche menschliche WebUI-Genehmigung in Produktion bleiben unverändert; die Simulation darf dort nicht verfügbar sein.
|
||
- Lokale Serverneustarts sind ausdrücklich erlaubt. Keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. RMM-Jobs behalten ihren festen WebUI-genehmigten Plan.
|
||
|
||
Die frühere absolute Aussage „keine simulierte Freigabe und keine Testausnahme“ wird ausschließlich für diese browsergesteuerte dev/test-Bedienung präzisiert. Spezifikation 1.5 Kapitel 0.1 ordnet diese Ausnahme den fortbestehenden Produktregeln zu. Linux-first, reale VM-Nachweise, TLS und Credentialregeln bleiben unverändert. Dokumentierte Erlaubnis ist keine ausgeführte Simulation oder Linux-MVP-Abnahme.
|
||
|
||
## Verständliche Startdefaults
|
||
|
||
| Bereich | Startwert / Bedeutung |
|
||
| --- | --- |
|
||
| Architektur | Modularer Rust-Monolith, getrennt startbare API/Gateway/Worker; React/TypeScript-WebUI, PostgreSQL, kein obligatorischer Broker |
|
||
| Verbindung | Nur vom Agenten ausgehend: WSS über TLS 443, HTTPS Long Polling als Alternative; mTLS nach Enrollment |
|
||
| Kontakt | Heartbeat alle 30 s mit Jitter; nach 90 s `stale`, nach 180 s `unreachable` – kein Beweis, dass das Gerät ausgeschaltet ist |
|
||
| Daten | Systemmetriken alle 60 s; Vollinventar bei Start und täglich; Quelle und Datenalter immer sichtbar |
|
||
| Genehmigung | Immer erforderlich für Ausführungsjobs, nicht abschaltbar; keine erlaubende Defaultpolicy |
|
||
| Fristen | Planfrist ausdrücklich je Plan, UI-Vorschlag 24 h; Startgrant 60 s, nur für festen Versuch, kein neuer Offline-Start |
|
||
| Enrollment | Nachweis einmalig, 15 min; Gerätezertifikat 30 Tage, Rotation spätestens nach 20 Tagen beginnen |
|
||
| Rollout | Ein Rebootziel gleichzeitig je Abhängigkeitsgruppe; mehr Parallelität nur im menschlich genehmigten Plan innerhalb begrenzender Policies |
|
||
| Fehlende Konfiguration | `not_configured`; nur betroffene Integration sperren, keine Werte oder Erfolge erfinden |
|
||
|
||
Die vollständigen Limits und Plattformabnahmen stehen in der Spezifikation. ARM64 ist bis zur nativen Abnahme geplant, kein MVP-Supportversprechen. Lokale Testidentitäten sind ausschließlich im expliziten Entwicklungsprofil erlaubt, niemals im Produktionsprofil.
|
||
|
||
## Repository, Infrastruktur und Zugänge
|
||
|
||
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>
|
||
- SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`
|
||
- Bekannte RustDesk-Serveradresse: `rust.ease-technologies.de`. **Edition, Ports, öffentlicher Serverschlüssel und Version sind noch unbekannt.** Kein angenommenes Standardport-/443-/WSS-Profil und keine erfundene Version; vor Bereitstellung konkrete Konfiguration prüfen.
|
||
- Lokaler Zugangspfad: `credentials/` im Projekt, durch `.gitignore` ausgeschlossen und niemals committen. Hier wird nur der Pfad dokumentiert; Secrets werden dafür nicht gelesen. Dateien nur als Daten behandeln, niemals mit `source` oder `eval` ausführen. Keine Secrets in normalen Logs, Jobausgaben oder MCP-/LLM-Kontexte übernehmen.
|
||
- Benötigte Entwicklungs-/Testtools dürfen ausdrücklich installiert werden. Daraus folgt keine Genehmigung von Änderungen oder Neustarts auf Kundensystemen. Plattformjobs in Entwicklungsumgebungen behalten die WebUI-Genehmigungspflicht; nur die oben dokumentierte dev/test-Browsersimulation darf die tatsächliche menschliche Bedienung ersetzen. Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt.
|
||
|
||
## Verbindlicher lokaler Entwicklungsweg
|
||
|
||
**Historisch seit 2026-11-13:** Die folgende PC-Servertopologie wurde durch den
|
||
oben dokumentierten ausdrücklichen Serverumzug ersetzt. Credential-, TLS- und
|
||
Genehmigungsregeln gelten weiterhin.
|
||
|
||
- Regeln für alle AIs: `AGENTS.md`; geplanter, nicht getesteter Ablauf und Nachweisgates: `docs/development.md`.
|
||
- Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Ports ausschließlich Loopback, insbesondere `127.0.0.1:18443`. PC initiiert SSH zur VM mit `-N -T -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18443:127.0.0.1:18443`. SSH-Hostschlüssel vorher verifizieren, keine öffentliche Forward-Bindung.
|
||
- VM-Agent verbindet sich ausgehend über VM-Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`; auf der VM `/etc/hosts`: `127.0.0.1 rmm-dev.internal`, alternativ getesteter Connect-Override unter Erhalt von SNI/Namensprüfung. Dev-CA vertrauen, niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein Ersatz für Enrollment/mTLS, RMM-Autorisierung oder Genehmigung.
|
||
- VM-Daten: `credentials/linux-vm.conf`, Verzeichnis durch `.gitignore` ausgeschlossen, Modus 700 für `credentials/`, 600 für die Datei. Strikt als Daten parsen, kein `source`/`eval`; keine Secrets lesen/loggen/committen oder in LLM-Kontexte übernehmen.
|
||
- Auch Linux-Dev hat keine Jobfreigabeabkürzung: erst `pending_approval`, dann WebUI-Genehmigung durch einen berechtigten Menschen oder ausschließlich die oben dokumentierte dev/test-Browsersimulation. Passives Standardinventar ist kein Job. Keine impliziten Reboots, Updates oder destruktiven Tests auf dem Ziel; ausdrücklich gesondert abstimmen, RMM-Jobs zusätzlich über ihren festen Plan in der WebUI genehmigen.
|
||
- Kein Erfolg ohne realen Nachweis. Geplante Befehle und nicht ausgeführte Tests ausdrücklich so kennzeichnen; fehlende VM-Abnahme bleibt offen.
|
||
|
||
## Eng begrenzte Reparatur eines ungesendeten Kontrollrequests
|
||
|
||
Spezifikation 1.10 konkretisiert den existierenden Unknown-/Sync-Abgleich:
|
||
Root-Bootstrap ausschließlich im Entwicklungsprofil, vollständige originale
|
||
Zeugen, unabhängige lokale Signatur-/Inventarprüfung und separate kurzlebige
|
||
Kontrollquittung. Nur vorhandene wirkungslose signierte Ablehnung als gemeinsamer
|
||
monotoner Head; Faults und Quittung append-only archivieren. Keine Jobfreigabe,
|
||
Bereit-Lease, Änderung von Outcome oder Verbrauch, keine Journalrücksetzung.
|
||
Native Prüfung und Grenzen: `implementation-status.md`. Direkte API-/DB-
|
||
Jobfreigaben bleiben verboten; anschließende Paketwirkung benötigt neuen festen
|
||
WebUI-genehmigten Plan.
|
||
|
||
## Gebundene Configure-only-Wiederherstellung
|
||
|
||
Spezifikation1.11 präzisiert einen notwendigen neuen Ausführungsplan nach dem
|
||
abgeschlossenen APT-Teilwirkungsnachweis: Manifestschema4/native_recovery mit
|
||
Originalgrant/-versuch/Partial-Proof, Transaktionsschema2 ausschließlich
|
||
configure_only/Fixture1.0. Separate authentisierte Teilzustandsplanung;
|
||
normale Baselines bleiben strikt. Eigene Recoverymarker, kein Überschreiben
|
||
früherer Testmarker oder falsche Freshinstall-Acceptance. Jede Paketwirkung,
|
||
anschließendes Upgrade und beide Noops erhalten eigene tatsächliche WebUI-
|
||
Plangenehmigungen. Runtimeprobe allein ist kein Ausführungsnachweis.
|
||
|
||
## Endliches Journalbudget nach tatsächlichem Kapazitätsbefund
|
||
|
||
Spezifikation1.15 erhöht das weiterhin feste Budget pro Agentjournal/Agent-
|
||
oder Helperledger auf1GiB bei validierter4KiB-Seitengröße (262144Seiten).
|
||
Nach der früheren64→256MiB-Korrektur erreichte die vollständig erhaltene
|
||
Cloud-Sync-Historie auch256MiB während des Original-Rebootabschlusses.
|
||
Agenttransport wurde vor weiteren Diagnosezyklen angehalten. Qualifikation
|
||
verlangt Kopiereproduktion des alten Limits und versionierte Installation
|
||
mit erhaltenen DBinodes, sämtlichen alten Verbrauchs-/Signatur-/Historydaten
|
||
und genau demselben offenen Rebootversuch. Keine neue Wirkung/kein neuer Grant,
|
||
keine History-/Marker-Löschung und keine Fail-closed-Ausnahme. Native Prüfstände
|
||
stehen getrennt im [Journalbericht](journal-capacity.md); die Entscheidung
|
||
selbst behauptet keine bereits ausgeführte Installation. Kompaktierung bleibt
|
||
nach dem MVP.
|