# Voortgang - Umbrelapp

> Chronologisch sessielog, nieuwste bovenaan. Kort: 3 tot 6 regels per entry. Wat er is gebeurd en waarom,
> niet wat er nog moet: dat staat in [TAKEN.md](TAKEN.md).

## 25-08-2026 - plan werd actief, en het pakket staat er

De gebruiker besloot het pakket meteen te maken in plaats van te wachten op de proefopstelling. Dat kon,
omdat fase 1 van **Proefopstelling** die middag de feiten had opgeleverd: één image met meerdere
startscripts, een quota-manager die in de praktijk verplicht is, en geen publieke image.

**De zwaarste ontwerpvraag is met een precedent beslecht en niet met een gok.** Trezor Suite kan niet achter
de inlog van umbrelOS, en het was onduidelijk of `PROXY_AUTH_ADD: "false"` dan een verantwoorde keuze is of
een omweg. De eigen `nostr-relay`-app van Umbrel doet exact hetzelfde, om precies dezelfde reden, en heeft
ook geen eigen `ports:`. Daarmee is de vorm van de compose niet zelfbedacht.

**Twee dingen kwamen boven die niet in het ontwerp zaten.** `build/` staat in `.gitignore` als bouwselmap,
dus het bouwrecept zou stilzwijgend buiten de repo zijn gebleven; het staat nu onder `tools/`. Dat kwam pas
bij het stagen aan het licht en niet bij het schrijven, wat precies is waarom `git status` lezen erbij hoort.
En de poort werd 3851 en niet 4000: 4000 is de eigen poort van de relay, maar ook een veelgebruikte poort,
en een botsing op de host merk je pas als de app niet start. Die les komt van 50002 tegen Fulcrum.

**Er is een derde testbestand**, `tests/test_appstore_vorm.py`, en het gaat over de store en niet over één
app: id gelijk aan mapnaam, store-voorvoegsel, veldvolgorde, `app_proxy` die naar een bestaande service
wijst, en elke gemounte map die in de repo bestaat. Het vindt zijn apps zelf, dus een derde app valt er
automatisch onder. Digests toetst het expres niet: geen van de twee apps haalt die regel vandaag, en een
suite die altijd rood staat wordt niet gelezen.

Mutatie-getest met drie ingrepen: het app-id laten afwijken van de mapnaam, `APP_HOST` naar een
niet-bestaande service laten wijzen, en de `.gitkeep` weghalen. Alle drie vielen om bij de juiste toets, met
een bruikbare melding, en `git diff` was daarna leeg.

**Geraakt:** `whatsnext-evolu-relay/` (nieuw), `tools/evolu-relay/build.sh` (nieuw),
`tests/test_appstore_vorm.py` (nieuw), `Docs/CHANGELOG-evolu-relay.md` (nieuw), dit plan,
`Docs/CONTINUE_HERE.md`, `CLAUDE.md`, `README.md`.
**Tests:** 32 goed 0 fout (nieuw), 39 goed 0 fout en 54 goed 0 fout (bestaand), niets overgeslagen.

**Wat er níet geverifieerd is, en dat is veel:** er is nog niets gebouwd en niets geïnstalleerd. Of het
databaseschema zichzelf aanmaakt, of Trezor Suite dit adres accepteert, en of een eigenaar te registreren is
zonder iets extern: alle drie onbekend. "Gebouwd" is hier nadrukkelijk niet "werkend".