7.0 KiB
Verbindliche Regeln für alle Coding-KIs
Wiederaufnahme auf Userwunsch 2026-11-13. Historische Übergabe: docs/handover.md. Neuer verbindlicher Topologieoverride: 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.
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.
Reihenfolge und reale Nachweise
- 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.
Unumgehbare Genehmigungsgrenze
- 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 mussapproval_originundtestsimulationsamt 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.mdund 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 -koder 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.gitignoreausschließen, Verzeichnismodus 700, Dateimodus 600. Keine Secrets aus Neugier lesen, loggen, committen oder in Jobausgaben/MCP-/LLM-Kontexte kopieren. Daten strikt parsen; keinsource,evaloder 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-Serverrust.ease-technologies.de. Fehlende RustDesk-Profilwerte alsnot_configuredbehandeln, 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.