Align MVP contributor guidance, native evidence and repeatable development deployment
This commit is contained in:
@@ -1,58 +1,28 @@
|
||||
# Verbindliche Regeln für alle Coding-KIs
|
||||
# Arbeiten an Rust Discovery
|
||||
|
||||
**Aktuelle Übergabe 17. November 2026:** Einstieg [docs/handover.md](docs/handover.md),
|
||||
konkrete geprüfte Verbindungswege [docs/operations-access.md](docs/operations-access.md).
|
||||
Codecheckpoint, tatsächlich installierte Artefakte, fremder WIP und alte Chronik
|
||||
sind dort getrennt. Der neue SYSTEM-Unknown ist keine Erweiterung der alten 221-
|
||||
Freigabe. Der Dokumentationsauftrag erteilt keine neue Risikoentscheidung.
|
||||
## Einstieg für jeden Auftrag
|
||||
|
||||
**Fokus für den MVP-Abschluss, 2026-11-16:** Aktuelle Bestandsaufnahme und
|
||||
Agentaufträge stehen in [docs/mvp-completion-plan.md](docs/mvp-completion-plan.md).
|
||||
Vor Fortsetzung dort das nächste offene Gate und seine Originalbelege prüfen.
|
||||
Ein Integrator koordiniert Zieländerungen, WebUI-Bedienung und Gitindex;
|
||||
Unteragents bearbeiten abgegrenzte Aufgaben. Bereits belegte Abnahmen nicht
|
||||
pauschal wiederholen. Neue Tests nur für notwendige Änderungen, konkrete Fehler
|
||||
oder betroffene Sicherheitsinvarianten. Dieser Ablauf ändert keine normativen
|
||||
Produktentscheidungen oder Genehmigungsgrenzen.
|
||||
1. Lies das [Produktziel, den geprüften Stand und den nächsten Schritt](docs/mvp-completion-plan.md). **Nur dort** steht die aktive Arbeitsreihenfolge. Die [Übergabe](docs/handover.md) nennt den passenden Betriebszugang. Eine datierte Abnahme oder ein alter Reparaturplan ist ein Beleg für seinen damaligen Stand.
|
||||
2. Benenne das Nutzerergebnis des gewählten Schritts, den schon vorhandenen Beleg und die fehlende Beobachtung. Lies vor Änderungen den betroffenen Code und Vertrag. Bei Produktentscheidungen gilt [Kapitel 0 der Spezifikation](Rust_RMM_Implementierungsspezifikation.md) mit dem jüngsten einschlägigen Nutzerentscheid. [Entscheidungsbuch](docs/project-decisions.md) und [Entwicklungsweg](docs/development.md) liefern den Hintergrund.
|
||||
3. Ein Integrator koordiniert Zielgeräte, gemeinsam genutzte Dateien, WebUI und Gitindex. Teilaufträge bekommen einen Dateibereich und ein prüfbares Ergebnis. Vorhandenen WIP mit `git status --short` abgrenzen, funktionierende Teilstrecken wiederverwenden und nur aufgabenbezogene Änderungen aufnehmen.
|
||||
4. Wenn eine frühere Grenze das Ziel behindert, kläre ihren Zweck und wähle die kleinste begründete Änderung. Technische Vereinfachungen dürfen direkt umgesetzt werden. Eine geänderte Produktentscheidung in Kapitel 0 und im Entscheidungsbuch festhalten. Eine unbekannte Wirkung eines früheren Jobs bleibt dabei unbekannt.
|
||||
5. Nach einem Schritt den Status **in derselben Planzeile** aktualisieren. Quelle, Artefakt, echter Zielkontakt und fachliche Abnahme getrennt belegen. Bei einem Hindernis die konkrete fehlende Beobachtung festhalten und am nächsten unabhängigen Liefergegenstand weiterarbeiten.
|
||||
|
||||
**Wiederaufnahme auf Userwunsch 2026-11-13.** Aktuelle Übergabe:
|
||||
[docs/handover.md](docs/handover.md). Neuer verbindlicher Topologieoverride:
|
||||
[docs/server-deployment.md](docs/server-deployment.md). Der Entwickler-PC ist
|
||||
kein RMM-Server mehr; der dedizierte Internetserver übernimmt diese Rolle.
|
||||
**Korrektur 2026-11-13:** Dieses Notebook ist ausschließlich Entwicklungsrechner.
|
||||
Hier keinen RMM-Client installieren, enrollen oder als Dienst starten. Aktueller
|
||||
Client ist die Cloud-Test-VM; der festgelegte Cloudserver bleibt endgültiger Server.
|
||||
## Was wir liefern
|
||||
|
||||
Diese Regeln gelten für alle AIs im gesamten Repository. Vor technischen Entscheidungen die **vollständige** `Rust_RMM_Implementierungsspezifikation.md`, `docs/project-decisions.md` und `docs/development.md` lesen. Normative Produktentscheidungen aus Kapitel 0 der Spezifikation haben Vorrang; Widersprüche offen dokumentieren, nicht stillschweigend abschwächen.
|
||||
Ein Server mit WebUI und MCP verwaltet Linux- und Windows-Clients. Die Clients melden Heartbeats und Inventar, holen optionale Skriptaufträge ab und geben Ergebnisse zurück. Eine benannte, versionierte Skriptbibliothek bedient beide Oberflächen. Windows-Updates sind ein PowerShell-Katalogeintrag. Ein frischer Client lässt sich über ein HTTPS-Installationsskript aufnehmen und aktualisiert seinen eigenen Agenten periodisch aus dem signierten Releasebestand des Servers. Die Abnahmekriterien stehen im Plan.
|
||||
|
||||
## Reihenfolge und reale Nachweise
|
||||
## Betrieb und Freigabe
|
||||
|
||||
- **Linux-first für ALLE Features:** Zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Lokale Tests, Simulatoren und Cross-Builds ergänzen den VM-Nachweis, ersetzen ihn nicht.
|
||||
- Erstes Phasenziel ist das **Linux-MVP (M0–M5, x86-64)** mit WebUI, MCP und menschlich autorisierten dauerhaften Jobs. **Useroverride 2026-11-13:** Windows-11-Client darf bereits parallel entwickelt und nativ auf der neuen Windows-Test-VM geprüft werden. Dies ersetzt keine Linux-Abnahme und macht Windows nicht zum Linux-MVP-Blocker. Notebook-Host bleibt ausschließlich Entwicklungsrechner; die Windows-VM ist ein eigener Gast. Proxmox/PBS, Cluster und Backups folgen noch später; kein Hypervisorzugang ist Voraussetzung eines Gastagenten.
|
||||
- **Useroverride 2026-11-12: RustDesk aus dieser Umsetzung auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme; RustDesk ist keine MVP-Pflicht und kein Abnahmeblocker. Bestehende Architekturverträge bleiben ausschließlich für eine spätere optionale Integration erhalten, ohne Ersatz durch eine eigene Desktop-Engine.
|
||||
- Kein Erfolg ohne realen Nachweis: geplant, implementiert, gebaut, lokal getestet, auf VM getestet und abgenommen getrennt ausweisen. Fehlende Zugänge/Tools/Capabilities und nicht ausgeführte Tests offen nennen. Keine erfundenen Messwerte oder Testergebnisse.
|
||||
- Der dedizierte Server ist `discovery.ease-technologies.de`. Testclients sind die Cloud-Linux-VM und der Windows-11-Gast. Das Notebook dient ausschließlich der Entwicklung. Plattformspezifische Arbeit auf beiden Gästen darf parallel laufen. Plattformfunktionen jeweils nativ nachweisen.
|
||||
- Der produktive Geräteverkehr geht vom Client aus. SSH/SFTP ist im Entwicklungsbetrieb ausdrücklich für die direkte Bereitstellung vorhandener Artefakte zulässig. Der [Entwicklungsweg](docs/development.md) beschreibt Build, Transfer und Aktivierung. Zur Produktabnahme von Installer und Selbstupdate den jeweiligen Produktweg benutzen.
|
||||
- Jeder **Skript- oder Wartungsjob** aus UI, MCP oder Automatik wird zunächst als `pending_approval` gespeichert. Erst eine berechtigte Person genehmigt den unveränderlichen Plan mit Ziel, Skriptbytes, Rechten, Grenzen und festen Versuchen in der WebUI. Vorher bleiben ausführbare Jobs, Outbox, Angebote und Startgrants leer. Policies begrenzen. Direkte API-/DB-Freigaben durch KI oder Automatik sind ausgeschlossen.
|
||||
- Ausschließlich im expliziten dev/test-Profil darf ein sichtbar **simulierter Testprincipal** die tatsächliche WebUI per Browser bedienen. Audit bindet `approval_origin`, `testsimulation`, Principal und Plan. In Produktion gilt die menschliche Freigabe. Redelivery darf keine zweite Ausführung auslösen. Neue Versuche und Folgejobs brauchen eine eigene feste Freigabe.
|
||||
- Passive Standardtelemetrie und gespeicherte Lesezugriffe laufen ohne Job. Version 1.33 spezifiziert zusätzlich die automatische Installation **veröffentlichter signierter Agent-Releases**. Der Releasepfad akzeptiert ausschließlich die festgelegten Agentkomponenten. Eine Live-Diagnose oder ein OS-Update ist ein Wartungsjob.
|
||||
- WebUI und MCP bleiben im Entwicklungsaufbau über den SSH-Tunnel erreichbar. Dockerports an Loopback binden, PostgreSQL intern betreiben. Für die öffentlichen Geräte- und Bootstrapwege TLS-Kette und SAN/SNI prüfen, für registrierte Geräte mTLS und Mandantenbindung durchsetzen. Der öffentliche Installer braucht einen auf dem frischen Gerät bereits vertrauenswürdigen TLS-Anker.
|
||||
- `credentials/` bleibt ignoriert und privat (0700, Dateien 0600). Die [Zugangsanleitung](docs/operations-access.md) nennt Parser und bestätigte Hostpins. Profile ausschließlich als Daten verarbeiten, kein `source` oder `eval`. Schlüssel, Token und private Diagnoseausgaben gehören weder ins Repository noch in Agentkontexte.
|
||||
- Bei einem normalen Binärwechsel Identität, PKI, Konfiguration, Journale und Dateirechte erhalten. Im aktuellen Entwicklungssystem dürfen ausdrücklich freigegebene Altanträge und blockierende Testprojektionen gezielt entfernt werden. Nach einer Bereinigung das Fehlen des Auftrags und den frischen Geräteabgleich prüfen. Zielreboots, OS-Updates und destruktive Tests brauchen einen konkreten Auftrag. Vom Status `unknown` führt nur der belegte Abgleich oder der dokumentierte WebUI-Abschluss weiter. Niemals blind wiederholen.
|
||||
|
||||
## Unumgehbare Genehmigungsgrenze
|
||||
## Nachweise und Umfang
|
||||
|
||||
- **Jeder Job** aus UI, MCP oder Automatik beginnt als persistenter Antrag `pending_approval`. Ein berechtigter Mensch muss den unveränderlichen Plan mit festen Jobs/Versuchen **in der WebUI** genehmigen. Auch Linux-Dev, Hello World, Live-Diagnose, Retry und Reboot-Folgejobs haben keine Abkürzung.
|
||||
- **Einzige Bedienungsausnahme für diese Entwicklungsabnahme (Userentscheidung 2026-11-12):** Browserautomatisierung darf ausschließlich im expliziten dev/test-Profil tatsächliche UI-Interaktionen einschließlich Plangenehmigung mit einem deutlich sichtbar als simuliert gekennzeichneten Testprincipal durchführen. Keine Code-Abkürzung: `pending_approval`, Planbindung, interaktive UI-Grenze und Sicherheitsprüfungen bleiben erhalten. Audit muss `approval_origin` und `testsimulation` samt Testprincipal/Planbezug nachvollziehbar kennzeichnen; keine tatsächliche menschliche Identität vortäuschen, kein Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Produktionsverhalten bleibt unverändert. Details: `docs/project-decisions.md` und Spezifikation Kapitel 0.1.
|
||||
- Vor Genehmigung keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Policies begrenzen/verweigern nur. KI, MCP und Automatik genehmigen niemals; auch kein direkter API-/DB-Aufruf als Ersatz für den Menschen.
|
||||
- Passive Standardinventarisierung/Heartbeats und Lesen gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Angeforderte Live-Erhebung nicht als passives Inventar tarnen.
|
||||
- Redelivery ist kein neuer Versuch und darf keine zweite Wirkung auslösen. Neue Versuche und veränderte Pläne brauchen neue menschliche Genehmigung. Unklare Wirkung bleibt `unknown`, nicht blind wiederholen.
|
||||
|
||||
## Entwicklungsweg und Sicherheit
|
||||
|
||||
- **Useroverride 2026-11-13:** Server auf dem dedizierten Internetserver, sämtliche Clients verbinden sich direkt ausgehend dorthin. Keine lokale Serverpflicht und kein PC→VM-Reversetunnel mehr. Details und tatsächlicher Deploymentstand in `docs/server-deployment.md`.
|
||||
- Dockerports auch auf dem Internetserver ausschließlich an Loopback binden; PostgreSQL ohne veröffentlichten Port. Öffentlichen TLS-Ingress separat und eng begrenzt konfigurieren. Keine öffentlich erreichbare Dev-Anmeldung oder Datenbank; Verwaltungszugang bis zur sicheren öffentlichen Anmeldung ausschließlich über SSH-Tunnel.
|
||||
- TLS Ende-zu-Ende zum Server, gültige Kette und zum Endpunkt passender SAN/SNI. Ein geprüfter Connect-Override verändert ausschließlich TCP-Ziel/Port. Vertrauenswürdige CA gezielt konfigurieren; niemals ungültige Zertifikate/Namen akzeptieren, kein `curl -k` oder Abschalten der Verifikation.
|
||||
- SSH ausschließlich Dev-/Bootstraptransport, kein RMM-Sicherheitsersatz: Enrollment, Geräteidentität/mTLS, Tenant-Grenzen, Planbindung und menschliche Genehmigung bleiben erforderlich.
|
||||
- VM-Zugangsdaten ausschließlich lokal in `credentials/linux-vm.conf`; `credentials/` über `.gitignore` ausschließen, Verzeichnismodus **700**, Dateimodus **600**. Keine Secrets aus Neugier lesen, loggen, committen oder in Jobausgaben/MCP-/LLM-Kontexte kopieren. Daten strikt parsen; **kein `source`, `eval` oder Ausführen von Konfigurationsinhalten**.
|
||||
- Server-SSH-Daten entsprechend in `credentials/server.conf`; Root ist ausschließlich Bootstrapzugang. Anwendungsdienst unprivilegiert betreiben. Neue SSH-Hostschlüssel vor Anmeldung unabhängig bestätigen.
|
||||
- Entwicklungs-/Testtools dürfen installiert werden. Daraus folgen **keine impliziten Reboots, Updates oder destruktiven Tests am Ziel**, auch nicht an der Linux-Test-VM. Bootstrap eng begrenzen und abstimmen; RMM-Testjobs bleiben WebUI-genehmigungspflichtig. Sicherheitsprüfungen nicht für eine Demo umgehen.
|
||||
- Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt; daraus folgen keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und keine Ersetzung der WebUI-Plangenehmigung.
|
||||
|
||||
## Arbeitsweise
|
||||
|
||||
- Bestehende Projektmuster und bekannte Infrastruktur erhalten: Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery`, RustDesk-Server `rust.ease-technologies.de`. Fehlende RustDesk-Profilwerte als `not_configured` behandeln, keine eigene Desktop-Engine bauen.
|
||||
- Kleine lauffähige Strecken liefern, Mandantentrennung auf jedem Pfad beachten, betroffene Tests/Fehlerpfade prüfen. Keine Typefehler oder Sicherheitsprüfungen unterdrücken.
|
||||
- Geplante Start-/Testbefehle ausdrücklich als **geplant, nicht ausgeführt** kennzeichnen. Tatsächlich ausgeführte Prüfungen mit Ergebnis und Grenzen dokumentieren. Dokumentation und Spezifikationsversion bei geänderten Entscheidungen konsistent halten.
|
||||
Teste die betroffene Funktion und den konkreten Fehlerpfad. Verwende vorhandene native Belege weiter. Kennzeichne geplante, noch nicht ausgeführte Befehle sowie fehlende Zugänge oder Werkzeuge. Historische APT-/MSI-/Rebootabnahmen, Terminal, RustDesk, PVE/PBS, Cluster und Backups sind keine Voraussetzungen für den aktuellen Lieferplan.
|
||||
|
||||
Reference in New Issue
Block a user