Pinnen komt na een eigen image, niet ervoor

Alleen documentatie. Op aanwijzing van de gebruiker bij het afsluiten: de suite
meldt bij elke ronde dat python:3-alpine en nginx:alpine niet gepind zijn, en de
verleiding is dat even te doen. Dat is de verkeerde volgorde. Pinnen is een eis van
Publicatie, maar daarvoor gaat de app-inhoud eerst een eigen image in, en dan
bestaan die twee niet meer als de plek waar onze code draait.

De regel staat nu in KNOWLEDGE.md, want vier plannen raken hem en geen van de vier
bezit hem: de eis komt uit Publicatie, de oorzaak zit in Eigenimage, en de taak
stond in Umbrelapp en Appstore. Met twee grenzen erbij, anders slaat het de andere
kant op door: de eigen image pin je wel meteen bij elke verhoging, en de melding in
de suite blijft een afdruk en geen toets, zodat de suite niet rood staat tot
Eigenimage klaar is.

Onderweg bleek Eigenimage PLAN.md 8 achterhaald en misleidend. Daar stond dat het
bouwrecept van Evolu Relay misschien zou vervallen zodra de kale relay de weg werd,
en dat je er daarom niets aan moest verbeteren. Wij bouwen juist een eigen image,
want de twee terugroepfuncties zitten niet in de gepubliceerde. En de paragraaf
onderschatte wat er nog te doen is: ook bij die app staan de agent en de pagina nog
op vreemde images, alleen de relay zelf is klaar. Herschreven, en de kolom App van
dat plan in CONTINUE_HERE staat daarom op "beide" in plaats van op Gate.

Verder de taak in Umbrelapp gemarkeerd als wachtend op Eigenimage in plaats van
open, een verwijzing bovenaan Images-pinnen.md, en de regel voor Umbrelapp in
CONTINUE_HERE ingekort en bijgewerkt naar 0.5.1.

