build: automatic update of astrololo

updates image gitea/astrololo-render tag 'cf24c4d4' to 'latest'

astrololo/README-astrodemo.md

@@ -1,7 +1,7 @@
-# astroklient-demo — wdrożenie wersji demo (PRE-28/29)
+# astrodemo — wdrożenie wersji demo (PRE-28/29)
 
 Osobna usługa o dwóch funkcjach: **dodanie pliku bazy** i **zapytanie o
-interpretację urodzeniową**. Opis aplikacji: `services/astroklient-demo/README.md`
+interpretację urodzeniową**. Opis aplikacji: `services/astrodemo/README.md`
 w repo aplikacji.
 
 ---
@@ -9,7 +9,7 @@ w repo aplikacji.
 ## Jak to jest odizolowane
 
 ```
-astroklient-demo  →  logic-demo  →  data-demo  →  /mnt/Tank1/astrololo-demo
+astrodemo  →  logic-demo  →  data-demo  →  /mnt/Tank1/astrololo-demo
                                               └── klientA/   ← pula konta
                                               └── klientB/   ← pula konta
 ```
@@ -18,7 +18,7 @@ astroklient-demo  →  logic-demo  →  data-demo  →  /mnt/Tank1/astrololo-dem
 własną warstwę danych, pracującą na osobnym udziale, pustym na starcie.
 
 Dlaczego osobna jest też **warstwa logiczna**: zna ona jeden adres warstwy danych,
-więc astroklient-demo korzystający z produkcyjnej logiki i tak trafiłby na produkcyjne
+więc astrodemo korzystający z produkcyjnej logiki i tak trafiłby na produkcyjne
 bazy. Izolacja musi sięgnąć obu warstw naraz, inaczej nie ma jej wcale.
 
 **Każde konto ma własną pulę** — swój podkatalog na tym udziale. Konta nie widzą
@@ -47,7 +47,7 @@ midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo-demo"]]' \
 midclt call sharing.nfs.create '{
   "path": "/mnt/Tank1/astrololo-demo",
   "comment": "astrololo — pule kont wersji demo (PRE-29)",
-  "hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81"],
+  "hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81", "192.168.1.82"],
   "enabled": true,
   "ro": false,
   "mapall_user": "root",
@@ -85,8 +85,8 @@ python scripts/make_user.py klientB
 ```
 
 ```bash
-kubectl -n astrololo create secret generic astrololo-demo \
-  --from-literal=DEMO_USERS='klientA:scrypt$…,klientB:scrypt$…' \
+kubectl -n astrololo create secret generic astrololo-astrodemo \
+  --from-literal=ASTRODEMO_USERS='klientA:scrypt$…,klientB:scrypt$…' \
   --from-literal=SESSION_SECRET="$(openssl rand -hex 32)"
 ```
 
@@ -96,43 +96,70 @@ powodu uznawać nawzajem swoich sesji.
 
 > **Zdalne unieważnienie w demo działa inaczej niż w pełnej wersji.** Demo nie ma
 > własnego wolumenu, więc nie ma gdzie trzymać licznika sesji. Zamiast tego:
-> usunięcie konta z `DEMO_USERS` albo zmiana jego hasła **natychmiast ubija jego
+> usunięcie konta z `ASTRODEMO_USERS` albo zmiana jego hasła **natychmiast ubija jego
 > otwarte sesje** — bo odcisk poświadczenia wpisany w ciasteczko przestaje pasować.
 > Rotacja `SESSION_SECRET` wylogowuje wszystkich naraz.
 
 ### Dodanie konta później
 
 ```bash
-STARE=$(kubectl -n astrololo get secret astrololo-demo -o jsonpath='{.data.DEMO_USERS}' | base64 -d)
+STARE=$(kubectl -n astrololo get secret astrololo-astrodemo -o jsonpath='{.data.ASTRODEMO_USERS}' | base64 -d)
 
-kubectl -n astrololo create secret generic astrololo-demo \
-  --from-literal=DEMO_USERS="${STARE},klientC:scrypt\$…" \
+kubectl -n astrololo create secret generic astrololo-astrodemo \
+  --from-literal=ASTRODEMO_USERS="${STARE},klientC:scrypt\$…" \
   --dry-run=client -o yaml | kubectl apply -f -
 
-kubectl -n astrololo rollout restart deploy/astroklient-demo
+kubectl -n astrololo rollout restart deploy/astrodemo
 ```
 
 ### Odebranie dostępu
 
-Usuń wpis z `DEMO_USERS` tą samą drogą. **Pula zostaje na udziale** — pliki
+Usuń wpis z `ASTRODEMO_USERS` tą samą drogą. **Pula zostaje na udziale** — pliki
 klienta nie znikają, tylko przestaje być komu je pokazywać.
 
 ---
 
-## Krok 3 — wdrożenie
+## Krok 3 — tag obrazu
+
+**Zanim wdrożysz.** CI pcha obrazy wyłącznie pod tagiem ośmioznakowym
+(`TAG=${GITHUB_SHA::8}`) i **nigdy nie pcha `latest`**. Manifest z `newTag: latest`
+zatrzyma się na `ImagePullBackOff`, co wygląda na problem z rejestrem albo siecią,
+a jest zwykłym brakiem takiego tagu.
+
+Po zmergowaniu zmian w repozytorium aplikacji i zbudowaniu obrazu:
+
+```bash
+TAG=$(git -C ~/git/astrololo rev-parse --short=8 master)
+echo "$TAG"          # ten sam ciąg musi być widoczny w logu zadania „build"
+```
+
+Wpisz go jako `newTag` przy `astrololo-astrodemo` w `kustomization.yaml`. Kolejne
+wersje podbija już image-updater sam — pod warunkiem, że obraz jest na jego liście
+(`image-updater.yaml`), co ten PR załatwia.
+
+## Krok 4 — wdrożenie
 
 ```bash
 kubectl apply -k astrololo
-kubectl -n astrololo rollout status deploy/data-demo deploy/logic-demo deploy/astroklient-demo
+kubectl -n astrololo rollout status deploy/data-demo deploy/logic-demo deploy/astrodemo
 ```
 
 Sprawdzenie na czas jednej sesji, bez wystawiania na świat:
 
 ```bash
-kubectl -n astrololo port-forward deploy/astroklient-demo 8005:8005
+kubectl -n astrololo port-forward deploy/astrodemo 8005:8005
 ```
 
-Wejście z zewnątrz wymaga reguły w `ingress.yaml` — osobny host albo ścieżka.
+Wejście z zewnątrz jest już w `ingress.yaml`: host **astrodemo.czernobog.pl**,
+z przekierowaniem z http na https i tym samym certyfikatem co astrololo
+(`tls.yaml` obejmuje oba hosty).
+
+Osobny host, a nie ścieżka `/demo` pod adresem astrololo — CELOWO. Ścieżka
+dzieliłaby z pełną aplikacją pochodzenie w rozumieniu przeglądarki, czyli
+i ciasteczka: wejście do jednej ruszałoby sesję w drugiej.
+
+Pozostaje wpis DNS: **astrodemo.czernobog.pl musi wskazywać na ten sam adres co
+astrololo.czernobog.pl**. Bez tego Traefik nigdy nie zobaczy żądania.
 **Celowo nie zakładam tego za Ciebie**: to decyzja, pod jakim adresem świat
 zobaczy demo.
 
@@ -181,8 +208,8 @@ techniczną, a decyzja, które bazy biorą udział w interpretacji, należy do C
 ## Odcięcie całego demo
 
 ```bash
