Files
rust-discovery/docs/project-decisions.md
T
2026-11-14 22:58:13 +01:00

371 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Verbindliche Projektentscheidungen
Stand: **2026-11-14**, Spezifikation **1.22** (`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.
## 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.