MH-5 Filament Wizard / Managed Holdings UI — Plan-Review

Projekt: Steve-TradingBot · Phase: RECON-MH-5 · Author: claude-opus-4-7[1m]
Generated: 2026-05-12 21:42 UTC · master HEAD: cd37822 (MH-4c closed)
Status: NO CODE Plan-Review only — Operator-GO erforderlich vor MH-5 Code-Phase

1 — Live-State Verification

2 — Konsumierte Artefakte

Pattern-Source: gui/app/Filament/Pages/BaselineHoldings.php (RECON-2.3 — Operator-Custom-Page mit Action-Buttons + Hard-Confirm-Modal).

3 — MH-5 Scope-Rekonstruktion

UI-Architektur — 3 Varianten

Empfehlung: Option B (Resource-only) — Standard-Filament-CRUD-UX (Tabelle, Filter, Sortierung, Search) ohne Custom-Page-Boilerplate.

Wizard vs. Action

Per G-DR-7 (master_boundaries.md):

Operator-Multi-Step-Wizard für Promote: kein One-Click-Transfer; mindestens 5 Schritte inklusive Risk-Summary + Hard-Confirm

Approve-Action ist der einzige Wizard-Worthy Flow:

• Step 1: Asset + Risk-Summary (from proposal_json)
• Step 2: Variant-Wahl (recommended / conservative / aggressive)
• Step 3: Overrides (optional: stop_loss / take_profit / max_allocation_usdt / trailing_stop_enabled)
• Step 4: Confidence-Override (nur wenn overall_score < 0.50)
• Step 5: Hard-Confirm-Eingabe <asset>:<variant>:<sha8>

Filament 3 unterstützt Wizard Component. Reject / Pause / Resume / Release / Request brauchen keinen Wizard — Modal-Action mit Form genügt.

Wie werden die 6 Operationen angeboten?

Welche Actions disabled bis MH-6?

Begründung Option 2: UI-Vollständigkeit für Operator-Review + Safety. MH-6 Closure-Phase entfernt das disabled=true Flag — minimal-invasiver Aktivierungs-Punkt.

Hard-Confirm-Anzeige

• Modal-Description zeigt erwarteten String prominent: "Type exactly: ETH:recommended:a1b2c3d4"
• TextInput hard_confirm_input mit clientside required + serverside Service-Exception
• Beim Submit: Service-Methode wirft HardConfirmMismatchException → Filament catched → Notification::danger(...)

Confidence-Override-Anzeige

Wizard Step 4 (nur sichtbar wenn score < 0.50):

• Anzeige des Scores prominent (rot wenn < 0.50)
• Checkbox: "I acknowledge the low confidence and want to proceed"
• Wenn unchecked + Submit → Service wirft ConfidenceOverrideRequiredException → Notification

Reason-Field für Reject

• Textarea reason (required, max 256 chars, mit Filament maxLength(256)-Validierung clientside + serverside via Service)
• TextInput hard_confirm <asset>:reject:<sha8>

Mainnet-Block

UI-Layer-Mainnet-Block (Layer 5 per master_boundaries §8):

• Filament Actions bauen Payload mit environment='testnet' hardcoded (Service hardcoded auch)
• Banner oben auf Page: "TESTNET only — Mainnet hard-disabled"
• canAccess() zeigt UI nur an wenn Bot-Status environment='testnet'

4 — Strikte Abgrenzung (Konfliktcheck)

5 — Empfohlene Lieferung

Komponenten (MH-5-monolithic)

Action-Inventar

UI-Flows

Flow A: Request a managed proposal

Operator → ManagedProposalResource Header-Action "Analyze new asset"
        → Modal: TextInput(asset) + TextInput(intent)
        → Submit → ProposalService::createRequestCommand
        → Notification "Command queued"
        → Resource Table refreshes (new row pending Worker fill)

Flow B: Approve a proposal (Wizard)

Operator → ProposalResource per-row Action "Approve"
        → Wizard Step 1: Risk Summary (read-only display)
        → Step 2: Variant Select
        → Step 3: Overrides (4 optional TextInputs)
        → Step 4: Confidence Display + Override Checkbox (if score<0.50)
        → Step 5: Hard-Confirm TextInput
        → Submit → ProposalService::createApproveCommand
        → Notification + redirect

Flow C: Pause/Resume/Release (per-asset)