-kubectl -n astrololo scale deploy/astroklient-demo --replicas=0
+kubectl -n astrololo scale deploy/astrodemo --replicas=0
 ```
 
-Pule i dane zostają. Skasowanie sekretu `astrololo-demo` zatrzyma pod (nie wstanie
+Pule i dane zostają. Skasowanie sekretu `astrololo-astrodemo` zatrzyma pod (nie wstanie
 bez niego) i to też jest zachowanie zamierzone.

astrololo/README-astroklient.md

@@ -0,0 +1,136 @@
+# Astroklient — wdrożenie warstwy pośredniej
+
+Pełne funkcje astrologiczne, bez generowania tekstu i bez administracji.
+Trzeci produkt drabiny: **astrodemo** (dwie funkcje) → **astroklient** → **astrololo**.
+
+Host: `astroklient.czernobog.pl` · obraz `astrololo-astroklient` · port 8006.
+
+## Jak to jest odizolowane
+
+Trzy granice, w kolejności od najmocniejszej:
+
+**Obraz.** Plików ekranów, których ten produkt nie ma, NIE MA w obrazie — usuwa
+je `usun.txt` przy budowaniu. Nie ma więc czego wyłączać ani czym odsłaniać:
+uprawnienia liczą się z katalogu funkcji, a katalog składa się ze zgłoszeń
+ekranów obecnych w obrazie. Test w repo aplikacji sprawdza to na złożonym
+drzewie, razem z zaporą słownikową — po nieobecnych funkcjach nie zostaje nawet
+słowo w komentarzu.
+
+**Udział NFS.** Własny `astrololo-klient`, osobny od produkcyjnego i od demo.
+Pule kont izolują klientów od siebie, ale to izolacja PROGRAMOWA — opiera się na
+poprawności mechanizmu pul. Granica na poziomie systemu plików nie zależy od
+tego, czy w kodzie niczego nie przeoczono. Przy sprzątaniu demo nie da się przez
+pomyłkę skasować cudzych danych, bo leżą gdzie indziej.
+
+**Warstwa danych i logiki.** Własna para `data-astroklient` + `logic-astroklient`,
+z silnikiem własnym (permisywnym) — silnik B (AGPL) nie wchodzi do produktu
+oddawanego klientom.
+
+---
+
+## Krok 1 — udział `astrololo-klient` na TrueNAS
+
+```bash
+midclt call sharing.nfs.create '{
+  "path": "/mnt/Tank1/astrololo-klient",
+  "hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81", "192.168.1.82"],
+  "maproot_user": "root", "maproot_group": "root", "enabled": true
+}'
+midclt call service.restart nfs
+```
+
+**Wszystkie CZTERY węzły.** Klaster ma cztery (`kubectl get nodes -o wide`), a nie
+trzy — pominięcie jednego daje `access denied by server` dopiero wtedy, gdy
+scheduler tam coś postawi, czyli w losowym momencie tygodnie później.
+
+Kontrolę wyłapującą braki i literówki w adresach masz w
+[README.md](README.md) → „Kontrola: czy każdy udział obejmuje każdy węzeł".
+
+Jeśli katalog jeszcze nie istnieje, utwórz dataset przed eksportem.
+
+## Krok 2 — konta klientów
+
+Każde konto to osobna pula, więc **rozdajesz konta, nie jedno hasło**.
+Wszystkie mają ten sam poziom dostępu — konta rozdziela się dla rozdzielenia
+plików, nie uprawnień.
+
+```bash
+# skrypt w repo aplikacji; format hasha wspólny dla wszystkich usług
+python services/presentation/scripts/make_user.py klientA    # wypisze: scrypt$…
+```
+
+```bash
+kubectl -n astrololo create secret generic astrololo-astroklient \
+  --from-literal=ASTROKLIENT_USERS='klientA:scrypt$…,klientB:scrypt$…' \
+  --from-literal=SESSION_SECRET="$(openssl rand -hex 32)"
+```
+
+`SESSION_SECRET` jest **własny**, nie ten z pełnej aplikacji ani z demo: trzy
+produkty nie mają powodu uznawać nawzajem swoich sesji. Ciasteczko też ma własną
+nazwę (`astroklient_sesja`), więc logowanie do jednego nie wyrzuca z drugiego.
+
+**Pod bez `SESSION_SECRET` celowo nie wstanie** — logowanie bez klucza podpisu
+nie miałoby czym się bronić.
+
+### Unieważnienie dostępu
+
+Nie ma wolumenu stanu, więc nie ma licznika pokolenia sesji. Zamiast tego:
+
+- usunięcie konta z `ASTROKLIENT_USERS` albo zmiana jego hasła **natychmiast ubija
+  jego otwarte sesje** — odcisk poświadczenia w ciasteczku przestaje pasować,
+- rotacja `SESSION_SECRET` wylogowuje wszystkich naraz.
+
+**Pula zostaje na udziale.** Odebranie dostępu nie kasuje plików klienta —
+przestaje być tylko komu je pokazywać.
+
+### Dodanie konta później
+
+```bash
+STARE=$(kubectl -n astrololo get secret astrololo-astroklient -o jsonpath='{.data.ASTROKLIENT_USERS}' | base64 -d)
+
+kubectl -n astrololo create secret generic astrololo-astroklient \
+  --from-literal=ASTROKLIENT_USERS="${STARE},klientC:scrypt\$…" \
+  --dry-run=client -o yaml | kubectl apply -f -
+
+kubectl -n astrololo rollout restart deploy/astroklient
+```
+
+## Krok 3 — wdrożenie
+
+Sekret i udział **muszą istnieć wcześniej**. Potem wystarczy merge do `master` —
+ArgoCD zsynchronizuje, a image-updater będzie odtąd podbijał tag sam, bo obraz
+jest dopisany do [`image-updater.yaml`](image-updater.yaml).
+
+## Sprawdzenie po wdrożeniu
+
+```bash
+kubectl -n astrololo get pods -l app=astroklient -o wide
+kubectl -n astrololo logs -l app=astroklient --tail=30
+curl -sk https://astroklient.czernobog.pl/ -o /dev/null -w '%{http_code}\n'   # 303 → bramka logowania odpowiada
+```
+
+Po zalogowaniu w nawigacji ma być **sześć** pozycji: Horoskop, Interpretacje,
+Kalendarz, Synastria, Sygnifikatory, Pliki.
+
+**Bez zalogowania każdy adres oddaje 303** — także nieistniejący. Bramka
+logowania działa przed trasowaniem, więc niezalogowany nie wyczyta z kodów
+odpowiedzi, które ekrany istnieją. Sprawdzanie nieobecnych adresów bez sesji nic
+więc nie mówi: pokaże 303 dla wszystkiego, łącznie z `/nie-ma-takiego-ekranu`.
+
+Sprawdzenie ma sens dopiero Z SESJĄ, i wtedy nieobecne ekrany dają **404, nie
+403** — odmowa z powodem byłaby informacją, że coś tam jest:
+
+```bash
+CIASTKO='astroklient_sesja=<wartość z przeglądarki po zalogowaniu>'
+for A in / /compile /settings /accounts /files; do
+  printf "%-12s %s\n" "$A" \
+    "$(curl -sk -o /dev/null -w '%{http_code}' -H "Cookie: $CIASTKO" https://astroklient.czernobog.pl$A)"
+done
+# oczekiwane:  / → 200,  reszta → 404
+```
+
+## Import puli klienta do pełnej aplikacji
+
+Pula to zwykły katalog na udziale — kopiuje się go tak samo jak w demo,
+patrz [README-astrodemo.md](README-astrodemo.md) → „Import puli klienta".
+Ścieżka źródłowa to `/mnt/Tank1/astrololo-klient/<login>`.

astrololo/README-stan-prezentacji.md

@@ -66,7 +66,7 @@ sudo chmod 770 /mnt/Tank1/astrololo-state
 midclt call sharing.nfs.create '{
   "path": "/mnt/Tank1/astrololo-state",
   "comment": "astrololo — stan prezentacji (konta PRE-27)",
-  "hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81"],
+  "hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81", "192.168.1.82"],
   "ro": false,
   "mapall_user": "apps",
   "mapall_group": "apps"

astrololo/README.md

@@ -12,16 +12,34 @@ Adres aplikacji: **https://astrololo.czernobog.pl** — patrz [TLS](#-tls--wymag
 
 Lista obrazów podbijanych automatycznie jest **jawna** i żyje w CRD `ImageUpdater`
 (ns `argocd`). Obraz, którego na niej nie ma, **nigdy się nie podbije**, choćby CI
-go budowało — tak przez chwilę wisiał `render` na `:latest`, zanim dopisaliśmy go do
-listy. Dodając nową usługę, dopisz jej wpis w `image-updater.yaml` i nałóż:
+go budowało — tak przez chwilę wisiał `render` na `:latest`.
 
-```bash
-kubectl apply -f astrololo/image-updater.yaml
-```
+Dodając nową usługę, dopisz jej wpis w `image-updater.yaml`. **Nic więcej nie
+trzeba**: plik jest w `kustomization.yaml`, więc ArgoCD nakłada go razem z resztą.
 
-Ten plik **celowo nie jest w `kustomization.yaml`**: resource stoi w ns `argocd`
-(poza namespace docelowym aplikacji), a to konfiguracja kontrolera, który wdraża tę
-aplikację — nakładamy go ręcznie, w repo trzymamy dla odtwarzalności i historii.
+### Dlaczego jest w kustomization, skoro kiedyś celowo nie był
+
+Wcześniej ten plik był z niej wyłączony z uzasadnieniem, że resource stoi w ns
+`argocd`, poza namespace docelowym aplikacji, i że to konfiguracja kontrolera,
+a nie samej aplikacji — więc nakłada się go ręcznie.
+
+Rozumowanie nie było głupie, ale **nie wytrzymało praktyki**. Ręczny krok
+zapomniano dwa razy w ciągu dwóch tygodni: najpierw dla `astrodemo`, potem dla
+`astroklient`. Obie usługi miały wpis w pliku i obu brakowało w klastrze, więc
+ich obrazy stały w miejscu mimo poprawnie działającego CI.
+
+Najgorsza w tym była **cichość rozjazdu**: plik w gicie wyglądał poprawnie,
+`git log` pokazywał dopisanie usługi, a objawem był obraz, który „się nie
+deployuje" — co kieruje podejrzenia na CI albo na rejestr, czyli wszędzie poza
+właściwe miejsce. Diagnoza wymaga porównania pliku ze stanem klastra, a nikt nie
+porównuje rzeczy, o której nie wie, że mogą się różnić.
+
+Przeszkody technicznej nie było: projekt ArgoCD dopuszcza dowolną przestrzeń
+nazw (`destinations: [{namespace: "*", server: "*"}]`), więc resource w ns
+`argocd` nakłada się bez zastrzeżeń.
+
+Jeśli kiedyś trzeba będzie go stamtąd wyjąć, **wyjmij razem z tym akapitem** —
+inaczej następna osoba przeczyta uzasadnienie, którego już nie ma.
 
 ## Pliki baz — udział otwarty na zapis (DAN-27)
 
@@ -29,14 +47,141 @@ Runbook: **[README-pliki.md](README-pliki.md)**. Ekran „Pliki" wymaga zapisu d
 udziału z bazami, więc znosi gwarancję z DAN-25, że baz nie da się zmienić przez
 NFS. Co zostaje z zabezpieczeń i jak to wdrożyć — w runbooku.
 
-## astroklient-demo — wersja demo (PRE-28)
+## astrodemo — wersja demonstracyjna (PRE-28/29)
 
-Osobna usługa o dwóch funkcjach. Runbook: **[README-astroklient-demo.md](README-astroklient-demo.md)**.
+Osobna usługa o dwóch funkcjach: dodanie pliku i pytanie o interpretację
+urodzeniową. Runbook: **[README-astrodemo.md](README-astrodemo.md)**.
 
-Ma **własną warstwę logiczną i własną warstwę danych** na osobnym udziale
-`astrololo-demo` — oryginalne bazy są dla demo nieosiągalne. Każde konto demo ma
-własną, niewidoczną dla pozostałych pulę plików, a jego pulę da się później
-przenieść do pełnej aplikacji jako jeden katalog.
+Ma **własną warstwę danych i logiki** (`astrodemo-stack.yaml`) oraz własny udział
+NFS, a każde konto dostaje w nim odrębną, niewidoczną dla pozostałych pulę plików
+(PRE-29). Nie sięga do produkcyjnych baz.
+
+Konta są osobne (sekret `astrololo-astrodemo`), więc usługę odcina się jedną
+zmianą, bez ruszania kont głównej aplikacji. Wchodzi się przez własny host
+`astrodemo.czernobog.pl` — nie przez ścieżkę pod adresem astrololo, bo wspólne
+pochodzenie oznaczałoby wspólne ciasteczka i wzajemne wylogowywanie.
+
+## ⚠️ Wymóg węzłów: klient NFS
+
+Wszystkie warstwy montują udziały z NAS-a, więc **każdy węzeł, na którym może
+wylądować pod, musi mieć klienta NFS**. Bez niego kubelet nie zamontuje wolumenu:
+
+```
+mount: ... bad option; for several filesystems (e.g. nfs, cifs) you might need
+a /sbin/mount.<type> helper program
+```
+
+Ten komunikat **nie oznacza problemu z udziałem ani z uprawnieniami** — serwer
+w ogóle nie został zapytany. Jądro nie znalazło programu pomocniczego
+`/sbin/mount.nfs`.
+
+### Sprawdzenie
+
+```bash
+for N in 192.168.1.73 192.168.1.80 192.168.1.81 192.168.1.82; do
+  printf "%-15s " "$N"
+  ssh hammer@$N 'test -x /sbin/mount.nfs && echo MA-KLIENTA || echo BRAK-KLIENTA'
+done
+```
+
+### Instalacja
+
+```bash
+ssh hammer@<węzeł> 'sudo apt-get update && sudo apt-get install -y nfs-common'
+```
+
+> **Na WSZYSTKICH węzłach, nie tylko na tym, gdzie pod stoi teraz.** Braku na
+> pozostałych nie widać, dopóki scheduler tam czegoś nie przeniesie — a wtedy
+> awaria wygląda na nagłą, choć przyczyna leżała od dawna. Dokładnie tak wyszło
+> za pierwszym razem: pody działały miesiącami na jednym węźle, aż zejście do
+> zera replik przy innej naprawie przeplanowało je gdzie indziej.
+
+### Skąd wiadomo, że to TO
+
+| komunikat | co znaczy |
+|---|---|
+| `bad option ... mount.<type> helper program` | **brak `nfs-common` na węźle** — serwer niepytany |
+| `access denied by server while mounting` | serwer odmawia: eksport nieprzeładowany, węzła nie ma na liście `hosts`, albo udział wyłączony |
+| `Permission denied` przy zapisie | montowanie działa, brakuje praw — patrz `mapall_user` i właściciel katalogu |
+
+## ⚠️ Wymóg węzłów: rozszerzenia procesora (x86-64-v2)
+
+Warstwa danych używa pandas, a przez nią NumPy. Koła NumPy z PyPI są budowane
+z bazą **x86-64-v2**, więc na węźle bez tych rozszerzeń kontener nie wstaje:
+
+```
+RuntimeError: NumPy was built with baseline optimizations:
+(X86_V2) but your machine doesn't support: (X86_V2).
+```
+
+Komunikat mówi o „optymalizacjach", czyli o niczym, po czym dałoby się poznać,
+że chodzi o **węzeł**, a nie o obraz. Pod wpada w pętlę restartów i wygląda to
+na zepsuty build.
+
+### To NIE jest ograniczenie sprzętu
+
+Węzły k3s są maszynami wirtualnymi. Proxmox z domyślnym modelem CPU (`kvm64`,
+„Common KVM processor") **maskuje flagi procesora** — gość nie widzi SSE4.2 ani
+POPCNT, mimo że fizyczny i7-3770 obsługuje nawet x86-64-**v3**. Stąd bierze się
+złudzenie, że „węzły mają różne procesory": mają ten sam sprzęt i różne maski.
+
+### Sprawdzenie: które węzły to udźwigną
+
+```bash
+for N in $(kubectl get nodes -o jsonpath='{.items[*].metadata.name}'); do
+  kubectl run cpucheck-$N --image=busybox --restart=Never --rm -i --quiet \
+    --overrides="{\"spec\":{\"nodeName\":\"$N\",\"tolerations\":[{\"operator\":\"Exists\"}]}}" \
+    --command -- sh -c '
+      F=$(grep -m1 ^flags /proc/cpuinfo); BRAK=""
+      for f in cx16 lahf_lm popcnt pni ssse3 sse4_1 sse4_2; do
+        echo "$F" | grep -qw "$f" || BRAK="$BRAK $f"
+      done
+      echo "$(grep -m1 "model name" /proc/cpuinfo | cut -d: -f2-)"
+      [ -z "$BRAK" ] && echo "  x86-64-v2: TAK" || echo "  x86-64-v2: NIE —$BRAK"
+    ' 2>/dev/null | sed "s/^/$N /"
+done
+```
+
+**Pułapka przy czytaniu flag:** Linux raportuje SSE3 jako **`pni`** (Prescott New
+Instructions), nie `sse3`. Szukanie `sse3` daje fałszywy alarm na maszynie, która
+SSE3 ma — pierwsza wersja tej kontroli wskazała w ten sposób trzy zdrowe węzły
+jako niesprawne.
+
+### Naprawa u źródła (Proxmox)
+
+Na węźle Proxmox, dla każdej maszyny k3s:
+
+```bash
+qm set <VMID> --cpu host
+qm stop <VMID> && qm start <VMID>
+```
+
+**Sam restart z wnętrza gościa nie wystarczy** — zmiana modelu CPU wchodzi
+dopiero przy pełnym wyłączeniu i włączeniu maszyny.
+
+`--cpu host` przekazuje pełny zestaw rozszerzeń i daje przy okazji realnie
+szybszą arytmetykę. Ma jeden koszt: **blokuje migrację na żywo** między hostami
+o różnych procesorach. Jeśli kiedyś zaczniemy migrować maszyny między pve2
+a NUC-iem, właściwym wyborem będzie wspólny mianownik `x86-64-v2-AES` zamiast
+`host`.
+
+### Zabezpieczenie: etykieta zamiast wykluczania po nazwie
+
+`data` i `data-demo` wymagają etykiety `astrololo.czernobog.pl/cpu-x86-64-v2`.
+Nowy węzeł jest domyślnie **nieoznaczony**, więc nie dostanie tych podów, dopóki
+ktoś go nie sprawdzi i nie oznaczy świadomie:
+
+```bash
+kubectl label node <węzeł> astrololo.czernobog.pl/cpu-x86-64-v2=true
+```
+
+Wykluczanie konkretnego węzła po nazwie znaczyłoby, że każdy KOLEJNY źle
+postawiony węzeł znów zbierze się przez awarię. Tak wyszedł agent3: dołożony
+14 dni po pozostałych, bez kroku `--cpu host`, i nikt tego nie zauważył, dopóki
+scheduler nie postawił tam akurat warstwy danych.
+
+**KOLEJNOŚĆ MA ZNACZENIE.** Oznacz węzły ZANIM to wdrożysz — bez etykiet `data`
+nie ma się gdzie uruchomić i pójdzie w Pending.
 
 ## ⚠️ Sekret `astrololo-auth` — utwórz PRZED wdrożeniem
 
@@ -56,11 +201,54 @@ read -rs -p "Hasło do aplikacji (APP_PASSWORD): " APP_PASSWORD; echo
 
 kubectl -n astrololo create secret generic astrololo-auth \
   --from-literal=APP_PASSWORD="$APP_PASSWORD" \
-  --from-literal=INTERNAL_TOKEN="$(openssl rand -hex 32)"
+  --from-literal=INTERNAL_TOKEN="$(openssl rand -hex 32)" \
+  --from-literal=SESSION_SECRET="$(openssl rand -hex 32)"
 
 unset APP_PASSWORD
 ```
 
