feat(astroklient-demo): własny klucz podpisu sesji (LOG-34)

SESSION_SECRET w sekrecie astrololo-demo — WŁASNY, nie ten z pełnej aplikacji:
demo i produkcja nie mają powodu uznawać nawzajem swoich sesji.

W runbooku zapisana różnica wobec pełnej wersji: demo nie ma własnego wolumenu,
więc nie ma licznika sesji. Zdalne unieważnienie robi się przez DEMO_USERS —
usunięcie konta albo zmiana hasła natychmiast ubija jego otwarte sesje.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

astrololo/README-astroklient-demo.md

@@ -0,0 +1,188 @@
+# astroklient-demo — 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`
+w repo aplikacji.
+
+---
+
+## Jak to jest odizolowane
+
+```
+astroklient-demo  →  logic-demo  →  data-demo  →  /mnt/Tank1/astrololo-demo
+                                              └── klientA/   ← pula konta
+                                              └── klientB/   ← pula konta
+```
+
+**Oryginalne bazy są dla demo nieosiągalne.** Nie chodzi o uprawnienia: demo ma
+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
+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ą
+swoich plików nawzajem ani w liście, ani w wynikach wyszukiwania. Pula bierze się
+z **loginu zalogowanej osoby**, nigdy z pola formularza.
+
+---
+
+## Krok 1 — udział `astrololo-demo` na TrueNAS
+
+Ta sama procedura co przy `astrololo-state`, więc jeśli tamten działa, ten też
+zadziała. Po SSH na NAS:
+
+```bash
+sudo zfs create Tank1/astrololo-demo    # albo: sudo mkdir -p /mnt/Tank1/astrololo-demo
+```
+
+```bash
+midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo-demo"]]' \
+  | python3 -m json.tool
+```
+
+**Pusta lista `[]`** — twórz:
+
+```bash
+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"],
+  "enabled": true,
+  "ro": false,
+  "mapall_user": "root",
+  "mapall_group": "root"
+}'
+```
+
+**Coś zwróciło** — weź `id` i użyj `sharing.nfs.update <ID>` z tą samą treścią.
+
+```bash
+midclt call service.restart nfs
+sudo exportfs -v | grep astrololo-demo
+```
+
+Musi tam być `rw`. Sprawdź jeszcze zapis z węzła — to jest ten test, którego
+zabrakło przy poprzednim udziale:
+
+```bash
+ssh <węzeł> 'sudo mkdir -p /mnt/t && sudo mount -t nfs 192.168.1.34:/mnt/Tank1/astrololo-demo /mnt/t \
+  && sudo touch /mnt/t/proba && echo ZAPIS-OK || echo ZAPIS-NIE; sudo rm -f /mnt/t/proba; sudo umount /mnt/t'
+```
+
+---
+
+## Krok 2 — konta demo
+
+Każde konto to osobna pula, więc **rozdajesz konta, nie jedno hasło**.
+
+Hasła najlepiej jako hash — wtedy nie leżą nigdzie jawnie (skrypt jest w repo
+aplikacji, `services/presentation/scripts/make_user.py`):
+
+```bash
+python scripts/make_user.py klientA     # wypisze: scrypt$…
+python scripts/make_user.py klientB
+```
+
+```bash
+kubectl -n astrololo create secret generic astrololo-demo \
+  --from-literal=DEMO_USERS='klientA:scrypt$…,klientB:scrypt$…' \
+  --from-literal=SESSION_SECRET="$(openssl rand -hex 32)"
+```
+
+`SESSION_SECRET` podpisuje ciasteczka sesji (LOG-34). **Pod bez niego celowo nie
+wstanie.** Jest WŁASNY, nie ten z pełnej aplikacji: demo i produkcja nie mają
+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
+> 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)
+
+kubectl -n astrololo create secret generic astrololo-demo \
+  --from-literal=DEMO_USERS="${STARE},klientC:scrypt\$…" \
+  --dry-run=client -o yaml | kubectl apply -f -
+
+kubectl -n astrololo rollout restart deploy/astroklient-demo
+```
+
+### Odebranie dostępu
+
+Usuń wpis z `DEMO_USERS` tą samą drogą. **Pula zostaje na udziale** — pliki
+klienta nie znikają, tylko przestaje być komu je pokazywać.
+
+---
+
+## Krok 3 — wdrożenie
+
+```bash
+kubectl apply -k astrololo
+kubectl -n astrololo rollout status deploy/data-demo deploy/logic-demo deploy/astroklient-demo
+```
+
+Sprawdzenie na czas jednej sesji, bez wystawiania na świat:
+
+```bash
+kubectl -n astrololo port-forward deploy/astroklient-demo 8005:8005
+```
+
+Wejście z zewnątrz wymaga reguły w `ingress.yaml` — osobny host albo ścieżka.
+**Celowo nie zakładam tego za Ciebie**: to decyzja, pod jakim adresem świat
+zobaczy demo.
+
+---
+
+## Import puli klienta do pełnej aplikacji
+
+Sedno całego układu: klient, który przechodzi na pełną wersję, **nie traci
+dotychczasowych wgrań**. Jego pula to jeden katalog.
+
+**1. Zobacz, co tam jest** (na NAS):
+
+```bash
+LOGIN=klientA
+sudo ls -la /mnt/Tank1/astrololo-demo/$LOGIN/
+```
+
+**2. Sprawdź kolizje nazw** z bazami produkcyjnymi:
+
+```bash
+comm -12 \
+  <(cd /mnt/Tank1/astrololo-demo/$LOGIN && ls *.xlsx 2>/dev/null | sort) \
+  <(cd /mnt/Tank1/astrololo && ls *.xlsx 2>/dev/null | sort)
+```
+
+Pusto = brak kolizji. Cokolwiek się wypisze, przenieś ręcznie pod inną nazwą —
+**nie nadpisuj bazy produkcyjnej**.
+
+**3. Skopiuj** (`-n` = nie nadpisuj niczego, co już jest):
+
+```bash
+sudo cp -n /mnt/Tank1/astrololo-demo/$LOGIN/*.xlsx /mnt/Tank1/astrololo/
+```
+
+> Kopiujemy **tylko pliki `.xlsx`**. Plik `.files-state.json` zostaje — opisuje
+> stan wewnątrz puli demo i w produkcji nie ma sensu; produkcja ma własny.
+
+**4. Włącz je w pełnej aplikacji**: zakładka **Pliki**, nowe bazy pojawią się jako
+„gotowa, odstawiona". Klikasz przełącznik przy tych, które mają wejść do użytku.
+
+To, że nie włączają się same, jest zamierzone: przeniesienie plików jest czynnością
+techniczną, a decyzja, które bazy biorą udział w interpretacji, należy do Ciebie.
+
+---
+
+## Odcięcie całego demo
+
+```bash
+kubectl -n astrololo scale deploy/astroklient-demo --replicas=0
+```
+
+Pule i dane zostają. Skasowanie sekretu `astrololo-demo` zatrzyma pod (nie wstanie
+bez niego) i to też jest zachowanie zamierzone.

astrololo/README-pliki.md

@@ -0,0 +1,133 @@
+# Zarządzanie plikami baz — otwarcie udziału na zapis (DAN-27)
+
+Ekran „Pliki" pozwala wgrywać bazy, archiwizować je i (dla administratora)
+kasować, a stan użycia jest **klikany**, więc musi być trwały. Wymaga to zapisu
+do udziału z bazami — a ten jest dziś wyeksportowany tylko do odczytu.
+
+---
+
+## Co świadomie tracimy
+
+DAN-25 dawał gwarancję, że **baz nie da się zmienić przez NFS**. DAN-27 tę
+gwarancję z definicji znosi — nie da się mieć obu naraz.
+
+**Co zostaje:**
+
+| zabezpieczenie | działa nadal |
+|---|---|
+| eksport zawężony do trzech węzłów k8s | ✅ |
+| token międzywarstwowy | ✅ |
+| szyfrowane łącze prezentacja ↔ logika ↔ dane | ✅ |
+| kasowanie plików wyłącznie z konta administracyjnego (PRE-27) | ✅ |
+| dziennik audytowy (kto, kiedy, co) | ✅ |
+
+Ryzyko, które przybywa: **przejęcie warstwy danych pozwala teraz nie tylko
+odczytać bazy, ale i je zmienić.**
+
+---
+
+## Krok 1 — otwórz udział na zapis
+
+```bash
+midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo"]]' \
+  | python3 -c "import sys,json;[print(s['id'], '| ro:', s['ro'], '| mapall:', s.get('mapall_user')) for s in json.load(sys.stdin)]"
+```
+
+Weź `id` i podstaw za `<ID>`:
+
+```bash
+midclt call sharing.nfs.update <ID> '{"ro": false, "mapall_user": "root", "mapall_group": "root"}'
+```
+
+> **Dlaczego `mapall_user`, skoro katalog ma `drwxrwxrwx`?** Samo `ro: false`
+> wystarczyłoby do zapisu — zmapowany `nobody` mieści się w prawach „innych".
+> Ale nowe pliki należałyby wtedy do `nobody`, a istniejące bazy do `root`.
+> Mieszana własność zemści się przy pierwszym zaostrzeniu praw. `mapall_user:
+> root` daje spójność i jest tym samym ustawieniem, co na udziale `astrololo-state`.
+
+```bash
+midclt call service.restart nfs
+```
+
+Sprawdź, że zmiana **faktycznie trafiła do jądra** — sama konfiguracja to za mało:
+
+```bash
+sudo exportfs -v | grep -A1 "Tank1/astrololo "
+```
+
+Przy `/mnt/Tank1/astrololo` musi być `rw`, nie `ro`.
+
+---
+
+## Krok 2 — zmerguj oba PR-y
+
+* aplikacja: `feat/zarzadzanie-plikami`
+* deploy: `feat/pliki-zapis` (zdejmuje `readOnly` z montowania w podzie)
+
+Bez tego drugiego pod nadal montuje udział tylko do odczytu, choćby serwer
+pozwalał pisać.
+
+---
+
+## Krok 3 — przeładuj warstwę danych PRZEZ ZERO REPLIK
+
+> ⚠️ **`rollout restart` NIE WYSTARCZY.** Stary i nowy pod na chwilę
+> współistnieją, więc montowanie NFS ani na moment nie zostaje bez użytkownika
+> i nowy pod dziedziczy uprawnienia sprzed zmiany eksportu. To kosztowało
+> najwięcej czasu przy udziale `astrololo-state` — patrz
+> [README-stan-prezentacji.md](README-stan-prezentacji.md).
+
+```bash
+kubectl -n astrololo scale deploy/data --replicas=0
+kubectl -n astrololo wait --for=delete pod -l app=data --timeout=90s
+kubectl -n astrololo scale deploy/data --replicas=1
+kubectl -n astrololo rollout status deploy/data
+```
+
+---
+
+## Krok 4 — sprawdź, w tej kolejności
+
+**Czy warstwa danych może pisać:**
+
+```bash
+kubectl -n astrololo exec deploy/data -- sh -c 'touch /app/data_files/proba && echo ZAPIS-OK && rm /app/data_files/proba'
+```
+
+**Czy powstał plik stanu i czy bazy zostały przyjęte jako aktywne:**
+
+```bash
+kubectl -n astrololo exec deploy/data -- sh -c 'cat /app/data_files/.files-state.json' | head -20
+```
+
+Oczekiwane: każda baza ze `"status": "active"`. Przy pierwszym uruchomieniu bazy
+zastane na udziale są przyjmowane automatycznie — **bez tego wyszukiwanie
+przestałoby cokolwiek znajdować**, bo plik bez wpisu w rejestrze nie bierze
+udziału w wynikach.
+
+**Czy wyszukiwanie NADAL DZIAŁA** — to jest najważniejszy sprawdzian tego
+wdrożenia, bo właśnie tu zmiana mogłaby przejść niezauważona:
+
+```bash
+kubectl -n astrololo logs deploy/data --tail=20
+```
+
+a potem w przeglądarce: zakładka **Sygnifikatory**, dowolne wyszukanie. Musi
+zwracać wyniki jak przedtem. Jeśli nagle nic nie znajduje — zajrzyj do
+`.files-state.json` z komendy wyżej.
+
+**Czy ekran „Pliki" działa:** zakładka **Pliki**, lista baz, przełącznik przy
+każdej. Wgraj testowy plik, zarchiwizuj go, skasuj.
+
+---
+
+## Odkręcenie
+
+```bash
+midclt call sharing.nfs.update <ID> '{"ro": true, "mapall_user": null, "mapall_group": null}'
+midclt call service.restart nfs
+```
+
+plus cofnięcie deploy `feat/pliki-zapis`. Ekran „Pliki" zostanie, ale wgrywanie
+i kasowanie przestaną działać — a stan użycia przestanie się zapisywać, więc bazy
+będą przyjmowane od nowa przy każdym starcie (czyli wszystkie aktywne).

astrololo/README-stan-prezentacji.md

@@ -0,0 +1,135 @@
+# Udział na stan prezentacji — `astrololo-state`
+
+Potrzebny do kont zakładanych z ekranu „Konta" (PRE-27). **Bez niego pod
+`presentation` nie wstanie.**
+
+---
+
+## Dlaczego osobny udział, a nie podkatalog
+
+Pierwsza wersja montowała `/mnt/Tank1/astrololo` z `subPath: presentation-state`
+i pod stanął w `CreateContainerConfigError`:
+
+```
+failed to create subPath directory for volumeMount "state" of container "presentation"
+```
+
+Przyczyna była podwójna i za każdym razem ta sama: udział z bazami jest
+wyeksportowany **`ro: true` z `root_squash`** (patrz runbook DAN-25 w repo
+aplikacji). Zatem:
+
+1. kubelet nie mógł utworzyć podkatalogu — bo udział jest tylko do odczytu,
+2. a gdyby nawet mógł, aplikacja i tak nie zapisałaby tam pliku kont.
+
+**Osobny udział rozwiązuje to bez ruszania DAN-25.** Udział z bazami zostaje tylko
+do odczytu; konta dostają własne, małe miejsce. Przy okazji znika `subPath`, czyli
+znika potrzeba, żeby kubelet cokolwiek zakładał — katalog istnieje, bo jest
+korzeniem udziału.
+
+---
+
+## Krok 1 — dataset i udział na TrueNAS
+
+Po SSH na NAS (192.168.1.34). Konwencja jak w DAN-25: **nie edytujemy
+`/etc/exports` ręcznie**, tylko przez `midclt`.
+
+```bash
+# dataset
+sudo zfs create Tank1/astrololo-state
+```
+
+Jeśli `Tank1` nie jest pulą ZFS albo wolisz zwykły katalog:
+
+```bash
+sudo mkdir -p /mnt/Tank1/astrololo-state
+```
+
+### Właściciel i prawa
+
+Kontenery aplikacji działają **jako root**, a eksport ma `root_squash`, więc root
+z klienta NIE jest rootem na udziale. Żeby zapis działał, przypinamy cały ruch
+z tych hostów do jednego, nieuprzywilejowanego użytkownika — to bezpieczniejsze
+niż `no_root_squash`, bo nie oddaje roota.
+
+```bash
+# użytkownik, na którego mapujemy (jeśli nie istnieje — utwórz w UI TrueNAS)
+sudo chown -R apps:apps /mnt/Tank1/astrololo-state
+sudo chmod 770 /mnt/Tank1/astrololo-state
+```
+
+> Podstaw swojego użytkownika w miejsce `apps`. Sprawdzisz istniejących:
+> `midclt call user.query | python3 -c "import sys,json;[print(u['uid'], u['username']) for u in json.load(sys.stdin)]"`
+
+### Eksport NFS
+
+```bash
+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"],
+  "ro": false,
+  "mapall_user": "apps",
+  "mapall_group": "apps"
+}'
+```
+
+| ustawienie | po co |
+|---|---|
+| `hosts` zawężone | te same trzy węzły k8s co w DAN-25 — nikt inny nie zamontuje |
+| `ro: false` | **musi być zapisywalny**, inaczej konta się nie zapiszą |
+| `mapall_user` | cały ruch pisze jako jeden nieuprzywilejowany użytkownik, niezależnie od UID w kontenerze |
+
+> Podstaw swoje adresy węzłów, jeśli się zmieniły. Aktualne:
+> `kubectl get nodes -o wide`
+
+---
+
+## Krok 2 — sprawdź z węzła, ZANIM wdrożysz
+
+To jest ten test, którego zabrakło za pierwszym razem:
+
+```bash
+ssh 192.168.1.73 'sudo mount -t nfs 192.168.1.34:/mnt/Tank1/astrololo-state /mnt/test \
+  && sudo touch /mnt/test/proba && echo "ZAPIS DZIAŁA" \
+  && sudo rm /mnt/test/proba; sudo umount /mnt/test'
+```
+
+Musi wypisać **`ZAPIS DZIAŁA`**. Jeśli zamiast tego widzisz `Permission denied` —
+wróć do praw katalogu i `mapall_user` w kroku 1.
+
+---
+
+## Krok 3 — wdróż i sprawdź
+
+```bash
+kubectl apply -k astrololo
+kubectl -n astrololo rollout status deploy/presentation
+```
+
+Sprawdź, że aplikacja faktycznie umie tam zapisać — załóż konto testowe
+na ekranie „Konta", a potem:
+
+```bash
+kubectl -n astrololo exec deploy/presentation -- ls -l /app/state/
+```
+
+Oczekiwane: plik `accounts.json`.
+
+---
+
+## Odkręcenie
+
+```bash
+# ID udziału
+midclt call sharing.nfs.query | python3 -c "import sys,json;[print(s['id'], s.get('path')) for s in json.load(sys.stdin)]"
+midclt call sharing.nfs.delete <ID>
+```
+
+---
+
+## Uwaga na przyszłość: DAN-27 uderzy w tę samą ścianę
+
+Zarządzanie plikami baz (wgrywanie, archiwizacja, kasowanie) wymaga zapisu do
+**udziału z bazami** — a ten jest `ro: true`. Ten runbook tego **nie rozwiązuje**
+i celowo nie rusza DAN-25: to osobna decyzja, bo oznacza rezygnację z gwarancji,
+że baz nie da się zmienić przez NFS. Patrz PR `feat/pliki-zapis`.

astrololo/README.md

@@ -23,14 +23,20 @@ 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.
 
-## Postgres — lustro baz w SQL (DAN-28)
+## Pliki baz — udział otwarty na zapis (DAN-27)
 
-Osobny runbook: **[README-postgres.md](README-postgres.md)** — co zrobiono w repo,
+Runbook: **[README-pliki.md](README-pliki.md)**. Ekran „Pliki" wymaga zapisu do
-co musisz zrobić ręcznie (sekret `astrololo-postgres`), jak sprawdzić rozszerzenia
+udziału z bazami, więc znosi gwarancję z DAN-25, że baz nie da się zmienić przez
-`pg_trgm`/`unaccent` i jak odtworzyć całość bez ArgoCD.
+NFS. Co zostaje z zabezpieczeń i jak to wdrożyć — w runbooku.
 
-Postgres trzyma LUSTRO plików Excela, nie źródło prawdy — jego utrata nie jest
+## astroklient-demo — wersja demo (PRE-28)
-utratą danych, więc kopie zapasowe są opcjonalne.
+
+Osobna usługa o dwóch funkcjach. Runbook: **[README-astroklient-demo.md](README-astroklient-demo.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.
 
 ## ⚠️ Sekret `astrololo-auth` — utwórz PRZED wdrożeniem
 

astrololo/astroklient-demo-stack.yaml

@@ -0,0 +1,122 @@
+# 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
+# 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
+# baz. Każde konto demo dostaje w nim własny podkatalog (pulę) — patrz PRE-29.
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: data-demo
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: data-demo }
+  template:
+    metadata:
+      labels: { app: data-demo }
+    spec:
+      containers:
+        - name: data
+          # TEN SAM obraz co produkcja — różni się wyłącznie udziałem, na którym
+          # pracuje. Osobny obraz oznaczałby drugi kod do utrzymania i pewność,
+          # że kiedyś się rozjadą.
+          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: demo
+              mountPath: /app/data_files
+          resources:
+            requests: { cpu: "100m", memory: "256Mi" }
+            limits:   { cpu: "500m", memory: "512Mi" }
+      volumes:
+        - name: cache
+          emptyDir: {}
+        - name: demo
+          nfs:
+            server: 192.168.1.34
+            # OSOBNY udział, pusty na starcie. NIE /mnt/Tank1/astrololo —
+            # to jest cała istota izolacji demo.
+            path: /mnt/Tank1/astrololo-demo
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: data-demo
+  namespace: astrololo
+spec:
+  type: ClusterIP
+  selector: { app: data-demo }
+  ports: [{ port: 8002, targetPort: 8002 }]
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: logic-demo
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: logic-demo }
+  template:
+    metadata:
+      labels: { app: logic-demo }
+    spec:
+      containers:
+        - name: logic
+          image: gitea.czernobog.pl/gitea/astrololo-logic:latest
+          ports: [{ containerPort: 8001 }]
+          env:
+            # JEDYNA różnica wobec produkcyjnej logiki — i zarazem cała izolacja.
+            - name: DATA_URL
+              value: "http://data-demo:8002"
+            - 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"
+            # Bez kluczy do modeli językowych. Astroklient nie umie o nie prosić,
+            # więc ich tu nie ma — czego nie ma w podzie, tego nie wyniesie.
+          resources:
+            requests: { cpu: "100m", memory: "128Mi" }
+            limits:   { cpu: "500m", memory: "512Mi" }
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: logic-demo
+  namespace: astrololo
+spec:
+  type: ClusterIP
+  selector: { app: logic-demo }
+  ports: [{ port: 8001, targetPort: 8001 }]

astrololo/astroklient-demo.yaml

@@ -0,0 +1,86 @@
+# astroklient-demo — 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
+# 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).
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: astroklient-demo
+  namespace: astrololo
+spec:
+  replicas: 1
+  selector:
+    matchLabels: { app: astroklient-demo }
+  template:
+    metadata:
+      labels: { app: astroklient-demo }
+    spec:
+      containers:
+        - name: astroklient-demo
+          image: gitea.czernobog.pl/gitea/astrololo-astroklient-demo:latest
+          ports: [{ containerPort: 8005 }]
+          env:
+            # WŁASNA warstwa logiczna, wskazująca na WŁASNĄ warstwę danych.
+            # Wpisanie tu produkcyjnego `logic` cofnęłoby całą izolację demo
+            # jednym słowem — dlatego stoi to tuż obok siebie w jednym pliku.
+            - 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.
+            # 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
+              valueFrom:
+                secretKeyRef: { name: astrololo-demo, key: DEMO_USERS }
+            # Token międzywarstwowy i klucz łącza — TE SAME co prezentacja:
+            # demo nie jest furtką omijającą ochronę warstwy logicznej.
+            - 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"
+            # Klucz podpisu ciasteczek sesji (LOG-34). WYMAGANY — pod bez niego
+            # celowo nie wstaje. WŁASNY, nie ten z pełnej aplikacji: demo i produkcja
+            # nie mają powodu uznawać nawzajem swoich sesji, a wspólny klucz
+            # znaczyłby, że sesja z demo bywa ważna tam, gdzie nie powinna.
+            - name: SESSION_SECRET
+              valueFrom:
+                secretKeyRef: { name: astrololo-demo, 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.
+            - name: TRUST_PROXY
+              value: "true"
+            # Niższy niż w pełnej aplikacji: demo bywa udostępniane szerzej,
+            # a każde zapytanie sięga do treści baz.
+            - name: RATE_LIMIT_PER_MIN
+              value: "60"
+          resources:
+            requests: { cpu: "50m", memory: "96Mi" }
+            limits:   { cpu: "300m", memory: "256Mi" }
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: astroklient-demo
+  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 }
+  ports: [{ port: 8005, targetPort: 8005 }]

astrololo/data.yaml

@@ -57,9 +57,18 @@ spec:
           volumeMounts:
             - name: cache
               mountPath: /app/.cache
+            # ZAPISYWALNY od DAN-27. Wcześniej read-only, bo warstwa danych tylko
+            # czytała bazy — teraz ekran „Pliki" pozwala je wgrywać, archiwizować
+            # i (dla administratora) kasować, a stan użycia jest KLIKANY, więc musi
+            # przetrwać restart poda.
+            #
+            # ŚWIADOMY KOSZT: znika jedna warstwa obrony w głąb. Przejęcie warstwy
+            # danych pozwala teraz nie tylko odczytać bazy, ale i je zmienić.
+            # Zostaje reszta: token międzywarstwowy, szyfrowane łącze, ograniczenie
+            # eksportu NFS do konkretnych hostów (DAN-25) i to, że kasować może
+            # wyłącznie konto administracyjne (PRE-27).
             - name: excel
               mountPath: /app/data_files
-              readOnly: true
           resources:
             requests: { cpu: "100m", memory: "256Mi" }
             limits:   { cpu: "500m", memory: "512Mi" }

astrololo/image-updater.yaml

@@ -34,6 +34,10 @@ spec:
           imageName: gitea.czernobog.pl/gitea/astrololo-presentation
         - alias: render
           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
   commonUpdateSettings:
     updateStrategy: newest-build
   writeBackConfig:

astrololo/kustomization.yaml

@@ -6,15 +6,19 @@ resources:
   - data.yaml
   - logic.yaml
   - 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
 images:
   - name: gitea.czernobog.pl/gitea/astrololo-data
-    newTag: baf4e0e3
+    newTag: ee3c515d
   - name: gitea.czernobog.pl/gitea/astrololo-logic
-    newTag: baf4e0e3
+    newTag: ee3c515d
   - name: gitea.czernobog.pl/gitea/astrololo-render
-    newTag: aec3f843
+    newTag: latest
+  - name: gitea.czernobog.pl/gitea/astrololo-astroklient-demo
+    newTag: latest
   - name: gitea.czernobog.pl/gitea/astrololo-presentation
-    newTag: a8339659
+    newTag: ee3c515d

astrololo/presentation.yaml

@@ -66,12 +66,20 @@ spec:
             - name: ACCOUNTS_FILE
               value: "/app/state/accounts.json"
           volumeMounts:
-            # subPath, NIE cały udział: prezentacja dostaje wyłącznie własny
+            # OSOBNY UDZIAŁ, nie podkatalog udziału z bazami. Pierwsza wersja
-            # podkatalog i nie widzi baz interpretacyjnych. Zamontowanie tu całego
+            # montowała /mnt/Tank1/astrololo z subPath — i nie wstała:
-            # /mnt/Tank1/astrololo obeszłoby bokiem zamknięcie dostępu z DAN-25.
+            # „failed to create subPath directory”. Powód był podwójny i oba razy
+            # ten sam brak: udział z bazami jest wyeksportowany `ro: true`
+            # z `root_squash` (DAN-25), więc (1) kubelet nie mógł utworzyć
+            # podkatalogu, a (2) gdyby nawet mógł, aplikacja i tak nie zapisałaby
+            # tam pliku kont.
+            #
+            # Osobny udział rozwiązuje to bez naruszania DAN-25: udział z bazami
+            # ZOSTAJE tylko do odczytu, a konta mają własne, małe miejsce.
+            # Przy okazji znika subPath, czyli znika potrzeba, żeby kubelet
+            # cokolwiek zakładał — katalog istnieje, bo jest korzeniem udziału.
             - name: state
               mountPath: /app/state
-              subPath: presentation-state
           resources:
             requests: { cpu: "100m", memory: "128Mi" }
             limits:   { cpu: "300m", memory: "256Mi" }
@@ -79,7 +87,9 @@ spec:
         - name: state
           nfs:
             server: 192.168.1.34
-            path: /mnt/Tank1/astrololo
+            # Udział WYŁĄCZNIE na stan prezentacji (konta z PRE-27). Wymaga
+            # utworzenia na TrueNAS — patrz README-stan-prezentacji.md.
+            path: /mnt/Tank1/astrololo-state
 ---
 apiVersion: v1
 kind: Service

conjurer/kustomization.yaml

@@ -8,9 +8,9 @@ resources:
   - deploy-bot-backup.yaml
 images:
   - name: gitea.czernobog.pl/gitea/conjurer-librarian
-    newTag: ae1bd677
+    newTag: d0c7ab61
   - name: gitea.czernobog.pl/gitea/conjurer-bot
-    newTag: fbd1ec9f
+    newTag: d0c7ab61
   # 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