Files
rust-discovery/docs/handover.md
T
kevin_janssenandClaude Opus 5.5 93429e4394 Keep OPNsense telemetry when the script worker cannot start and build it for FreeBSD 14.1
A worker linked on the FreeBSD 15 test guest needs FBSD_1.9 and does not load on
OPNsense 24.7; the agent then retried the job session every 30 s and never sent a
heartbeat or inventory. The agent now pauses script capabilities for an hour and
reconnects without them. tools/dev_opnsense_worker.py links the worker against the
official FreeBSD 14.1 pkgbase libraries. The installer checks that the worker loads
before binding it and reports success only after a heartbeat.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-21 12:17:34 +01:00

26 lines
3.6 KiB
Markdown

# Übergabe an die nächste Entwicklungssitzung
`main` enthält den abgenommenen Stand. Zum Einstieg den [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) lesen und die vom neuen Auftrag betroffene Funktion in der [Abnahme](mvp-completion-plan.md) nachschlagen. Die JSON-Dateien in `docs/evidence/` sind datierte Beobachtungen.
## Wo eine Änderung beginnt
| Thema | Einstieg in die Implementierung |
| --- | --- |
| Gerätebestand und Kunden | [Geräteabfrage und Lebenszyklus](../crates/server/src/device_list.sql), [Kundenrechte](../crates/server/src/customers.rs), [Geräteansicht](../web/src/devices.tsx) |
| Bibliothek und Auftragsplanung | [Skriptversionen](../crates/server/src/script_library.rs), [Planung und Auswertung](../crates/server/src/jobs.rs), [Auftragsassistent](../web/src/order-composer.tsx) |
| Genehmigung und Zustellung | [Genehmigungseingang](../crates/server/src/approvals.rs), [Entscheidung und Freigabe](../crates/server/src/jobs.rs), [Gerätegateway](../crates/server/src/job_gateway.rs), [Abgleich im Agenten](../crates/agent-core/src/reconcile.rs) |
| MCP und Administrator-Skripte | [Werkzeuge](../crates/server/src/mcp.rs), [Tokenrechte](../crates/server/src/mcp_tokens.rs), [Helper und zentrale Geräteregel](../crates/server/src/managed_scripts.rs) |
| Geräteaufnahme und Releasewechsel | [HTTPS-Installer und Lebenszyklus](../crates/server/src/bootstrap), [Releasekatalog](../crates/server/src/agent_updates.rs), [Signaturprüfung](../crates/updater/src/manifest.rs) |
| OPNsense-Aufnahme per HTTPS | [Skript](../crates/server/src/bootstrap/opnsense.sh), [Installer](../crates/server/src/bootstrap/opnsense_install.py), [Paketauslieferung](../crates/server/src/bootstrap/opnsense.rs), [Paketwerkzeug](../tools/dev_opnsense_bundle.py), [Worker-Build für FreeBSD 14.1](../tools/dev_opnsense_worker.py) |
| Native Laufzeiten | [Linux-Agent](../crates/agent/src/main.rs), [Linux-Inventar und Skripte](../crates/agent-linux/src), [Windows-Agent](../crates/agent-windows/src/runtime.rs), [Agentprotokoll](../proto/BACKEND_CONTRACT.md) |
| Proxmox-Host und VM-Zuordnung | [Sammelmodul](../crates/agent-linux/src/inventory/proxmox.rs), [Validierung und Backupbewertung](../crates/domain/src/inventory_document/proxmox.rs), [automatische Zuordnung](../crates/server/src/proxmox_links.sql), [Detailansicht](../web/src/proxmox.tsx), [Betrieb](../deploy/proxmox/README.md) |
## Einen vorhandenen Auftrag nachvollziehen
1. Kunde und Installation identifizieren. Die `asset_id` bezeichnet das Gerät und die `agent_id` die konkrete Kopplung. Nach Neuaufnahme kann derselbe Hostname eine andere Installation bezeichnen.
2. Die `plan_id` öffnet die feste Vorschau zur Entscheidung. Unter der `operation_id` steht der eingereichte Auftrag samt Genehmigungsstatus. Bei `pending_approval` sind null ausführbare Jobs zu erwarten.
3. Nach der Genehmigung mit `jobs.get` und der `job_id` den Zustand, die Ausgabe und den Exitcode des einzelnen Ziels lesen. Die `attempt_id` verbindet das Ergebnis mit dem ursprünglichen Versuch. Für einen bereits laufenden oder ungeklärten Versuch dieselbe Kennung weiterverfolgen.
4. Bei plattformspezifischen Fragen die jeweilige Betriebsanleitung nutzen. Sie benennt Dienste, Helper und Anzeichen einer erfolgreichen Wiederanmeldung. [Linux](../deploy/linux/README.md) · [Windows](../deploy/windows/README.md)
Builds, Veröffentlichung und die Bereitstellung auf dem dedizierten Server sind unter [Entwicklung](development.md) beschrieben. Zugang zu den beiden nativen Testgeräten und die geschützten lokalen Profile stehen unter [Betriebszugänge](operations-access.md).