feat: aspektarian, deklinacja i antyscja trafiają do raportu i PDF-a

Zasada: co składamy, dodajemy i wyświetlamy, MA trafiać do finalnego raportu
(«Skompiluj») i do PDF-a — nie tylko na stronę /chart. Do tej pory do raportu i
druku szło samo koło; aspektarian (etap 5) i deklinacja/antyscja (etap 6) były
tylko w podglądzie horoskopu.

RAPORT «Skompiluj» (podgląd): handler /compile liczy teraz wszystkie cztery
rysunki, a szablon je pokazuje (koło, aspektarian, deklinacja, antyscja).

PDF (usługa render) — uogólnienie z jednego rysunku na LISTĘ:
- Kontrakt raportu: `figures = [{svg, caption}]` (uporządkowana). `wheel_svg`
  zostaje dla zgodności wstecznej jako pojedynczy rysunek.
- `compile.py`: każdy SVG osobno przez rsvg-convert → PDF (fig0…figN); braki/
  błędy pomijane (rysunek nie może wywalić raportu, tekst ważniejszy).
- `latex.py build()`: rysunki w sekcji 3 (po danych, przed natalną) w PODANEJ
  kolejności, każdy z podpisem. Jedna reguła składania: keepaspectratio z limitem
  szerokości i wysokości — kwadratowe (koło, aspektarian) ogranicza wysokość,
  szerokie (deklinacja, antyscja) szerokość, bez zniekształceń.
- `compile_pdf` (prezentacja): renderuje komplet w motywie DRUKU i wysyła jako
  `figures`.

Testy: render +5 (kolejność, podpisy, zgodność wsteczna, pomijanie pustych),
prezentacja +3 (raport pokazuje komplet, PDF składa komplet). Render 32,
prezentacja 173.

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

services/render/app/compile.py

@@ -22,8 +22,6 @@ from app.latex import build
 
 log = logging.getLogger("astrololo.render")
 
-WHEEL_SVG = "wheel.svg"
-WHEEL_PDF = "wheel.pdf"
 DOC = "report"
 TIMEOUT = 120          # xelatex na dużym tekście potrzebuje chwili
 
@@ -36,25 +34,40 @@ def _run(cmd: list[str], cwd: pathlib.Path) -> subprocess.CompletedProcess:
     return subprocess.run(cmd, cwd=cwd, capture_output=True, text=True, timeout=TIMEOUT)
 
 
-def _svg_to_pdf(svg: str, work: pathlib.Path) -> str | None:
-    """Zwraca nazwę pliku PDF z kosmogramem albo None, gdy nie ma czego rysować."""
+def _svg_to_pdf(svg: str, work: pathlib.Path, stem: str) -> str | None:
+    """SVG → PDF (nazwa `stem`) albo None, gdy nie ma czego rysować lub konwersja
+    padła. Brak rysunku nie może wywalić raportu — tekst jest ważniejszy."""
     if not svg or not svg.strip():
         return None
-    (work / WHEEL_SVG).write_text(svg, encoding="utf-8")
-    proc = _run(["rsvg-convert", "-f", "pdf", "-o", WHEEL_PDF, WHEEL_SVG], work)
-    if proc.returncode != 0 or not (work / WHEEL_PDF).exists():
-        # Brak rysunku nie może wywalić całego raportu — tekst jest ważniejszy.
-        log.warning("konwersja kosmogramu nie udała się: %s", (proc.stderr or "")[-300:])
+    svg_name, pdf_name = f"{stem}.svg", f"{stem}.pdf"
+    (work / svg_name).write_text(svg, encoding="utf-8")
+    proc = _run(["rsvg-convert", "-f", "pdf", "-o", pdf_name, svg_name], work)
+    if proc.returncode != 0 or not (work / pdf_name).exists():
+        log.warning("konwersja rysunku %s nie udała się: %s", stem, (proc.stderr or "")[-300:])
         return None
-    return WHEEL_PDF
+    return pdf_name
+
+
+def _figures(report: dict, work: pathlib.Path) -> list[dict]:
+    """Rysunki z raportu → lista PDF-ów z podpisami. Kontrakt: `figures` =
+    [{svg, caption}]; dla zgodności wstecznej wpada też pojedynczy `wheel_svg`."""
+    src = report.get("figures")
+    if not src and report.get("wheel_svg"):
+        src = [{"svg": report["wheel_svg"], "caption": "Kosmogram"}]
+    out: list[dict] = []
+    for i, fig in enumerate(src or []):
+        pdf = _svg_to_pdf(fig.get("svg") or "", work, f"fig{i}")
+        if pdf:
+            out.append({"pdf": pdf, "caption": fig.get("caption") or ""})
+    return out
 
 
 def to_pdf(report: dict) -> bytes:
     """Raport (dict) → bajty PDF. Rzuca RenderError, gdy LaTeX nie zbuduje pliku."""
     with tempfile.TemporaryDirectory(prefix="astrololo-render-") as tmp:
         work = pathlib.Path(tmp)