+`SESSION_SECRET` podpisuje ciasteczka sesji (LOG-34). **Pod bez niego celowo nie
+wstanie**: usługa z kontami, ale bez klucza, nie odróżniłaby ważnej sesji od
+podrobionej. Nikt go nigdy nie musi oglądać.
+
+### ⚠️ Masz już sekret sprzed LOG-34? Dołóż klucz, nie twórz od nowa
+
+Komenda wyżej zakłada sekret **od zera**. Jeśli `astrololo-auth` już istnieje,
+merge manifestu sam klucza nie dołoży — pod zgłosi wtedy:
+
+```
+Error: couldn't find key SESSION_SECRET in Secret astrololo/astrololo-auth
+```
+
+Dokładamy klucz, nie ruszając pozostałych:
+
+```bash
+kubectl -n astrololo patch secret astrololo-auth --type=merge \
+  -p "{\"stringData\":{\"SESSION_SECRET\":\"$(openssl rand -hex 32)\"}}"
+
+kubectl -n astrololo rollout restart deploy/presentation
+```
+
+Sprawdzenie, że komplet kluczy jest na miejscu (bez pokazywania wartości):
+
+```bash
+kubectl -n astrololo get secret astrololo-auth -o jsonpath='{.data}' \
+  | tr ',' '\n' | grep -o '"[A-Z_]*"'
+```
+
+Oczekiwane: `APP_PASSWORD`, `INTERNAL_TOKEN`, `SESSION_SECRET`.
+
+> `--type=merge` ze `stringData` **dokłada albo nadpisuje** i nie wymaga, żeby
+> klucz wcześniej istniał — w odróżnieniu od JSON Patch z `op: replace`, który
+> na brakującej ścieżce po prostu odmawia. Ta sama komenda służy więc i do
+> dołożenia, i do rotacji.
+
+### Rotacja klucza sesji
+
+**Wylogowuje WSZYSTKICH.** To nie usterka, tylko awaryjny wyłącznik: gdy
+podejrzewasz, że ktoś przechwycił cudzą sesję, podmiana klucza unieważnia je
+wszystkie naraz. Komenda ta sama, co dołożenie wyżej.
+
 `INTERNAL_TOKEN` jest losowany i **nikt go nigdy nie musi oglądać** — służy tylko
 usługom do rozmowy między sobą. `APP_PASSWORD` wpisujesz w przeglądarce
 (użytkownik: `astrololo`, zmienny przez `APP_USER` w `presentation.yaml`).