Operator → ManagedAssets Page → per-row Action
        → Pause/Resume: Confirm-Modal, single submit
        → Release: Select(strategy) + Hard-Confirm
        → Submit → ManagedStateService::create*
        → Notification

Service-Aufrufe (constructor-injected)

// In Action callable:
app(ProposalService::class)->createRequestCommand(...)
app(ProposalService::class)->createApproveCommand(...)
app(ProposalService::class)->createRejectCommand(...)
app(ManagedStateService::class)->createPauseCommand(...)
app(ManagedStateService::class)->createResumeCommand(...)
app(ManagedStateService::class)->createReleaseCommand(...)

Erlaubt: nur Service-Methoden + Filament-Standards (Action/Notification/Form/Wizard).
Verboten: direct Eloquent-Mutation auf managed_proposals / managed_assets_history.

6 — Test-Plan

7 — Betroffene Dateien

Neue Files (MH-5-monolithic)

Unverändert

• gui/app/Services/Managed/ProposalService.php (MH-4b komplett intact)
• gui/app/Services/Managed/ManagedStateService.php (MH-4c komplett intact)
• alle Models + Migrations
• Bot-Side trading/*.py — 0 Touches

Erwartete LOC: ~600-900 Resource + Pages + Forms + ~1200-1500 Tests = ~2000-2400 LOC.

8 — Stop-Regeln MH-5

9 — Backup / Migration / Restart-Bedarf

→ MH-5 = Reine UI-Code+Test+Commit Phase + GUI-Container Cache-Clear.

10 — Risiken-Übersicht

11 — Kleinste sichere Code-Phase + GO/NO-GO

Subschnitt-Optionen

Empfehlung: MH-5a (Resource Listing + View, read-only)

Begründung:

1. Größter Sicherheitsabstand vor MH-6: Listing-only = NULL action-trigger-risk
2. Maximale Operator-Visibility: Operator kann managed_proposals + Audit-Trail sehen, sobald Worker MH-6 die Rows füllt
3. Wizard-Complexity ausgelagert: Approve-Wizard kommt MH-5c (nach MH-6 oder parallel) — Worker-Handler aktiv = Approve-Submit funktional
4. 0 Actions = 0 disabled-gate-Logik — saubere Read-only-UI
5. Pattern-Etablierung: MH-5a setzt das Filament-Resource-Skelett für MH-5b/c/d

Alternative bei Operator-Wunsch nach Full-Phase → MH-5-monolithic mit allen 6 Actions disabled-bis-MH-6 via Tooltip + UI-Flag. Akzeptabel — keine Live-Trigger-Risk.

Pre-Implementation-Q an Operator

1. MH-5-monolithic oder MH-5a (Listing-only)? ← Empfehlung MH-5a (max Sicherheit)
2. UI-Architektur: Option A (Page) / B (Resource) / C (Hybrid)? ← Empfehlung B (Resource) für CRUD-Style
3. Actions disabled bis MH-6 (Option 2) oder enabled mit "Worker failed/pending" Status (Option 1)? ← Empfehlung disabled (Defense-in-Depth)
4. Hard-Confirm-Display: Plain TextInput oder mit Live-Preview-Builder? ← Empfehlung Plain TextInput (analog G10-3b Apply, bewusste Operator-Aufmerksamkeit)
5. Approve-Wizard 5 Steps wie skizziert oder andere Step-Reihenfolge? ← Empfehlung 5 Steps wie skizziert (per G-DR-7)
6. Read-only audit_events Display: separate Tab/Widget oder inline in Resource? ← Empfehlung Widget auf ManagedProposalResource Header
7. Filament Resource oder Custom Page? ← Empfehlung Resource für Proposals, Page für Asset-Lifecycle-Actions
8. Mainnet-Banner-Position: oben auf Page oder global? ← Empfehlung oben auf Page + globaler Filament-Notification-State
9. MH-6-Gate-Mechanismus: hardcoded disabled=true Flag in Resource oder via Feature-Flag/env? ← Empfehlung hardcoded disabled + Tooltip (einfacher revert in MH-6)

Scope-Größe + Risiko-Bewertung MH-5a (Listing-only)

STOP vor Implementierung. Erwarte Operator-GO mit Subschnitt-Wahl (MH-5a empfohlen) + Q1-Q9-Approval, insbesondere UI-Architektur + Actions-disabled-bis-MH-6-Mechanismus + Wizard 5-Step-Reihenfolge.

© Steve-TradingBot · RECON-MH-5 · Plan-Review (no-code phase)