Uebergabehinweise fuer den Frontend-Agenten (#531)

Der C#-Teil des Instanzmanagers ist fertig; was fehlt, ist die
Oberflaeche. Abschnitt 11 im Konzeptpapier ist die Uebergabe dafuer: der
Auftrag in einem Satz, die harte Grenze (keine .cs-Datei, git status darf
nur wwwroot zeigen), die vollstaendige API mit den Antwortcodes, die eine
eigene Behandlung verdienen, eine Reihenfolge, zwei Fallen und die drei
Punkte, die ausdruecklich liegen bleiben, weil sie C# sind.

Der WebUI-Leitfaden war an vier Stellen ueberholt und haette den naechsten
Agenten in die Irre geschickt: wwwroot liegt nicht mehr in
ClawdDotNet.Web, die Oberflaeche laeuft nicht mehr im Prozess der Instanz,
Port und Token stehen in manager.json statt in InstanceSettings.json, und
es gibt nicht mehr ein /api fuer eine Instanz. Ein Korrekturblock steht
jetzt vorweg und verweist auf Abschnitt 11; der Rest des Leitfadens - kein
innerHTML, kein Paketmanager, Token nur im sessionStorage, Farben aus
app.css - gilt unveraendert.

Die Arbeit selbst ist #531 und steht auf der Roadmap. Was nur in einer
Datei steht, ist keine eingeplante Arbeit.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-09-09 00:15:20 +02:00
co-authored by Claude Opus 5
parent 7d4e8b3096
commit d44bbeac1d
2 changed files with 161 additions and 1 deletions
+21 -1
View File
@@ -8,7 +8,27 @@ Gegenstück zum [Oberflächen-Leitfaden](Oberflaechen-Leitfaden.md), der für
Avalonia gilt.
Vorhaben im Deploymentcenter:
**#494** (Weboberfläche), **#493** (Fachlogik nach `App`).
**#494** (Weboberfläche), **#493** (Fachlogik nach `App`), **#531** (Instanzen in der
Oberfläche).
---
## Vorweg: Vier Dinge in diesem Leitfaden sind überholt
Seit dem 2026-09-09 trägt der **Instanzmanager** die Weboberfläche (#528). Der Leitfaden
gilt weiter für Stil, Sicherheit und Aufbau — kein `innerHTML`, kein Paketmanager, Token
nur im `sessionStorage`, Farben aus `app.css`. Vier Angaben darin stimmen nicht mehr:
| Im Text | Tatsächlich |
|---|---|
| `wwwroot` liegt in `src/ClawdDotNet.Web/` | **`src/ClawdDotNet.Manager.Web/wwwroot/`** |
| Die Oberfläche läuft im Prozess der Instanz | Sie läuft im **Instanzmanager**, einem eigenen Prozess. Er spricht mit den Instanzen über einen Socket und **leitet weiter** |
| `http://127.0.0.1:7001`, Einstellungen in `InstanceSettings.json` | **`webUiPort`, `webUiBinding`, `webUiToken` in `manager.json`**, Vorgabe 7000 |
| Ein `/api` für eine Instanz | **N Instanzen.** `/api/verwaltung/…` gehört dem Manager, alles andere unter `/api` geht an die Instanz aus der Kopfzeile `X-Instanz` |
**Der aktuelle Auftrag und die vollständige API stehen in**
[Instanzmanager-Konzept.md, Abschnitt 11](Instanzmanager-Konzept.md#11--übergabe-an-den-frontend-agenten).
Lies den zuerst; dieser Leitfaden ist das Nachschlagewerk daneben.
---