From 60f964e0d7f1821c19c7b73a6e6a2ab6999e27d2 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 22:49:50 +0100 Subject: [PATCH] Record the deployed order workflow and native Linux acceptance --- AGENTS.md | 2 + Rust_RMM_Implementierungsspezifikation.md | 10 +- .../webui-auftragsablauf-20261117.json | 116 ++++++++++++++++++ docs/handover.md | 4 +- docs/mvp-completion-plan.md | 10 +- docs/project-decisions.md | 6 +- docs/public-access.md | 8 ++ 7 files changed, 151 insertions(+), 5 deletions(-) create mode 100644 docs/evidence/webui-auftragsablauf-20261117.json diff --git a/AGENTS.md b/AGENTS.md index 4d1c547..7b03d46 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,6 +14,8 @@ Ein Server mit WebUI und MCP verwaltet Linux- und Windows-Clients. Die Clients m Für Geräte und Kunden gilt Kapitel 0.7. Änderungen an Kundengrenzen mit beschränktem und globalem Token prüfen, einschließlich Listen, direkter Geräte-IDs und Widerruf. Die Trennung von Bestand und Historie beruht auf der bestätigten Geräteidentität. Bei einem Kundenwechsel neu enrollen und die bisherige Historie beim ursprünglichen Kunden belassen. +Für Skriptaufträge gilt Kapitel 0.8. Die Bibliothek veröffentlicht Skriptversionen. Gerätezuweisung und Ergebniskontrolle gehören zu „Aufträge“, die interaktive Entscheidung zu „Genehmigungen“. Änderungen an einem dieser Wege am Übergang zum nächsten prüfen. + ## Betrieb und Freigabe - 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. diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index 7df3599..e45062b 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.36 · 2026-11-17 · Sprache: Deutsch +Version 1.37 · 2026-11-17 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -114,6 +114,12 @@ Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. ## 0 Auftrag und verbindliche Produktanforderungen +### 0.8 Skripte, Aufträge und Genehmigungen in der WebUI (Version 1.37) + +Die Geräteübersicht ist die Startseite. „Skripte“ veröffentlicht benannte Versionen pro Kunde. „Aufträge“ weist ein einmaliges Skript oder eine feste Bibliotheksversion ausgewählten Geräten eines Kunden zu, reicht den unveränderlichen Plan ein und zeigt den Verlauf und die Ergebnisse je Gerät. Die Auswahl im Gerätebestand kann in einen neuen Auftrag übernommen werden. Einreichungen lassen sich für denselben gespeicherten Plan idempotent fortsetzen. + +„Genehmigungen“ bündelt eingereichte Anträge aus WebUI und MCP über die berechtigten Kunden hinweg. Die prüfende Person sieht Ziele, Skriptinhalt, Version, Ausführungsrechte und Zeitfenster vor ihrer ausdrücklichen Entscheidung. Der Server prüft die Rechte erneut. Technische Planbytes und Prüfsummen bleiben im Detail einsehbar. + ### 0.7 Kunden, Gerätebestand und MCP-Zugriff (Version 1.36) Ein Kunde entspricht einem Tenant. Die Kundenwahl bei der Geräteaufnahme bindet die Identität an diesen Tenant. Bei einem Wechsel wird das Gerät für den Zielkunden neu aufgenommen. Die vorherige Identität und ihre Auftragsdaten gehören weiterhin zum bisherigen Kunden. @@ -1296,7 +1302,7 @@ Audits enthalten tatsächlichen Bediener, Automatisierungsidentität, Kunde, Ger ## 14 Oberfläche und Bedienung -Die Startseite zeigt Kunden mit offenen Vorfällen, nicht erreichbaren Geräten, veralteten Daten, Updateproblemen und Backupabweichungen. Ein Kunde führt zu Standorten und Geräten. Die Geräteseite enthält Überblick, Inventar, Messwerte, Dienste, Software, Updates, Logs, Aufträge, Sitzungen und Änderungshistorie. Jede Anzeige besitzt einen erkennbaren Erhebungszeitpunkt. +Die MVP-Startseite zeigt den authentisierten Gerätebestand nach Kapitel 0.7. Die Bedienwege für Skripte, Aufträge und Genehmigungen stehen in Kapitel 0.8. Für eine spätere Betriebsübersicht sind offene Vorfälle, Erreichbarkeit, veraltete Daten, Updateprobleme und Backupabweichungen vorgesehen. Ein Kunde führt zu Standorten und Geräten. Die Geräteseite enthält Überblick, Inventar, Messwerte, Dienste, Software, Updates, Logs, Aufträge, Sitzungen und Änderungshistorie. Jede Anzeige besitzt einen erkennbaren Erhebungszeitpunkt. Nach dem MVP zeigt die optionale Proxmox-Ansicht Cluster, Hosts, VMs und LXC-Container mit getrennten Zuständen für Hypervisor, Gast-Agent und Anwendung. Spätere Backupansichten unterscheiden fehlende Sicherungen, gescheiterte Versuche, Integritätsprüfung und praktischen Restore. Im MVP und danach darf eine fehlende Hostbeziehung keine Gastverwaltung sperren; ein Konnektivitätsproblem der Plattform wird nicht als bestätigter Geräteausfall ausgegeben. diff --git a/docs/evidence/webui-auftragsablauf-20261117.json b/docs/evidence/webui-auftragsablauf-20261117.json new file mode 100644 index 0000000..b7fc3ce --- /dev/null +++ b/docs/evidence/webui-auftragsablauf-20261117.json @@ -0,0 +1,116 @@ +{ + "deployment": { + "revision": "a7f554ad2be64628ede183fb5f3b57ff9c9c2732", + "server_sha256": "4fad477383943d6f1ab483af2fc8b6b6e06494a95e81be84e548c05b12d4bf16", + "web_index_sha256": "87b2726ebd37274fca69bb75d3abfa18f7178daa9a58eff1cd17196e7522085b", + "image": "sha256:039c2e1016892aa3fdfc41073ded96636f123f3751a3bc8daa398ef6d9546744", + "api_health": "ok", + "gateway_health": "ok" + }, + "database_schema": 32, + "local_checks": { + "web_unit_tests": 76, + "web_typecheck": "passed", + "chromium_fixture_tests": 8, + "postgres_rust_integration_tests": 9, + "migration_owner": "NOSUPERUSER NOBYPASSRLS" + }, + "public_readback": { + "origin": "https://discovery.ease-technologies.de:8443", + "observed_at": "2026-11-17T21:49:09.773Z", + "skripte": { + "desktop": true, + "mobile": true, + "rows": 4 + }, + "auftraege": { + "desktop": true, + "mobile": true, + "rows": 48 + }, + "genehmigungen": { + "desktop": true, + "mobile": true, + "rows": 30 + }, + "enrollment_separate": true + }, + "public_viewports_css_px": [ + [ + 1440, + 940 + ], + [ + 390, + 844 + ] + ], + "native_test": { + "platform": "linux-x86_64", + "script": "uname -sr", + "pinned_version": 1, + "newer_version_available": 2, + "mcp_rejected": "b5edcd67-ac3e-43bc-ba56-9efb37ac26c7", + "once": { + "plan": "ae5ab2de-df72-40a8-b549-231e8e311b19", + "hash": "230be4ba12c7a53b12e738e79351e0923ba4073f14a14b45eb711d17280b9524", + "operation": "cedb9883-23be-4574-918c-6c76b634dd8a" + }, + "once_rejected": "cedb9883-23be-4574-918c-6c76b634dd8a", + "library": { + "plan": "bc4b90ed-a71f-464f-84a2-02e7faf2d739", + "hash": "ab4390a4219d557ab5f9cb4ff5365e105c1745dcc633f182a4bafabeff3702b7", + "operation": "70fbaeba-7d60-480e-b3ee-a95a8c169943" + }, + "library_approved": "70fbaeba-7d60-480e-b3ee-a95a8c169943", + "job": "6487d583-3de2-4571-8522-1ec922ab3eec", + "stdout": "Linux 6.8.0-149-generic\n", + "linux_revision": "35d25133-c184-4d6b-8e32-58d71ee898e8", + "observed_at": "2026-11-17T21:49:07.423Z", + "profile": "dev_test_browser_simulation" + }, + "approval_audit": [ + { + "operation_id": "b5edcd67-ac3e-43bc-ba56-9efb37ac26c7", + "plan_id": "ade96424-e159-4038-b24c-16ee2c2f1157", + "approval_state": "rejected", + "requester": "automation:11111111-1111-4111-8111-111111111111", + "created_at": "2026-11-17T21:37:31.327496+00:00", + "reviewer": "simulated-testprincipal-a", + "approval_origin": "dev_test_browser_simulation", + "testsimulation": true, + "decision": "reject", + "jobs": 0, + "exit_code": null, + "job_state": null + }, + { + "operation_id": "cedb9883-23be-4574-918c-6c76b634dd8a", + "plan_id": "ae5ab2de-df72-40a8-b549-231e8e311b19", + "approval_state": "rejected", + "requester": "simulated-testprincipal-a", + "created_at": "2026-11-17T21:43:53.175749+00:00", + "reviewer": "simulated-testprincipal-a", + "approval_origin": "dev_test_browser_simulation", + "testsimulation": true, + "decision": "reject", + "jobs": 0, + "exit_code": null, + "job_state": null + }, + { + "operation_id": "70fbaeba-7d60-480e-b3ee-a95a8c169943", + "plan_id": "bc4b90ed-a71f-464f-84a2-02e7faf2d739", + "approval_state": "approved", + "requester": "simulated-testprincipal-a", + "created_at": "2026-11-17T21:43:54.22966+00:00", + "reviewer": "simulated-testprincipal-a", + "approval_origin": "dev_test_browser_simulation", + "testsimulation": true, + "decision": "approve", + "jobs": 1, + "exit_code": 0, + "job_state": "succeeded" + } + ] +} diff --git a/docs/handover.md b/docs/handover.md index 7b90a1b..e96a97f 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -2,7 +2,9 @@ **Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. -**Abschlussstand am 17. November, 22:17 Uhr MEZ.** Lieferbranch `codex/mvp-development-release`, API/Gateway/öffentliche API auf Revision `2358ba1`, WebUI auf `8d0a425`, Datenbankschema 31. WebUI und MCP sind unter `https://discovery.ease-technologies.de:8443/` beziehungsweise `/mcp` erreichbar. Die WebUI verwendet das lokale Passwort-/TOTP-Konto, MCP eigene scoped Bearer-Tokens. Die private Bootstrapdatei für die Einrichtung liegt unter `credentials/public-webui-login.json`. Öffentlicher dev/test-Login und OAuth sind deaktiviert. [Öffentliche Abnahme](public-access.md) +**Lieferstand am 17. November 2026.** Lieferbranch `codex/mvp-development-release`, API, Gateway, öffentliche API und WebUI auf Revision `a7f554a`, Datenbankschema 32. WebUI und MCP sind unter `https://discovery.ease-technologies.de:8443/` beziehungsweise `/mcp` erreichbar. Die WebUI verwendet das lokale Passwort-/TOTP-Konto, MCP eigene scoped Bearer-Tokens. Die private Bootstrapdatei für die Einrichtung liegt unter `credentials/public-webui-login.json`. Öffentlicher dev/test-Login und OAuth sind deaktiviert. [Öffentliche Abnahme](public-access.md) + +Skripte werden in der Bibliothek veröffentlicht. Aufträge binden die gewählte Version oder ein einmaliges Skript an konkrete Geräte. Genehmigungen bündelt offene Anträge aus WebUI und MCP. Der native Linux-Versuch und zwei Ablehnungen sind samt Audit und öffentlicher Sichtprüfung im [Abnahmeprotokoll](evidence/webui-auftragsablauf-20261117.json) dokumentiert. Der Bestand enthält die Linux- und die Windows-Test-VM für Development A. Fünf frühere Installationen liegen in der Historie. Im Kundenverzeichnis kann der Betreiber Kunden anlegen und umbenennen. MCP-Tokens haben eine feste Kundenauswahl oder ausdrücklich alle aktuellen und künftigen Kunden. Einzel-, Mehrkunden- und globaler Zugriff sowie Widerruf sind am öffentlichen Server geprüft. Die Aufnahme für Development B lieferte beide signierten Pakete und die passenden Updater. [Abnahme mit nativen Hardwaredaten](evidence/customer-fleet-20261117.json) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index e12485f..2f43a30 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -70,9 +70,17 @@ Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der R ## Fortsetzung nach dieser Lieferung +### WebUI für Skriptaufträge · umgesetzt und abgenommen + +1. **Skript veröffentlichen.** Die Bibliothek zeigt je Skript Name, Plattform und aktuelle Version. Im Detail lassen sich ältere Versionen lesen und neue veröffentlichen. +2. **Auftrag einreichen.** Unter „Aufträge“ Kunde und Geräte wählen oder eine Auswahl aus „Geräte“ übernehmen. Eine feste Bibliotheksversion oder ein einmaliges Skript angeben und die Zusammenfassung einreichen. Inkompatible Geräte sind gekennzeichnet. Der Antrag bleibt nach einer unterbrochenen Übermittlung wiederauffindbar. +3. **Entscheidung treffen.** „Genehmigungen“ bündelt offene WebUI- und MCP-Anträge für die Kunden, für die der angemeldete Benutzer entscheiden darf. Den festen Plan mit Zielgeräten, Skript, Ausführungsrechten und Zeitfenster prüfen und genehmigen oder ablehnen. Frühere Entscheidungen stehen im Verlauf. +4. **Ergebnis nachlesen.** „Aufträge“ zeigt die neuesten Anträge zuerst und führt zum Ergebnis je Gerät. Technische Kennungen und Prüfsummen stehen in den Details. Geräteaufnahme und Agent-Releases haben eigene Verwaltungsansichten. +5. **Abnahme.** Die Linux-Test-VM lieferte für Version 1 des Bibliotheksskripts trotz bereits verfügbarer Version 2 die Kernelversion, Exitcode 0. Zwei abgelehnte Anträge aus WebUI und MCP erzeugten je null Jobs. Alle drei Entscheidungen liefen über den gekennzeichneten Testprincipal im Entwicklungsprofil. Die öffentlichen Ansichten wurden nach Passwort-/TOTP-Anmeldung in Desktop- und Mobilbreite geprüft. [Abnahmeprotokoll](evidence/webui-auftragsablauf-20261117.json) + Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen. -Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte Revision für API, Gateway und öffentliche API ist `9fa0fb8`, Datenbankschema 27. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.5`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. +Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte Revision für API, Gateway und öffentliche API ist `a7f554a`, Datenbankschema 32. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.6`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. ### Wiederanlauf nach frühem Abbruch — nativ abgenommen diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 00ceca9..2f98712 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,10 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-17**, Spezifikation **1.36** (`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. +Stand: **2026-11-17**, Spezifikation **1.37** (`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. + +## Bedienwege für Skriptaufträge (Version 1.37) + +Bibliotheksarbeit, Gerätezuweisung und die abschließende Entscheidung haben eigene Reiter. Die Bibliotheksversion wird beim Planen gebunden. Für Einreichungen aus WebUI und MCP gilt derselbe Genehmigungseingang mit Prüfung je Kunde. „Aufträge“ zeigt Ergebnis und Ausgabe je Gerät. [Bedienung und Abnahme](mvp-completion-plan.md) ## Kunden und Gerätebestand (Version 1.36) diff --git a/docs/public-access.md b/docs/public-access.md index 854da6a..ab2f73a 100644 --- a/docs/public-access.md +++ b/docs/public-access.md @@ -30,6 +30,14 @@ Der verwendete MCP-Client muss einen manuell konfigurierbaren Bearer-Header unte Der Entwicklungsoperator kann dem bereits eingerichteten lokalen Betreiberkonto über `python3 tools/dev_public_access.py grant-customer-admin` die Kundenadministration zuweisen. Ein signierter Release lässt sich mit `python3 tools/dev_customer_starters.py --tenant UUID --platform PLATTFORM --release RELEASE_UUID` als Installationspaket für leere Kundenkataloge bereitstellen. Das Werkzeug prüft die Objektprüfsummen. Bei der ersten Codeausgabe übernimmt der Server das Paket in den Katalog des Zielkunden. Bereits befüllte Kataloge pflegt der Betreiber je Kunde über den regulären Releaseweg. +## Skriptauftrag bearbeiten + +1. Unter **Skripte → Neues Skript** ein Skript veröffentlichen. Spätere Änderungen als neue Version speichern. +2. Unter **Aufträge → Neuer Auftrag** die Geräte eines Kunden wählen. Eine Auswahl aus dem Gerätebestand lässt sich mit **Auftrag erstellen** übernehmen. Bibliotheksskript samt Version auswählen oder **Einmaliges Skript** eingeben. +3. Die Zusammenfassung prüfen und **Zur Genehmigung einreichen** wählen. Nach einer unterbrochenen Einreichung im selben Browsertab den Auftragsdialog erneut öffnen. Er liest den gespeicherten Plan und, falls bereits vorhanden, den zugehörigen Antrag. +4. Unter **Genehmigungen → Offen** den Antrag öffnen, Skript, Zielgeräte, Rechte und Zeitfenster prüfen und genehmigen oder ablehnen. Der Verlauf zeigt die entschiedenen und abgelaufenen Anträge. +5. Unter **Aufträge** den Eintrag und das gewünschte Zielgerät öffnen. Die gespeicherte Ausgabe und der Ausführungsstatus stehen im Gerätedetail des Auftrags. + ## Entwicklung und Deployment Der öffentliche API-Dienst `public-api` läuft unprivilegiert auf `127.0.0.1:18445`, im Produktionsprofil mit lokalem Passwort/TOTP und ohne Entwicklungszugänge. Der private Entwicklungsdienst bleibt auf `127.0.0.1:18443`. PostgreSQL hat keinen veröffentlichten Port. Der Reverseproxy verifiziert das TLS-Zertifikat des jeweiligen internen Dienstes. Öffentliche Anmeldung und MCP gehen an `public-api`, die vorhandenen Bootstrapdownloads an das Gerätegateway.