UmbrelApps/Docs/Plannen/Actief/005-Webinterface/OPEN.md

Open punten - Webinterface

Beslissingen die nog een eigenaar of een moment nodig hebben. Wordt een punt een taak, dan verhuist het naar TAKEN.md.

Nummers blijven staan, ook als een punt beslist is: er kan elders naar verwezen worden. Beslissen betekent verplaatsen naar de kop hieronder, niet hernummeren.

Nog te beslissen

7. Kan Zoraxy of Nginx Proxy Manager verplicht gesteld worden bij de installatie? Gevraagd door de gebruiker op 20-08-2026, die erbij opmerkte dat sommige apps bij de installatie twee dropdowns tonen. Technisch antwoord: nee, niet als "de een of de ander". Nagetrokken in de bron, zie Umbrel-appstore-spec.md §4, met bronlinks.

   Kort: dat dialoog toont één dropdown per afhankelijkheid en niet per keuze. In het schema van umbreld is dependencies een platte lijst van app-id's, en wat er in een dropdown staat komt van de andere kant, namelijk elke app die implements: [<dat id>] declareert. Het voorbeeld dat de gebruiker zag is mempool met dependencies: [bitcoin, electrs]. Zoraxy en NPM declareren geen implements, dus er is geen gedeelde rol om naar te wijzen, en dat staat in hún manifest en niet in het onze.

   Wat overblijft is Zoraxy hard eisen, en dat is een dropdown met één optie. Wat er nog over te beslissen is, is of dat wenselijk is: het sluit de bron Own folder uit, en Zoraxy deïnstalleren zou deze app meesleuren. Moment: vrij · Eigenaar: gebruiker beslist

Beslist

5. Wordt er gecontroleerd of de TLS-poort zelf antwoordt? - Ja, bouwen (27-08-2026, gebruiker: "punt 5 is goed").

   De vraag kwam op 19-08-2026 op, nadat de badge "Serving this page" eruit ging omdat die niets zei: die pagina wordt nooit getoond aan een wallet die op 50022 verbindt. Het eigenlijke punt eronder was groter dan de badge: de app controleert wel of de Electrum-server antwoordt, maar niet of hij zelf antwoordt, en dat is precies zijn enige taak.

   Wat er gebouwd wordt: de agent zet een TLS-verbinding naar de eigen poort op en maakt de handdruk af. Dat bewijst het luisteren, het certificaat en de doorverbinding in één keer, met dezelfde truc waarmee de einddatum van het actieve certificaat gelezen wordt.

   Het lag stil omdat de agent nog nooit gedraaid had, en die reden is vervallen. De uitkomst wordt de vijfde widget van de bovenste rij uit PLAN.md §4a2.

   Gebouwd in 0.0.16, diezelfde dag, en het bewijst minder dan hierboven staat. De zin "bewijst het luisteren, het certificaat en de doorverbinding in één keer" klopte voor de eerste twee en niet voor de derde: er wordt na de handdruk niets verstuurd. Een echt verzoek zou de sessie bytes geven, en sessies met bytes worden nooit uit het activiteitenlog gefilterd, want die kunnen een storing zijn. De backend wordt apart bevraagd, dus wat overblijft is alleen de proxy_pass.

   Wat er in de plaats kwam is scherper dan verwacht: het getoonde certificaat wordt byte voor byte vergeleken met het gekozen bestand, en dát vangt een herlading die nginx nooit heeft toegepast. Dat is precies het geval waar een controle op vertrouwen blind voor is.