astrololo/astrodemo-stack.yaml

@@ -1,11 +1,11 @@
 # Warstwa danych i logiki WYŁĄCZNIE dla wersji demo (PRE-29).
 #
 # DLACZEGO OSOBNY KOMPLET, A NIE WSPÓŁDZIELONY. Warstwa logiczna zna JEDEN adres
-# warstwy danych, więc astroklient-demo korzystający z produkcyjnej logiki i tak trafiłby
+# warstwy danych, więc astrodemo korzystający z produkcyjnej logiki i tak trafiłby
 # na produkcyjne bazy. Izolacja demo musi więc sięgnąć obu warstw naraz, inaczej
 # nie ma jej wcale.
 #
-# Udział `astrololo-demo` jest PUSTY na starcie i nigdy nie zawiera oryginalnych
+# Udział `astrololo-astrodemo` jest PUSTY na starcie i nigdy nie zawiera oryginalnych
 # baz. Każde konto demo dostaje w nim własny podkatalog (pulę) — patrz PRE-29.
 ---
 apiVersion: apps/v1
@@ -21,6 +21,26 @@ spec:
     metadata:
       labels: { app: data-demo }
     spec:
+      # Ta usługa liczy na pandas, a przez nią na NumPy. Koła NumPy z PyPI są
+      # budowane z bazą x86-64-v2, więc na węźle bez tych rozszerzeń kontener
+      # NIE WSTAJE: `import numpy` kończy się RuntimeError, pod wpada w pętlę
+      # restartów, a komunikat mówi o „baseline optimizations" — czyli o niczym,
+      # po czym dałoby się poznać, że chodzi o węzeł.
+      #
+      # Wymagana ETYKIETA, a nie wykluczony konkretny węzeł. Nowy węzeł jest
+      # domyślnie NIEOZNACZONY, więc nie dostanie tu poda, dopóki ktoś go nie
+      # sprawdzi (skrypt w README) i nie oznaczy świadomie. Pending z czytelnym
+      # powodem jest lepszy niż pętla restartów z komunikatem o optymalizacjach —
+      # a wykluczanie węzłów po nazwie znaczyłoby, że każdy KOLEJNY źle
+      # postawiony węzeł znów zbiera się przez awarię.
+      affinity:
+        nodeAffinity:
+          requiredDuringSchedulingIgnoredDuringExecution:
+            nodeSelectorTerms:
+              - matchExpressions:
+                  - key: astrololo.czernobog.pl/cpu-x86-64-v2
+                    operator: In
+                    values: ["true"]
       containers:
         - name: data
           # TEN SAM obraz co produkcja — różni się wyłącznie udziałem, na którym

