astrololo: generowanie tekstu jako moduł odłączalny (2/5)

Drugi z pięciu kroków budowy trzech produktów. Czysty refaktor — zachowanie
aplikacji się nie zmienia, liczba testów rośnie tylko o nowe.

DLACZEGO WARUNEK W SZABLONIE NIE WYSTARCZA. Dotąd generowanie było chowane przez
`{% if can(request, 'ai') %}`. To sprawia, że funkcji nie WIDAĆ, ale nie że jej
NIE MA: plik szablonu dalej leży w obrazie i dalej zawiera jej nazwy, więc `grep`
po kontenerze pokazuje wszystko, czego warunek nie pokazał na ekranie. Astroklient
ma nie mieć śladu, nie mieć wyłączoną funkcję — więc granica musi być KATALOGIEM.

CO SIĘ PRZENIOSŁO do app/dodatki/: dwa szablony, pięć plików statycznych, trasa
strumienia, cztery metody klienta warstwy logicznej, wpis w katalogu funkcji,
wpisy tras i zasobów, akcje formularza i reguły CSS nazywające funkcję
(`textarea.prompt`).

JAK APLIKACJA O TO PYTA. Neutralny most `app/rozszerzenia.py` odpowiada wyłącznie
na pytanie „czy coś jest podpięte i co wnosi". Sam nie wymienia ani jednej nazwy —
pilnuje tego osobny test, bo most jest w KAŻDYM obrazie. Dlatego też katalog
nazywa się `dodatki`, a nie `ai`: nazwa w instrukcji importu byłaby dokładnie tym
śladem, którego wydzielanie ma się pozbyć.

TRZY MIEJSCA, KTÓRE OKAZAŁY SIĘ TRUDNE:

1. Pola formularza. FastAPI czyta je z SYGNATURY, a wspólny handler nie może
   wymieniać `prompt_budget` ani `llm_provider`. Rozwiązane zależnością: moduł
   deklaruje własne pola u siebie, handler wie tylko, że dostaje słownik.
2. Klient warstwy logicznej jest wspólny, więc metody `prompt`/`horoscope`/
   `llm_models` musiały z niego wyjść. Wspólny klient daje teraz samą drogę
   w dół (`wywolaj`, `pobierz`, `strumien`) — z szyfrowaniem łącza i tokenem
   międzywarstwowym; co nią pojedzie, jest sprawą modułu.
3. Podtytuł ekranu Skompiluj miał wariant „z AI" i wariant bez. Zamiast warunku
   jedno zdanie prawdziwe niezależnie od tego, jakie moduły są w obrazie.

DOCKERFILE. `COPY . .` wnosiło do obrazu także testy — a plik testowy nazywa
funkcje wprost. Teraz wchodzi wyłącznie `app/`.

TEST GRANICY. `test_ai_tylko_w_module.py` przechodzi po wszystkim poza modułem
i szuka siedemnastu słów. Znalazł dwanaście resztek, których nie widziałem:
komentarze w main.py i security.py, przykład `models.js` w komentarzu features.py,
komentarze w compile.js i w trzech arkuszach, oraz regułę `textarea.prompt`,
która przy rozbijaniu CSS trafiła do arkuszy ekranów zamiast do modułu.

Ma też kontrolę pozytywną (te słowa MAJĄ padać w module — inaczej test
przechodziłby, gdyby funkcję wydrążono) i test odłączalności mostu.

SPRAWDZONE NA KOPII BEZ MODUŁU: aplikacja startuje, wszystkie ekrany oddają 200,
katalog ma 13 funkcji zamiast 14, trasy strumienia nie ma, spreparowane
`action=prompt` wraca do akcji domyślnej bez śladu, a `grep` po drzewie nie
znajduje ani jednego ze słów.

Testy: presentation 362, logic 342, data 37, render 41.

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

services/presentation/tests/skladanie.py

