feat: support one Gitea organization per series

2026-07-19 16:40:05 +02:00
parent 4dda6de387
commit b0548f0e56
6 changed files with 388 additions and 58 deletions
@@ -16,6 +16,23 @@ wybrany kontener
        └── wewnętrzny tmux → Neovim + Termdebug/GDB + symulator lub RP2350
 ```

+## Katalog i organizacje Gitea
+
+`workspace-info/workspace.json` jest źródłem prawdy. Organizacja `edu` pełni
+rolę control plane, a stabilne serie mają osobne organizacje o nazwie
+`edu-<series-id>`. Karta jest repozytorium wewnątrz organizacji swojej serii.
+
+```bash
+stemctl workspace audit
+stemctl series list
+stemctl series cards list freertos-c
+stemctl series cards show freertos-c FC02
+```
+
+`workspace audit` jest lokalny i deterministyczny: sprawdza kontrakt katalogu,
+nie modyfikuje Gitea. Dzięki temu brak sieci nie uniemożliwia przeprowadzenia
+zajęć z wcześniej zsynchronizowanego workspace.
+
 Obiektem operacji `attach` i `detach` jest **połączenie pane z kontenerem**.
 Neovim i Termdebug są zawartością sesji kontenera, a nie osobnym obiektem
 podpinanym przez launcher.