6. Komt het activiteitenlog er? - Ja, en gebouwd (opgemerkt 27-08-2026; het besluit is nooit als zodanig opgeschreven, het werk is gewoon gedaan en uitgerold in 0.0.6 en verfijnd in 0.0.14).

   De afweging was niet "kan het" maar "is dit het waard, nu het niet is wat er gevraagd werd": er was gevraagd om elk verzoek te loggen, en dat kan niet zonder het Electrum-verkeer van de gebruiker uit te lezen. Wat het geworden is, is een regel per verbinding.

   De twee obstakels die hier stonden zijn ongelijk afgelopen. Het log_format met dollartekens is langs de template-invulling gekomen zoals voorgesteld: het command-blok schrijft stream-log.conf met $$ ontsnapt en stream.conf haalt het op met een include. De bytetellers van een lopende verbinding zijn er niet gekomen; daarvoor in de plaats kwam een sessieteller uit /proc/net/tcp, die ziet dát er verbindingen zijn maar niet hoeveel er doorheen gaat. Dat is een bewuste halve oplossing en staat als zodanig in fase 5 van TAKEN.md.

7. Welke tagline, en waar? - Overal die van de appstore (20-08-2026, gebruiker). "Your own node from anywhere, without waiting for Tor" staat nu ook op de pagina; daar stond "TLS in front of your own Electrum server".

   De afweging was dat de twee lezers op een ander moment zitten: in de winkel moet de regel iemand overtuigen die de app niet kent, op het dashboard staat iemand die hem al draait. Dat pleit voor twee regels. Wat de doorslag gaf is dat deze afweging al eerder gemaakt is: bij het hernoemen naar Electrum Gate was de reden dat de oude naam het middel beschreef en niet de opbrengst. Met die maatstaf was de dashboardregel de achterblijver, niet de winkelregel.

   Een toets houdt de twee plekken nu gelijk. Niet omdat het kan, maar omdat ze ver uit elkaar staan: niemand die het manifest aanpast, opent daarna de pagina.

8. Kan een certificaat via de pagina geupload worden? - Ja, en gebouwd (20-08-2026, op verzoek van de gebruiker). Zie CHANGELOG-electrum-gate.md 0.0.7 voor de vier stukken die het vroeg.

   Twee besluiten die eruit voortkwamen en die het waard zijn om terug te lezen:

   • de bestandsnaam komt uit het certificaat en niet uit het verzoek. Daarmee is de hele klasse padtrucs weg zonder dat er iets gefilterd hoeft te worden op invoer die je niet vertrouwt. Wat er niet in het alfabet zit gaat eruit, dus een jokerteken-certificaat voor *.example.org wordt example.org;
   • uploaden kiest niet. De nieuwe komt voorgeselecteerd in de lijst en de gebruiker drukt op de bestaande knop. Zo blijft er precies één plek waar TLS van certificaat wisselt, en dat is dezelfde reden waarom de app bij twijfel niets kiest.

   Het geheim door een formulier: te verantwoorden omdat het pad achter de inlog van umbrelOS zit en de sleutel in de app-data van de gebruiker zelf landt, met rechten 0600. De agent kapt af op 96k en nginx ook, dus een verzoek dat te groot is komt niet eens bij de validatie.

9. Wat gebeurt er met de blokken-per-uur-grafiek in het eerste etmaal? - Vervallen (19-08-2026). De vraag ging over een grafiek die er niet meer is: de gebruiker heeft blokken per uur diezelfde dag geschrapt, als grafiek én als tegel. Zie PLAN.md §3.

10. Wat toont de pagina als status.json ontbreekt? - Een neutrale melding, geen fout (19-08-2026). "No readings yet", met de uitleg dat dit normaal is in de eerste minuten na een installatie of een herstart. Bewust neutraal opgemaakt en niet rood: het bestand ontbreekt in de normale gang van zaken even, en een foutkleur op een normale toestand leert mensen foutkleuren negeren.

    Daarnaast blijft elk afzonderlijk veld op unknown staan in plaats van leeg. Een leeg veld leest als "in orde", en dit is de pagina die juist geraadpleegd wordt wanneer er iets mis lijkt.

11. Nederlands of Engels? - Engels, en alles (19-08-2026, gebruiker). Dat betekent de pagina én de teksten in umbrel-app.yml, want een Engelse pagina onder een Nederlandse winkelbeschrijving is een halve keuze. Codecommentaar blijft Nederlands: de projectafspraak koppelt zichtbare UI-tekst aan de taal van de app, en commentaar niet.