fai/reclaim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(web): add serve-web.sh + document hub smoke + prod-deploy path

Browse source 
serve-web.sh builds the release web bundle and serves it via
python3's stdlib http.server on http://127.0.0.1:8080, so an
AG reviewer can click a link instead of being asked to install
Flutter to see the demo.

RUN.md grows three new sections:

  - Web-Variante: single-command local serve, scope (mock works
    1:1, hub mode pending gRPC-Web in chain_client_sdk_dart).
  - Production deploy path: Hetzner-CX + Caddy, DNS
    reclaim.flemming.ai — matches the existing F∆I Hetzner
    pattern documented in fai_chain release-host.
  - Hub-Smoke-Test: how to verify the new HubRepository.list()
    wiring against a separately-running 'chain serve'
    (Hub-Reiter → Verbindung testen → flow.completed events
    populate the Heatmap-Tab once chain run has been invoked
    and the approval gate is cleared).

Signed-off-by: flemming-it <sf@flemming.it>
This commit is contained in:
flemming-it 2026-06-18 14:19:59 +02:00
parent dff5685686
commit febbf0b505
2 changed files with 66 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
RUN.md
View file

@ -56,6 +56,37 @@ Test-Suite (smoke):
flutter test
```
## Web-Variante (gleiche Codebase, ein Befehl)
```bash
cd app
./serve-web.sh # baut + serviert auf http://127.0.0.1:8080
```
Funktioniert im Demo-/Mock-Modus 1:1. Im Live-Hub-Modus
braucht die Web-Variante zusätzlich einen gRPC-Web-Branch in
`chain_client_sdk_dart` (Phase 1, dokumentiert in
docs/architecture/protocol-surfaces.md des Ch∆In-Repos).
Produktion: build/web/ auf einen statischen Host kippen
(F∆I-Pattern: Hetzner-CX + Caddy mit Auto-HTTPS, analog
`fai_chain` Release-Host). DNS: `reclaim.flemming.ai`.
## Hub-Smoke-Test (chain serve läuft separat)
Wenn ein `chain serve` lokal auf 127.0.0.1:50051 läuft (vom
fai_chain-Setup):
1. App starten, „Hub"-Reiter öffnen
2. Host/Port stehen schon, „Hub beim Start nutzen" anschalten
3. „Verbindung testen" → erwartet `healthy=true`
4. Falls capabilities installiert sind: „Installierte
Capabilities" listet sie auf
5. Nach `chain run flows/durchstich-gewo-14.yaml` und einem
`system.approval`-Approve wird der Heatmap-Tab live gefüllt
(HubRepository.list liest `flow.completed`-Events aus dem
Audit-Log und übersetzt sie in Evaluation-Objekte)
## Modul-Tests (lokal grün ohne Hub)
```bash