-        wheel = _svg_to_pdf(report.get("wheel_svg") or "", work)
-        (work / f"{DOC}.tex").write_text(build(report, wheel), encoding="utf-8")
+        figures = _figures(report, work)
+        (work / f"{DOC}.tex").write_text(build(report, figures=figures), encoding="utf-8")
 
         proc = _run(
             ["xelatex", "-interaction=nonstopmode", "-halt-on-error", f"{DOC}.tex"],

services/render/app/latex.py

@@ -171,12 +171,20 @@ PREAMBLE = r"""\documentclass[11pt,a4paper]{article}
 """
 
 
-def build(report: dict, wheel_pdf: str | None = None) -> str:
-    """Składa źródło .tex. `wheel_pdf` to nazwa pliku z kosmogramem (już PDF)."""
+def build(report: dict, wheel_pdf: str | None = None,
+          figures: list[dict] | None = None) -> str:
+    """Składa źródło .tex.
+
+    `figures` to UPORZĄDKOWANA lista rysunków kosmogramu (koło, aspektarian,
+    deklinacja, antyscja…) — każdy `{"pdf": nazwa, "caption": podpis}`, już jako
+    PDF. Zasada: co pokazujemy na stronie, ma trafić i tu (raport = to samo, co
+    widać). `wheel_pdf` zostaje dla zgodności wstecznej — pojedynczy rysunek."""
     person = str(report.get("person") or "").strip()
     data = report.get("data") or {}
     natal = report.get("natal") or {}
     predictions = report.get("predictions") or []
+    if figures is None:
+        figures = [{"pdf": wheel_pdf, "caption": "Kosmogram"}] if wheel_pdf else []
 
     parts = [PREAMBLE]
 
@@ -202,12 +210,22 @@ def build(report: dict, wheel_pdf: str | None = None) -> str:
     parts.append(r"\end{tabular}")
     parts.append(r"\vspace{1em}")
 
-    # ── 3. kosmogram ────────────────────────────────────────────────────
-    if wheel_pdf:
+    # ── 3. rysunki kosmogramu ───────────────────────────────────────────
+    # Jedna reguła na wszystkie: keepaspectratio z limitem SZEROKOŚCI i WYSOKOŚCI.
+    # Koło i aspektarian są kwadratowe (ogranicza je wysokość), deklinacja i
+    # antyscja szerokie (ogranicza szerokość) — bez zniekształceń w obu razach.
+    for fig in figures:
+        pdf = fig.get("pdf")
+        if not pdf:
+            continue
         parts.append(r"\begin{center}")
-        parts.append(r"\includegraphics[width=0.82\textwidth]{" + wheel_pdf + r"}")
+        parts.append(r"\includegraphics[width=0.82\textwidth,height=0.46\textheight,"
+                     r"keepaspectratio]{" + pdf + r"}")
+        cap = fig.get("caption")
+        if cap:
+            parts.append(r"\\[-0.3em]{\small\itshape " + esc(cap) + r"}")
         parts.append(r"\end{center}")
-        parts.append(r"\vspace{0.5em}")
+        parts.append(r"\vspace{0.4em}")
 
     # ── 4. interpretacja natalna ────────────────────────────────────────
     if natal.get("text"):

services/render/app/main.py

@@ -33,7 +33,8 @@ link_crypto.install(app, link_crypto.ENV_PRESENTATION_RENDER, "render")
 
 @app.post("/pdf")
 def build_pdf(report: dict) -> Response:
-    """Raport (JSON) → PDF. Wejście: person, data, wheel_svg, natal, predictions.
+    """Raport (JSON) → PDF. Wejście: person, data, figures[{svg,caption}] (albo
+    starsze wheel_svg — pojedynczy rysunek), natal, predictions.
 
     Zwracamy surowe bajty PDF-a, nie base64 — łącze i tak jest szyfrowane, więc
     kodowanie tylko rozdmuchałoby odpowiedź o trzecią część.

services/render/tests/test_latex.py

@@ -132,6 +132,43 @@ def test_wheel_is_optional():
     assert "includegraphics" in build(_report(), wheel_pdf="wheel.pdf")
 
 
+# ─────────── wiele rysunków w raporcie (koło + aspektarian + …) ───────────
+
+def test_all_figures_are_embedded_in_order():
+    """Co pokazujemy na stronie, ma trafić do PDF-a. Rysunki idą w PODANEJ
+    kolejności — koło, potem aspektarian, deklinacja, antyscja."""
+    figs = [
+        {"pdf": "fig0.pdf", "caption": "Kosmogram"},
+        {"pdf": "fig1.pdf", "caption": "Aspektarian"},
+        {"pdf": "fig2.pdf", "caption": "Wykres deklinacji"},
+    ]
+    tex = build(_report(), figures=figs)
+    assert tex.count("includegraphics") == 3
+    assert tex.index("fig0.pdf") < tex.index("fig1.pdf") < tex.index("fig2.pdf")
+
+
+def test_figure_captions_are_printed_and_escaped():
+    tex = build(_report(), figures=[{"pdf": "fig0.pdf", "caption": "Deklinacja 50%"}])
+    assert "Deklinacja 50\\%" in tex          # podpis eskejpowany jak reszta
+
+
+def test_figures_sit_between_data_and_natal():
+    """Rysunki nadal w sekcji 3 — po danych, przed interpretacją natalną."""
+    tex = build(_report(), figures=[{"pdf": "fig0.pdf", "caption": "Kosmogram"}])
+    assert tex.index("Data urodzenia") < tex.index("fig0.pdf") < tex.index("Interpretacja natalna")
+
+
+def test_wheel_pdf_still_works_as_single_figure():
+    """Zgodność wsteczna: pojedynczy wheel_pdf = jeden rysunek."""
+    tex = build(_report(), wheel_pdf="wheel.pdf")
+    assert tex.count("includegraphics") == 1 and "wheel.pdf" in tex
+
+
+def test_figure_without_pdf_is_skipped():
+    tex = build(_report(), figures=[{"caption": "brak pliku"}, {"pdf": "fig1.pdf"}])
+    assert tex.count("includegraphics") == 1 and "fig1.pdf" in tex
+
+
 # ─────────────────── Markdown → LaTeX (nie surowy copy-paste) ─────────────
 
 from app.latex import markdown_to_latex as md