@@ -0,0 +1,25 @@
+"""Szablon widziany tak, jak zobaczy go przeglądarka — z wstawkami modułów.
+
+Szablony wspólne mają neutralne gniazda (`{% include "_dodatki_*" %}`), a treść
+wstawianą w gniazdo trzyma moduł. Testy strukturalne sprawdzają kolejność
+skryptów i obecność odsyłaczy, więc muszą patrzeć na CAŁOŚĆ — inaczej pilnowałyby
+połowy strony i przepuściłyby zamianę kolejności, która psuje działanie.
+"""
+from __future__ import annotations
+
+import pathlib
+import re
+
+APP = pathlib.Path(__file__).resolve().parents[1] / "app"
+GNIAZDO = re.compile(r'\{%\s*include\s*"(_dodatki_[\w-]+\.html)"[^%]*%\}')
+
+
+def zloz(nazwa: str) -> str:
+    """Treść szablonu z wstawkami rozwiniętymi W MIEJSCU gniazda."""
+    tresc = (APP / "templates" / nazwa).read_text(encoding="utf-8")
+
+    def wstaw(m: re.Match) -> str:
+        plik = APP / "dodatki" / "templates" / m.group(1)
+        return plik.read_text(encoding="utf-8") if plik.exists() else ""
+
+    return GNIAZDO.sub(wstaw, tresc)

services/presentation/tests/test_ai_tylko_w_module.py

@@ -0,0 +1,110 @@
+"""Granica modułu generowania jest KATALOGIEM, nie warunkiem w szablonie.
+
+Astrololo zawiera `app/ai/`. Astroklient — nie, i to jedyna różnica między nimi
+po stronie funkcji astrologicznych. Żeby usunięcie katalogu naprawdę usuwało
+funkcję, poza nim nie może zostać ani jedno słowo o niej: ani w kodzie, ani
+w szablonie, ani w komentarzu, ani zaprzeczeniem („bez promptów").
+
+Warunek `{% if can(request, 'ai') %}` w szablonie wspólnym tego nie daje. Funkcji
+nie WIDAĆ, ale plik dalej leży w obrazie i dalej zawiera jej nazwy — `grep` po
+kontenerze pokazuje wszystko, czego warunek nie pokazał na ekranie.
+
+Ten test jest jedynym miejscem poza modułem, gdzie te słowa wolno wypisać.
+"""
+import pathlib
+import re
+
+import pytest
+
+APP = pathlib.Path(__file__).resolve().parents[1] / "app"
+MODUL = APP / "dodatki"
+
+SLOWA = [
+    # nazwa funkcji i jej słownictwo
+    "prompt", "LLM", "model językow", "generowanie tekstu", "sztuczn",
+    # dostawcy i modele
+    "anthropic", "openai", "gpt", "claude",
+    # angielska nazwa akcji (polski „horoskop" to nazwa EKRANU i jest w porządku)
+    "horoscope",
+    # nazwy plików modułu — sam odsyłacz podpowiada, co program potrafi
+    "x-ai.css", "models.js", "progress.js", "natal.js", "predictions.js",
+    "_prompt_block", "_prompt_result",
+]
+WZORCE = [(r"(?<![\w-])AI(?![\w-])", "skrót nazwy funkcji")]
+
+
+def _pliki_poza_modulem():
+    for f in sorted(APP.rglob("*")):
+        if not f.is_file() or f.suffix == ".pyc" or "__pycache__" in str(f):
+            continue
+        if MODUL in f.parents:
+            continue
+        yield f
+
+
+def test_no_word_about_generation_lives_outside_the_module():
+    grzechy = []
+    for f in _pliki_poza_modulem():
+        try:
+            tresc = f.read_text(encoding="utf-8")
+        except UnicodeDecodeError:
+            continue
+        gdzie = f.relative_to(APP.parent)
+        for slowo in SLOWA:
+            if re.search(rf"(?i)(?<![\w-]){re.escape(slowo)}", tresc):
+                grzechy.append(f"{gdzie}: „{slowo}”")
+        for wzor, powod in WZORCE:
+            if re.search(wzor, tresc):
+                grzechy.append(f"{gdzie}: „AI” — {powod}")
+    assert not grzechy, (
+        "\nPoza app/ai/ padły słowa opisujące generowanie. Granica ma być "
+        "katalogiem, więc to, co je nazywa, musi mieszkać w środku:\n  "
+        + "\n  ".join(grzechy))
+
+
+def test_the_module_is_the_only_thing_that_has_to_go():
+    """Kontrola pozytywna: te słowa MAJĄ padać w module.
+
+    Bez niej test wyżej przechodziłby także wtedy, gdyby funkcja po prostu
+    przestała istnieć albo została wydrążona."""
+    tresc = "\n".join(f.read_text(encoding="utf-8") for f in MODUL.rglob("*")
+                      if f.is_file() and f.suffix in (".py", ".html", ".css", ".js"))
+    for musi in ("prompt", "horoscope", "x-ai.css", "models.js"):
+        assert musi in tresc, f"moduł nie zawiera „{musi}” — czy on jeszcze cokolwiek robi?"
+
+
+def test_removing_the_module_leaves_a_working_application():
+    """Katalog ma być ODŁĄCZALNY, nie tylko oddzielony.
+
+    Most (`app.rozszerzenia`) musi odpowiadać sensownie, gdy modułu nie ma —
+    inaczej astroklient nie wystartuje, a dowiemy się o tym dopiero przy
+    budowaniu jego obrazu."""
+    import importlib
+    import sys
+
+    from app import rozszerzenia
+
+    zapamietane = rozszerzenia._modul
+    try:
+        rozszerzenia._modul = None
+        assert rozszerzenia.funkcje() == ()
+        assert rozszerzenia.trasy() == {}
+        assert rozszerzenia.zasoby() == {}
+        assert rozszerzenia.akcje() == {}
+        assert rozszerzenia.kontekst_szablonu(None) == {}
+        assert rozszerzenia.obsluz("prompt", cokolwiek=1) is None
+        assert rozszerzenia.katalog_szablonow() == []
+        assert rozszerzenia.katalog_zasobow() == []
+        assert rozszerzenia.pola_formularza()() == {}
+        rozszerzenia.zamontuj(None)          # ma nie wybuchnąć
+    finally:
+        rozszerzenia._modul = zapamietane
+        importlib.reload(sys.modules["app.rozszerzenia"]) if False else None
+
+
+def test_the_bridge_itself_names_nothing():
+    """Most jest w KAŻDYM obrazie, więc on sam nie może niczego wymienić."""
+    tresc = (APP / "rozszerzenia.py").read_text(encoding="utf-8")
+    for slowo in SLOWA + ["ai"]:
+        assert not re.search(rf"(?i)(?<![\w-]){re.escape(slowo)}(?![\w-])", tresc), \
+            f"most wymienia „{slowo}” — a ma nie wiedzieć, co jest podpięte"