astrololo/astrodemo.yaml

@@ -1,32 +1,32 @@
-# astroklient-demo — wersja demonstracyjna (PRE-28).
+# astrodemo — wersja demonstracyjna (PRE-28).
 #
 # Osobna usługa o DWÓCH funkcjach: dodanie pliku bazy i zapytanie o interpretację
 # urodzeniową. Pozostałe funkcje nie są tu ukryte — nie ma ich w obrazie.
 #
-# IZOLACJA (PRE-29): astroklient-demo ma WŁASNĄ warstwę logiczną i WŁASNĄ warstwę
-# danych (astroklient-demo-stack.yaml), pracujące na osobnym, pustym na starcie
+# IZOLACJA (PRE-29): astrodemo ma WŁASNĄ warstwę logiczną i WŁASNĄ warstwę
+# danych (astrodemo-stack.yaml), pracujące na osobnym, pustym na starcie
 # udziale. Oryginalne bazy interpretacyjne są dla demo NIEOSIĄGALNE.
 #
 # Wewnątrz demo każde konto ma własną pulę plików — swój podkatalog na tym
 # udziale — niewidoczną dla pozostałych kont. Dzięki temu demo można rozdawać
 # szeroko, a pliki jednego klienta da się później przenieść do pełnej aplikacji
-# jako jeden katalog (patrz README-astroklient-demo.md).
+# jako jeden katalog (patrz README-astrodemo.md).
 apiVersion: apps/v1
 kind: Deployment
 metadata:
-  name: astroklient-demo
+  name: astrodemo
   namespace: astrololo
 spec:
   replicas: 1
   selector:
-    matchLabels: { app: astroklient-demo }
+    matchLabels: { app: astrodemo }
   template:
     metadata:
-      labels: { app: astroklient-demo }
+      labels: { app: astrodemo }
     spec:
       containers:
-        - name: astroklient-demo
-          image: gitea.czernobog.pl/gitea/astrololo-astroklient-demo:latest
+        - name: astrodemo
+          image: gitea.czernobog.pl/gitea/astrololo-astrodemo:latest
           ports: [{ containerPort: 8005 }]
           env:
             # WŁASNA warstwa logiczna, wskazująca na WŁASNĄ warstwę danych.
@@ -35,14 +35,14 @@ spec:
             - name: LOGIC_URL
               value: "http://logic-demo:8001"
             # Konto demo — WŁASNE, nie astrololo-auth. Sekret tworzony POZA repo