Geen tests gedraaid: er is niets buiten Docs/ geraakt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Harmen
2026-08-30 13:42:14 +02:00
co-authored by Claude Opus 5
parent 329b4ab947
commit 627c8306b1
6 changed files with 89 additions and 14 deletions
+23 -7
View File
@@ -138,14 +138,30 @@ hierna wordt elders aangehaald.
## 8. Wat dit voor Evolu Relay betekent
Voor die app is dit plan grotendeels al uitgevoerd: `tools/evolu-relay/build.sh` bestaat, het register is
gekozen en de anonieme pull is gecontroleerd. Wat hier eventueel bijkomt is de multi-arch-stap, want ook
dat recept bouwt vandaag één architectuur.
**Herschreven op 30-08-2026, want de vorige versie van deze paragraaf gokte verkeerd.** Daar stond dat het
bouwrecept van die app misschien zou vervallen omdat de kale `docker.io/evoluhq/relay:latest` de weg zou
worden, en dat je daarom niets aan dat recept moest verbeteren. Die verwachting is ingehaald: de app draait
sinds 28-08-2026 op een **eigen** image, omdat wij twee terugroepfuncties aan `createRelay` meegeven en die
in de gepubliceerde image niet zitten. Het recept in `tools/evolu-relay/` is dus geen tijdelijke toestand
maar de vaste weg.
**Trek dat werk niet in dit plan.** Het plan **Umbrelapp** staat op tier A met de conclusie dat de
gepakketteerde relay in de kern niet kan werken, en dat de volgende stap de kale
`docker.io/evoluhq/relay:latest` is. Wordt dat de weg, dan is er een gepubliceerde image en vervalt het
hele bouwrecept. Iets verbeteren aan een recept dat misschien weggaat, is de verkeerde volgorde.
Wat daarmee de stand is, en het is minder ver dan hier stond:
- **de relay zelf: klaar.** Eigen image, eigen recept, register gekozen, anonieme pull gecontroleerd, en
gepind op tag plus digest bij elke verhoging. Voor dat deel is dit plan uitgevoerd;
- **de agent en de pagina: niet.** Die zitten daar precies zoals bij Electrum Gate: `agent.py.template`,
`index.html.template` en `nginx.conf.template` in de app-map, gemount in `python:3-alpine` en
`nginx:alpine`. Alles in §1 tot §4 geldt dus onverkort ook voor die app;
- **multi-arch: open**, want ook dat recept bouwt vandaag één architectuur. Dat staat bij
**Publicatie-Relay**.
**De volgorde die hieruit volgt en die verder reikt dan dit plan:** zolang de agent en de pagina op vreemde
images draaien, valt er voor die twee niets zinnig te pinnen, want ze verdwijnen hier. Dat is de regel in
[KNOWLEDGE.md](../../../KNOWLEDGE.md), en Evolu Relay is er het tweede geval van.
Wat wél blijft gelden: **trek het werk aan de relay-image niet in dit plan.** Niet meer omdat het recept
misschien weggaat, maar omdat het dat níet doet en het al af is. Wat hier hoort is de agent en de pagina,
voor beide apps.
## 9. Waarom dit nú actief is
@@ -44,6 +44,17 @@ Bijvangst: die weigering stond in de neutrale stijl en is nu rood. En het manife
image (0.5.1 tegen 0.5.0), wat correct is voor een wijziging in alleen een template. De changelog beweerde
sinds diezelfde ochtend het tegenovergestelde en is rechtgezet.
**Bij het afsluiten haalde de gebruiker een taak van de lijst in plaats van erbij.** De suite meldt bij elke
ronde dat `python:3-alpine` en `nginx:alpine` niet gepind zijn, en de verleiding is dat "even te doen". Zijn
punt: pinnen is een eis van **Publicatie**, maar daarvóór gaat de app-inhoud eerst een eigen image in, en dan
bestaan die twee niet meer als de plek waar onze code draait. Dus eerst **Eigenimage**.
Dat klopt, en het bleek breder dan de taak: §8 van dat plan gokte er nog op dat het bouwrecept van deze app
zou vervallen zodra de kale relay de weg werd, en dat is ingehaald. Wij bouwen juist een eigen image, want de
twee terugroepfuncties zitten niet in de gepubliceerde. Bovendien staat ook bij Evolu Relay de agent én de
pagina nog op vreemde images; alleen de relay zelf is klaar. Beide rechtgezet, en de volgorde-regel staat nu
als cross-plan kennis in `KNOWLEDGE.md`, want vier plannen raken hem en geen van de vier bezit hem.
**Wat er nu nog staat is van de gebruiker en is een blik, geen sessie:** verversen, updaten, en dan de drie
dingen nakijken die alleen het apparaat kan zeggen.
+11 -4
View File
@@ -245,10 +245,17 @@ tonen, maar drie klassen fouten hoeven niet op het apparaat gevonden te worden:
- [x] **De Postgres-pin is vervallen (28-08-2026):** die database zit niet meer in de app
- [x] **De statuspagina verbeteren, op een lijst van de gebruiker.** De lijst kwam op 30-08-2026 en is in
één ronde uitgevoerd; zie fase 6 hieronder
- [ ] **`python:3-alpine` en `nginx:alpine` pinnen op hun multi-arch index-digest.** Dat zijn de twee laatste
ongepinde images van deze app, en ze staan als TODO in de compose. Met
`docker buildx imagetools inspect` op de Umbrel. Electrum Gate heeft precies dezelfde twee openstaan,
dus dit is één handeling voor beide apps
- [ ] **`python:3-alpine` en `nginx:alpine` pinnen op hun multi-arch index-digest. WACHT OP het plan
Eigenimage; doe dit niet eerder.** Op aanwijzing van de gebruiker (30-08-2026): die twee images zijn
de plek waar de agent en de pagina van deze app uitgevoerd worden, en dat is precies wat **Eigenimage**
naar een eigen image verhuist. Pin je ze nu, dan pin je iets dat verdwijnt.
De eis komt uit **Publicatie-Relay** en die is nog ver weg, dus er is geen haast. De regel en de hele
keten erachter staan in [KNOWLEDGE.md](../../../KNOWLEDGE.md); de commando's in
[Images-pinnen.md](../../../Referenties/Images-pinnen.md).
**De eigen relay-image is een ander geval en die is wél gepind**, bij elke verhoging. Verwar die twee
niet: de suite drukt beide af in dezelfde lijst
## Fase 3 - Het bouwrecept