services/presentation/tests/test_compile.py

@@ -11,11 +11,16 @@ import pathlib
 from starlette.testclient import TestClient
 
 APP = pathlib.Path(__file__).resolve().parents[1] / "app"
-TPL = (APP / "templates" / "compile.html").read_text(encoding="utf-8")
+from tests.skladanie import zloz
+
+# Szablon z rozwiniętymi wstawkami modułów — patrz tests/skladanie.py.
+TPL = zloz("compile.html")
 BASE = (APP / "templates" / "base.html").read_text(encoding="utf-8")
 JS = (APP / "static" / "compile.js").read_text(encoding="utf-8")
-NATAL_JS = (APP / "static" / "natal.js").read_text(encoding="utf-8")
-INTERPRET = (APP / "templates" / "interpret.html").read_text(encoding="utf-8")
+# Skrypty generowania mieszkają w module `app/ai/` — katalogu, którego
+# w obrazie bez tej funkcji po prostu nie ma.
+NATAL_JS = (APP / "dodatki" / "static" / "natal.js").read_text(encoding="utf-8")
+INTERPRET = zloz("interpret.html")
 MAIN = (APP / "main.py").read_text(encoding="utf-8")
 
 

services/presentation/tests/test_house_compare.py

@@ -192,7 +192,8 @@ def test_wheel_orientation_reaches_the_renderer(monkeypatch, orientation):
 # każdego, kto go pobrał. Reguły szukamy w całości — który arkusz ją niesie,
 # pilnuje osobny test pokrycia.
 CSS = "\n".join(f.read_text(encoding="utf-8")
-                for f in sorted((APP / "static").glob("*.css")))
+                for f in sorted([*(APP / "static").glob("*.css"),
+                                 *(APP / "dodatki" / "static").glob("*.css")]))
 
 
 def test_comparison_table_scrolls_instead_of_widening_the_page():