-            # (jak pozostałe), patrz README-astroklient-demo.md.
+            # (jak pozostałe), patrz README-astrodemo.md.
             # KONTA DEMO — lista `login:sekret` po przecinku. Każde konto ma
             # WŁASNĄ, niewidoczną dla pozostałych pulę baz (PRE-29), więc jedno
             # wspólne konto oznaczałoby klientów oglądających swoje wgrania
             # nawzajem. Sekrety najlepiej jako hash scrypt.
-            - name: DEMO_USERS
+            - name: ASTRODEMO_USERS
               valueFrom:
-                secretKeyRef: { name: astrololo-demo, key: DEMO_USERS }
+                secretKeyRef: { name: astrololo-astrodemo, key: ASTRODEMO_USERS }
             # Token międzywarstwowy i klucz łącza — TE SAME co prezentacja:
             # demo nie jest furtką omijającą ochronę warstwy logicznej.
             - name: INTERNAL_TOKEN
@@ -59,7 +59,7 @@ spec:
             # znaczyłby, że sesja z demo bywa ważna tam, gdzie nie powinna.
             - name: SESSION_SECRET
               valueFrom:
-                secretKeyRef: { name: astrololo-demo, key: SESSION_SECRET }
+                secretKeyRef: { name: astrololo-astrodemo, key: SESSION_SECRET }
             # Za Ingressem bezpośrednim rozmówcą jest pod Traefika. Bez tego limit
             # liczyłby WSZYSTKICH do jednego wiadra i pierwsza osoba, która go
             # wyklika, odcięłaby pozostałe.
@@ -76,11 +76,11 @@ spec:
 apiVersion: v1
 kind: Service
 metadata:
-  name: astroklient-demo
+  name: astrodemo
   namespace: astrololo
 spec:
   # ClusterIP — wejście z zewnątrz wyłącznie przez Ingress po https, tak samo
   # jak prezentacja. Druga, nieszyfrowana droga byłaby obejściem PRE-16.
   type: ClusterIP
-  selector: { app: astroklient-demo }
+  selector: { app: astrodemo }
   ports: [{ port: 8005, targetPort: 8005 }]

astrololo/astroklient-stack.yaml

@@ -0,0 +1,134 @@
+# Własna warstwa danych i logiki dla astroklienta (PR 5).
+#
+# OSOBNY UDZIAŁ, nie osobny katalog na wspólnym. Pule kont izolują klientów od
+# siebie w każdym wariancie, ale to jest izolacja PROGRAMOWA — opiera się na
+# poprawności mechanizmu pul. Granica na poziomie systemu plików nie zależy od
+# tego, czy w kodzie niczego nie przeoczono, i dlatego pliki klientów nie leżą
+# ani przy bazach produkcyjnych, ani przy danych demonstracyjnych.
+#
+# Przy sprzątaniu demo nie da się przez pomyłkę skasować cudzych danych, bo są
+# gdzie indziej.
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: data-astroklient
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: data-astroklient }
+  template:
+    metadata:
+      labels: { app: data-astroklient }
+    spec:
+      # Warstwa danych ciągnie pandas, a przez nią NumPy budowane z bazą
+      # x86-64-v2. Węzeł bez tych rozszerzeń nie uruchomi kontenera, a komunikat
+      # mówi o „baseline optimizations", nie o węźle. Etykieta jest wymagana,
+      # więc nowy, nieoznaczony węzeł daje czytelny Pending zamiast pętli
+      # restartów (patrz README.md, „Wymóg węzłów: rozszerzenia procesora").
+      affinity:
+        nodeAffinity:
+          requiredDuringSchedulingIgnoredDuringExecution:
+            nodeSelectorTerms:
+              - matchExpressions:
+                  - key: astrololo.czernobog.pl/cpu-x86-64-v2
+                    operator: In
+                    values: ["true"]
+      automountServiceAccountToken: false
+      imagePullSecrets: [{ name: gitea-registry }]
+      containers:
+        - name: data
+          image: gitea.czernobog.pl/gitea/astrololo-data:latest
+          ports: [{ containerPort: 8002 }]
+          env:
+            - name: DATA_PROVIDER
+              value: "excel"
+            - name: EXCEL_DIR
+              value: "/app/data_files"
+            - name: CACHE_DIR
+              value: "/app/.cache"
+            - name: INTERNAL_TOKEN
+              valueFrom:
+                secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
+            - name: LINK_KEY_LOGIC_DATA
+              valueFrom:
+                secretKeyRef: { name: astrololo-link, key: LINK_KEY_LOGIC_DATA }
+            - name: LINK_ENCRYPTION_REQUIRED
+              value: "true"
+          volumeMounts:
+            - name: cache
+              mountPath: /app/.cache
+            - name: klient
+              mountPath: /app/data_files
+          resources:
+            requests: { cpu: "100m", memory: "256Mi" }
+            limits:   { cpu: "500m", memory: "512Mi" }
+      volumes:
+        - name: cache
+          emptyDir: {}
+        - name: klient
+          nfs:
+            server: 192.168.1.34
+            path: /mnt/Tank1/astrololo-klient
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: data-astroklient
+  namespace: astrololo
+spec:
+  type: ClusterIP
+  selector: { app: data-astroklient }
+  ports: [{ port: 8002, targetPort: 8002 }]
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: logic-astroklient
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: logic-astroklient }
+  template:
+    metadata:
+      labels: { app: logic-astroklient }
+    spec:
+      automountServiceAccountToken: false
+      imagePullSecrets: [{ name: gitea-registry }]
+      containers:
+        - name: logic
+          image: gitea.czernobog.pl/gitea/astrololo-logic:latest
+          ports: [{ containerPort: 8001 }]
+          env:
+            - name: DATA_URL
+              value: "http://data-astroklient:8002"
+            # Silnik własny, permisywny. Silnik B (Swiss Ephemeris, AGPL) nie
+            # wchodzi do produktu oddawanego klientom.
+            - name: EPHEMERIS_ENGINE
+              value: "own"
+            - name: INTERNAL_TOKEN
+              valueFrom:
+                secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
+            - name: LINK_KEY_PRESENTATION_LOGIC
+              valueFrom:
+                secretKeyRef: { name: astrololo-link, key: LINK_KEY_PRESENTATION_LOGIC }
+            - name: LINK_KEY_LOGIC_DATA
+              valueFrom:
+                secretKeyRef: { name: astrololo-link, key: LINK_KEY_LOGIC_DATA }
+            - name: LINK_ENCRYPTION_REQUIRED
+              value: "true"
+          resources:
+            requests: { cpu: "100m", memory: "128Mi" }
+            limits:   { cpu: "500m", memory: "512Mi" }
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: logic-astroklient
+  namespace: astrololo
+spec:
+  type: ClusterIP
+  selector: { app: logic-astroklient }
+  ports: [{ port: 8001, targetPort: 8001 }]

astrololo/astroklient.yaml

