- theme.scss and figures draw with the extension's --calc-… tokens; light/dark pair plus the high-contrast button; a11y highlight style for html - figure labels split so none leaves its viewBox in any language - _quarto-fr.yml: French cross-reference prefixes - notes extension synced to 2.8.18 - conv/: Parts IV, V and VI logged, pasted terminal output redacted Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
105 lines
5.8 KiB
Plaintext
105 lines
5.8 KiB
Plaintext
# [Step 0 — What this is about]{.en}[Étape 0 — De quoi il s'agit]{.fr}[Schritt 0 — Worum es geht]{.de} {#sec-step-0}
|
|
|
|
<!-- MULTILINGUAL: see the comment at the top of index.qmd. -->
|
|
|
|
::: {.en}
|
|
Step 0 contains no code. It states the subject: not ROT13, but the architecture around it. The functionality stays almost unchanged for 81 steps, which is what makes the changes around it visible.
|
|
|
|
Two rules are set here and hold all the way through:
|
|
|
|
> **Meet each solution only after you have experienced the problem it solves.**
|
|
|
|
That is why the build-up does not start with MQTT, and not with dynamic subscriptions either. A system with deliberately awkward mediators is built first, put into operation, and only then asked whether those mediators have earned their place.
|
|
|
|
The second rule is about vocabulary: *Intent*, *Status/State* and *Event* are named only after they have been used. They appear around step 42, not before.
|
|
|
|
The planned route, from step 0:
|
|
|
|
```text
|
|
direct method calls → egoistic services → mediators → separate processes
|
|
→ filesystem as transport → Syncthing → "why all these mediators?" → rewind
|
|
→ services subscribe themselves → dynamic wiring → across processes
|
|
→ across Syncthing → when a mediator IS useful → MQTT
|
|
```
|
|
:::
|
|
|
|
::: {.fr}
|
|
L'étape 0 ne contient aucun code. Elle énonce le sujet : non pas ROT13, mais l'architecture autour de lui. La fonctionnalité reste presque inchangée pendant 81 étapes, et c'est précisément ce qui rend visibles les changements alentour.
|
|
|
|
Deux règles sont posées ici et valent jusqu'au bout :
|
|
|
|
> **Ne rencontrer une solution qu'après avoir vécu le problème qu'elle résout.**
|
|
|
|
C'est pourquoi la construction ne commence ni par MQTT, ni par les abonnements dynamiques. Un système aux médiateurs délibérément maladroits est bâti d'abord, mis en service, et l'on demande seulement ensuite s'ils ont mérité leur place.
|
|
|
|
La seconde règle concerne le vocabulaire : *Intent*, *Status/State* et *Event* ne sont nommés qu'après avoir été utilisés. Ils apparaissent vers l'étape 42, pas avant.
|
|
|
|
L'itinéraire prévu, dès l'étape 0 :
|
|
|
|
```text
|
|
direct method calls → egoistic services → mediators → separate processes
|
|
→ filesystem as transport → Syncthing → "why all these mediators?" → rewind
|
|
→ services subscribe themselves → dynamic wiring → across processes
|
|
→ across Syncthing → when a mediator IS useful → MQTT
|
|
```
|
|
:::
|
|
|
|
::: {.de}
|
|
Schritt 0 enthält keinen Code. Er nennt das Thema: nicht ROT13, sondern die Architektur darum herum. Die Funktionalität bleibt über 81 Schritte fast unverändert — genau das macht die Veränderungen ringsherum sichtbar.
|
|
|
|
Zwei Regeln werden hier gesetzt und gelten bis zum Schluss:
|
|
|
|
> **Einer Lösung erst begegnen, nachdem man das Problem erlebt hat, das sie löst.**
|
|
|
|
Deshalb beginnt der Aufbau nicht mit MQTT und auch nicht mit dynamischen Abonnements. Zuerst entsteht ein System mit absichtlich unbequemen Vermittlern, wird in Betrieb genommen, und erst dann wird gefragt, ob sie ihren Platz verdient haben.
|
|
|
|
Die zweite Regel betrifft das Vokabular: *Intent*, *Status/State* und *Event* werden erst benannt, nachdem sie benutzt wurden. Sie erscheinen etwa ab Schritt 42, nicht früher.
|
|
|
|
Die geplante Route, von Schritt 0 an:
|
|
|
|
```text
|
|
direct method calls → egoistic services → mediators → separate processes
|
|
→ filesystem as transport → Syncthing → "why all these mediators?" → rewind
|
|
→ services subscribe themselves → dynamic wiring → across processes
|
|
→ across Syncthing → when a mediator IS useful → MQTT
|
|
```
|
|
:::
|
|
|
|
## [The three questions]{.en}[Les trois questions]{.fr}[Die drei Fragen]{.de} {#sec-three-questions}
|
|
|
|
::: {.en}
|
|
The wording of the three questions matters, and it is easy to replace it with something weaker:
|
|
|
|
| As asked here | A weaker version |
|
|
|---|---|
|
|
| Who **knows** whom? | who *communicates* with whom |
|
|
| Who **owns** what? | which *data* each part holds |
|
|
| Who **decides** how the system is wired? | which part *connects* everything |
|
|
|
|
"Knowing" is not "communicating": two components can exchange messages all day without either one naming the other. "Deciding the wiring" is not "connecting": the part that forwards messages need not be the part that chose the route. Both distinctions become concrete later — the first already in step 1, the second in part III.
|
|
:::
|
|
|
|
::: {.fr}
|
|
La formulation des trois questions compte, et il est facile de la remplacer par une version plus faible :
|
|
|
|
| Telle qu'elle est posée ici | Une version plus faible |
|
|
|---|---|
|
|
| Qui **connaît** qui ? | qui *communique* avec qui |
|
|
| Qui **possède** quoi ? | quelles *données* détient chaque partie |
|
|
| Qui **décide** du câblage ? | quelle partie *relie* le tout |
|
|
|
|
« Connaître » n'est pas « communiquer » : deux composants peuvent échanger des messages toute la journée sans que l'un nomme l'autre. « Décider du câblage » n'est pas « relier » : la partie qui transmet les messages n'est pas forcément celle qui a choisi la route. Les deux distinctions deviennent concrètes plus tard — la première dès l'étape 1, la seconde dans la partie III.
|
|
:::
|
|
|
|
::: {.de}
|
|
Der Wortlaut der drei Fragen ist wichtig, und man ersetzt ihn leicht durch eine schwächere Fassung:
|
|
|
|
| So gefragt | Eine schwächere Fassung |
|
|
|---|---|
|
|
| Wer **kennt** wen? | wer mit wem *kommuniziert* |
|
|
| Wer **besitzt** was? | welche *Daten* jeder Teil hält |
|
|
| Wer **entscheidet** über die Verdrahtung? | welcher Teil alles *verbindet* |
|
|
|
|
„Kennen“ ist nicht „kommunizieren“: zwei Komponenten können den ganzen Tag Nachrichten austauschen, ohne dass eine die andere nennt. „Über die Verdrahtung entscheiden“ ist nicht „verbinden“: der Teil, der Nachrichten weiterleitet, muss nicht der Teil sein, der die Route gewählt hat. Beide Unterscheidungen werden später konkret — die erste schon in Schritt 1, die zweite in Teil III.
|
|
:::
|