services/presentation/tests/test_predictions.py

@@ -7,9 +7,13 @@ nie może puchnąć od powtórzonych prób na tym samym okresie.
 import pathlib
 
 APP = pathlib.Path(__file__).resolve().parents[1] / "app"
-JS = (APP / "static" / "predictions.js").read_text(encoding="utf-8")
-PROGRESS = (APP / "static" / "progress.js").read_text(encoding="utf-8")
-TIMELINE = (APP / "templates" / "timeline.html").read_text(encoding="utf-8")
+# Skrypty generowania mieszkają w module `app/ai/` — katalogu, którego
+# w obrazie bez tej funkcji po prostu nie ma.
+JS = (APP / "dodatki" / "static" / "predictions.js").read_text(encoding="utf-8")
+PROGRESS = (APP / "dodatki" / "static" / "progress.js").read_text(encoding="utf-8")
+from tests.skladanie import zloz
+
+TIMELINE = zloz("timeline.html")
 
 
 # ─────────────────────────────── podpięcie ───────────────────────────────

services/presentation/tests/test_ukrywanie_ai.py

@@ -54,11 +54,15 @@ def _client(monkeypatch):
     wolania = []
     monkeypatch.setattr(logic, "report", lambda **kw: (wolania.append("report"), RAPORT)[1])
     monkeypatch.setattr(logic, "timeline", lambda **kw: (wolania.append("timeline"), KALENDARZ)[1])
-    monkeypatch.setattr(logic, "prompt",
-                        lambda **kw: (wolania.append("prompt"), {"prompt": "TREŚĆ"})[1])
-    monkeypatch.setattr(logic, "horoscope",
-                        lambda **kw: (wolania.append("horoscope"), {"text": "TREŚĆ"})[1])
-    monkeypatch.setattr(logic, "llm_models", lambda: {"providers": {"openai": ["gpt-x"]}})
+    # Generowanie mieszka w module `app/ai/` i ma własnego klienta — wspólny
+    # klient nie zna tych metod, bo jego plik jedzie do każdego obrazu.
+    from app.dodatki import klient
+
+    monkeypatch.setattr(klient, "prompt",
+                        lambda *a, **kw: (wolania.append("prompt"), {"prompt": "TREŚĆ"})[1])
+    monkeypatch.setattr(klient, "horoscope",
+                        lambda *a, **kw: (wolania.append("horoscope"), {"text": "TREŚĆ"})[1])
+    monkeypatch.setattr(klient, "modele", lambda *a: {"providers": {"openai": ["gpt-x"]}})
     return TestClient(app, follow_redirects=False), wolania
 
 

services/presentation/tests/test_wheeltip.py

@@ -20,7 +20,8 @@ JS = (APP / "static" / "wheeltip.js").read_text(encoding="utf-8")
 # każdego, kto go pobrał. Reguły szukamy w całości — który arkusz ją niesie,
 # pilnuje osobny test pokrycia.
 CSS = "\n".join(f.read_text(encoding="utf-8")
-                for f in sorted((APP / "static").glob("*.css")))
+                for f in sorted([*(APP / "static").glob("*.css"),
+                                 *(APP / "dodatki" / "static").glob("*.css")]))
 BASE = (APP / "templates" / "base.html").read_text(encoding="utf-8")
 
 

services/presentation/tests/test_wheelzoom.py

@@ -14,7 +14,8 @@ JS = (APP / "static" / "wheelzoom.js").read_text(encoding="utf-8")
 # każdego, kto go pobrał. Reguły szukamy w całości — który arkusz ją niesie,
 # pilnuje osobny test pokrycia.
 CSS = "\n".join(f.read_text(encoding="utf-8")
-                for f in sorted((APP / "static").glob("*.css")))
+                for f in sorted([*(APP / "static").glob("*.css"),
+                                 *(APP / "dodatki" / "static").glob("*.css")]))
 BASE = (APP / "templates" / "base.html").read_text(encoding="utf-8")