@@ -0,0 +1,64 @@
+# Astroklient — warstwa pośrednia (PR 4/5).
+#
+# Pełne funkcje astrologiczne, bez generowania tekstu i bez administracji.
+# Obraz NIE ZAWIERA plików usuniętych wg usun.txt, więc nie ma tu czego wyłączać
+# ani czym odsłaniać: to jest osobny produkt, a nie pełna aplikacja z zaciągniętą
+# kurtyną.
+#
+# Konta pochodzą wyłącznie z sekretu (ASTROKLIENT_USERS), każde ma własną pulę
+# plików na udziale astrololo-klient. Nie ma pliku kont, więc nie ma wolumenu
+# stanu: sesje żyją w podpisanym ciasteczku.
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: astroklient
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: astroklient }
+  template:
+    metadata:
+      labels: { app: astroklient }
+    spec:
+      automountServiceAccountToken: false
+      imagePullSecrets: [{ name: gitea-registry }]
+      containers:
+        - name: astroklient
+          image: gitea.czernobog.pl/gitea/astrololo-astroklient:latest
+          ports: [{ containerPort: 8006 }]
+          env:
+            - name: LOGIC_URL
+              value: "http://logic-astroklient:8001"
+            - name: ASTROKLIENT_USERS
+              valueFrom:
+                secretKeyRef: { name: astrololo-astroklient, key: ASTROKLIENT_USERS }
+            - name: SESSION_SECRET
+              valueFrom:
+                secretKeyRef: { name: astrololo-astroklient, key: SESSION_SECRET }
+            - name: INTERNAL_TOKEN
+              valueFrom:
+                secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
+            - name: LINK_KEY_PRESENTATION_LOGIC
+              valueFrom:
+                secretKeyRef: { name: astrololo-link, key: LINK_KEY_PRESENTATION_LOGIC }
+            - name: LINK_ENCRYPTION_REQUIRED
+              value: "true"
+            - name: TRUST_PROXY
+              value: "true"
+            - name: RATE_LIMIT_PER_MIN
+              value: "60"
+          resources:
+            requests: { cpu: "50m", memory: "128Mi" }
+            limits:   { cpu: "500m", memory: "384Mi" }
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: astroklient
+  namespace: astrololo
+spec:
+  type: ClusterIP
+  selector: { app: astroklient }
+  ports: [{ port: 8006, targetPort: 8006 }]

astrololo/data.yaml

@@ -12,6 +12,26 @@ spec:
       # LOG-33: pody nie rozmawiają z API Kubernetesa, więc token konta
       # serwisowego jest im niepotrzebny — a zamontowany byłby gotowym
       # punktem wyjścia do klastra dla kogoś, kto przejmie kontener.
+      # Ta usługa liczy na pandas, a przez nią na NumPy. Koła NumPy z PyPI są
+      # budowane z bazą x86-64-v2, więc na węźle bez tych rozszerzeń kontener
+      # NIE WSTAJE: `import numpy` kończy się RuntimeError, pod wpada w pętlę
+      # restartów, a komunikat mówi o „baseline optimizations" — czyli o niczym,
+      # po czym dałoby się poznać, że chodzi o węzeł.
+      #
+      # Wymagana ETYKIETA, a nie wykluczony konkretny węzeł. Nowy węzeł jest
+      # domyślnie NIEOZNACZONY, więc nie dostanie tu poda, dopóki ktoś go nie
+      # sprawdzi (skrypt w README) i nie oznaczy świadomie. Pending z czytelnym
+      # powodem jest lepszy niż pętla restartów z komunikatem o optymalizacjach —
+      # a wykluczanie węzłów po nazwie znaczyłoby, że każdy KOLEJNY źle
+      # postawiony węzeł znów zbiera się przez awarię.
+      affinity:
+        nodeAffinity:
+          requiredDuringSchedulingIgnoredDuringExecution:
+            nodeSelectorTerms:
+              - matchExpressions:
+                  - key: astrololo.czernobog.pl/cpu-x86-64-v2
+                    operator: In
+                    values: ["true"]
       automountServiceAccountToken: false
       imagePullSecrets: [{ name: gitea-registry }]
       containers:

astrololo/image-updater.yaml

@@ -36,8 +36,13 @@ spec:
           imageName: gitea.czernobog.pl/gitea/astrololo-render
         # Wersja demo (PRE-28). Obraz, którego nie ma na tej liście, NIGDY się nie
         # podbije, choćby CI go budowało — tak przez chwilę wisiał render na :latest.
-        - alias: astroklient-demo
-          imageName: gitea.czernobog.pl/gitea/astrololo-astroklient-demo
+        - alias: astrodemo
+          imageName: gitea.czernobog.pl/gitea/astrololo-astrodemo
+        # BEZ TEGO WPISU nowa usługa NIE DEPLOYUJE SIĘ SAMA: obraz powstaje
+        # w rejestrze, ale kustomization zostaje na starym tagu i wygląda to na
+        # zepsute CI. Tak zawisł kiedyś render.
+        - alias: astroklient
+          imageName: gitea.czernobog.pl/gitea/astrololo-astroklient
   commonUpdateSettings:
     updateStrategy: newest-build
   writeBackConfig:

astrololo/ingress.yaml

@@ -73,3 +73,85 @@ spec:
             pathType: Prefix
             backend:
               service: { name: presentation, port: { number: 8000 } }
+---
+# ── astrodemo ──────────────────────────────────────────────────────────────
+# Osobny host, nie ścieżka pod astrololo.czernobog.pl. Ścieżka („/demo") dzieliłaby
+# z pełną aplikacją pochodzenie w rozumieniu przeglądarki, czyli i ciasteczka:
+# wejście do jednej ruszałoby sesję w drugiej. Osobny host trzyma je rozdzielnie.
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: astrodemo
+  namespace: astrololo
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: websecure
+    traefik.ingress.kubernetes.io/router.middlewares: astrololo-security-headers@kubernetescrd
+spec:
+  tls:
+    - hosts: [astrodemo.czernobog.pl]
+      secretName: astrololo-tls           # ten sam certyfikat obejmuje oba hosty (tls.yaml)
+  rules:
+    - host: astrodemo.czernobog.pl
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: astrodemo, port: { number: 8005 } }
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: astrodemo-redirect
+  namespace: astrololo
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: web
+    traefik.ingress.kubernetes.io/router.middlewares: astrololo-redirect-https@kubernetescrd
+spec:
+  rules:
+    - host: astrodemo.czernobog.pl
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: astrodemo, port: { number: 8005 } }
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: astroklient
+  namespace: astrololo
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: websecure
+    traefik.ingress.kubernetes.io/router.middlewares: astrololo-security-headers@kubernetescrd
+spec:
+  tls:
+    - hosts: [astroklient.czernobog.pl]
+      secretName: astrololo-tls           # ten sam certyfikat obejmuje wszystkie hosty (tls.yaml)
+  rules:
+    - host: astroklient.czernobog.pl
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: astroklient, port: { number: 8006 } }
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: astroklient-redirect
+  namespace: astrololo
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: web
+    traefik.ingress.kubernetes.io/router.middlewares: astrololo-redirect-https@kubernetescrd
+spec:
+  rules:
+    - host: astroklient.czernobog.pl
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service: { name: astroklient, port: { number: 8006 } }

astrololo/kustomization.yaml

@@ -5,20 +5,29 @@ resources:
   - postgres.yaml # lustro baz Excela w SQL (DAN-28) — sekret astrololo-postgres POZA repo
   - data.yaml
   - logic.yaml
