59 lines
8.0 KiB
Markdown
59 lines
8.0 KiB
Markdown
# Verbindliche Regeln für alle Coding-KIs
|
||
|
||
**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.
|
||
|
||
**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.
|
||
|
||
**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.
|
||
|
||
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 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.
|