+  - astrodemo-stack.yaml # OSOBNA warstwa danych i logiki dla demo (PRE-29)
+  - astrodemo.yaml # wersja demo (PRE-28) — sekret astrololo-astrodemo POZA repo
+  - astroklient-stack.yaml # OSOBNA warstwa danych i logiki dla astroklienta (PR 5)
+  - astroklient.yaml # warstwa pośrednia — sekret astrololo-astroklient POZA repo
   - presentation.yaml
-  - astroklient-demo-stack.yaml # OSOBNA warstwa danych i logiki dla demo (PRE-29)
-  - astroklient-demo.yaml # wersja demo (PRE-28) — sekret astrololo-demo POZA repo
   - render.yaml # składanie raportu PDF (PRE-24), osobny obraz z TeX Live
   - tls.yaml # certyfikat z własnego CA (wymaga cert-managera)
   - ingress.yaml # wejście po https + przekierowanie z http
+  # Definicja obserwatora obrazów — WDRAŻANA, a nie wklepywana ręcznie.
+  # Póki jej tu nie było, plik w gicie i stan klastra rozjeżdżały się w ciszy:
+  # dopisanie usługi do listy nie robiło nic, bo listy nikt nie stosował.
+  # Mieszka w przestrzeni argocd — projekt to dopuszcza (destinations: '*').
+  - image-updater.yaml
 images:
   - name: gitea.czernobog.pl/gitea/astrololo-data
-    newTag: ee3c515d
+    newTag: fd79513c
   - name: gitea.czernobog.pl/gitea/astrololo-logic
-    newTag: ee3c515d
+    newTag: 10970c57
   - name: gitea.czernobog.pl/gitea/astrololo-render
     newTag: latest
-  - name: gitea.czernobog.pl/gitea/astrololo-astroklient-demo
-    newTag: latest
   - name: gitea.czernobog.pl/gitea/astrololo-presentation
-    newTag: ee3c515d
+    newTag: 338ec24e
+  - name: gitea.czernobog.pl/gitea/astrololo-astrodemo
+    newTag: fd79513c
+  - name: gitea.czernobog.pl/gitea/astrololo-astroklient
+    newTag: 338ec24e

astrololo/presentation.yaml

@@ -32,6 +32,13 @@ spec:
                 secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
             - name: APP_USER
               value: "astrololo"
+            # Klucz podpisu ciasteczek sesji (LOG-34). WYMAGANY — pod bez niego
+            # celowo nie wstaje: usługa z kontami, ale bez klucza, nie umiałaby
+            # odróżnić ważnej sesji od podrobionej. Rotacja tego klucza WYLOGOWUJE
+            # WSZYSTKICH, i tak ma być — to jest awaryjny wyłącznik.
+            - name: SESSION_SECRET
+              valueFrom:
+                secretKeyRef: { name: astrololo-auth, key: SESSION_SECRET }
             - name: RATE_LIMIT_PER_MIN
               value: "120"                       # 0 = bez limitu
             # Aplikacja stoi za Ingressem, więc bezpośrednim rozmówcą jest zawsze

astrololo/tls.yaml

@@ -59,6 +59,10 @@ spec:
   commonName: astrololo.czernobog.pl
   dnsNames:
     - astrololo.czernobog.pl
+    # Jeden certyfikat na oba hosty. Osobny wymagałby osobnego sekretu i osobnego
+    # odnawiania, a to ten sam klaster i ten sam wystawca.
+    - astrodemo.czernobog.pl
+    - astroklient.czernobog.pl
   duration: 2160h                         # 90 dni
   renewBefore: 720h                       # 30 dni zapasu
   privateKey: { algorithm: ECDSA, size: 256, rotationPolicy: Always }

conjurer/bot.yaml

@@ -31,6 +31,19 @@ spec:
             # Where the librarian sends THIS bot's results/pongs back to (its own
             # NodePort). Lets one librarian serve both bots - see deploy-bot.yaml.
             - { name: CONJURER_SELF_CALLBACK,     value: "http://192.168.1.73:32442" }
+            # Self-hosted models (Ollama). No API key - the endpoint IS the
+            # configuration, and the backend stays unselectable while unset.
+            # Pick a model at runtime with: $gadaj_teraz ollama <model>
+            # ($modele_ai lists what the server actually has pulled).
+            - { name: CONJURER_OLLAMA_URL,        value: "http://192.168.1.72:11434" }
+            # The server currently has exactly one model pulled (verified via
+            # /v1/models): gemma4:e2b. Without this the built-in default
+            # (llama3.1:8b) would be requested and every reply would fail.
+            - { name: CONJURER_OLLAMA_MODEL,      value: "gemma4:e2b" }
+            # Self-hosted generation is far slower than a hosted API, especially
+            # the first request after the model is evicted from VRAM. Applies to
+            # every backend, so keep it only as high as you actually need.
+            - { name: CONJURER_AI_TIMEOUT_SECONDS, value: "240" }
           volumeMounts:
             - { name: data,  mountPath: /data }
             - { name: netrc, mountPath: /secrets, readOnly: true }

conjurer/deploy-bot.yaml

@@ -51,6 +51,19 @@ spec:
             # query and answers results/pongs HERE - so it serves this bot AND the
             # test bot from one instance, no CONJURER_MAIN_BOT repointing needed.
             - { name: CONJURER_SELF_CALLBACK,     value: "http://192.168.1.73:32443" }
+            # Self-hosted models (Ollama). No API key - the endpoint IS the
+            # configuration, and the backend stays unselectable while unset.
+            # Pick a model at runtime with: $gadaj_teraz ollama <model>
+            # ($modele_ai lists what the server actually has pulled).
+            - { name: CONJURER_OLLAMA_URL,        value: "http://192.168.1.72:11434" }
+            # The server currently has exactly one model pulled (verified via
+            # /v1/models): gemma4:e2b. Without this the built-in default
+            # (llama3.1:8b) would be requested and every reply would fail.
+            - { name: CONJURER_OLLAMA_MODEL,      value: "gemma4:e2b" }
+            # Self-hosted generation is far slower than a hosted API, especially
+            # the first request after the model is evicted from VRAM. Applies to
+            # every backend, so keep it only as high as you actually need.
+            - { name: CONJURER_AI_TIMEOUT_SECONDS, value: "240" }
           volumeMounts:
             - { name: data,  mountPath: /data }
             - { name: netrc, mountPath: /secrets, readOnly: true }

conjurer/kustomization.yaml

@@ -8,9 +8,9 @@ resources:
   - deploy-bot-backup.yaml
 images:
   - name: gitea.czernobog.pl/gitea/conjurer-librarian
-    newTag: d0c7ab61
+    newTag: c91ec03b
   - name: gitea.czernobog.pl/gitea/conjurer-bot
-    newTag: d0c7ab61
+    newTag: c91ec03b
   # Production bot channel - only bumped when a [deploy]-tagged build appears.
   # Bootstrapped to fbd1ec9f: that's the image the first [deploy] build (merge
   # of conjurer#20) promoted to conjurer-bot-deploy. From here the image-updater