Implementace prevodu HTML na PDF

Sluzba prijme adresu HTML dokumentu nebo HTML v tele requestu a vrati PDF.
Navrzena pro dokumenty o stovkach az tisicich stranek.

Rendering:
- WeasyPrint jako vychozi engine, spravne CSS Paged Media, nizka pametova
  narocnost, bez JavaScriptu
- Chromium pres Playwright pro dokumenty dokreslovane skripty
- rezim auto s detekci skriptu a fallbackem pri selhani WeasyPrintu

Velke dokumenty:
- deleni na casti na strukturalnich hranicich, rez nikdy uvnitr tabulky
  nebo odstavce
- dvoupruchodovy render obsahu se skutecnymi cisly stranek, pozice nadpisu
  se ctou z kotev hlasenych u kazde stranky
- cislovani stranek bud pres CSS countery, nebo pres cislovaci vrstvu
  nastampovanou na hotove PDF, rozmer stranky se cte z vysledneho souboru
- Chromium se restartuje po N jobech, nikdy vsak behem beziciho renderu

API:
- POST /convert synchronne, POST /jobs asynchronne se sledovanim stavu,
  stahovanim vysledku, rusenim a volitelnym callbackem
- GET /health s overenim dostupnosti obou enginu a stavem fronty
- OpenAPI respektuje prefix reverse proxy pres root_path

Bezpecnost a provoz:
- SSRF kontrola po DNS resolvu, na kazdem presmerovani a u vsech pozadavku
  prohlizece
- nedostupne assety render nezastavi, ale hlasi se v odpovedi i v logu
- fronta s omezenym poctem workeru, rozpracovane joby se pri ukonceni
  oznaci jako failed, nezmizi potichu
- strukturovane JSON logovani s job_id
- vsechny limity vypnute ve vychozim stavu

Dockerfile je dvoufazovy, obsahuje zavislosti WeasyPrintu, Chromium
a fonty s ceskou diakritikou.

Autentizace zamerne neni implementovana, zpusob predavani neni domluveny.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

app/routers/health.py

@@ -0,0 +1,47 @@
+"""Health and version endpoints required by AppFactory."""
+
+from __future__ import annotations
+
+import logging
+
+from fastapi import APIRouter
+
+from ..deps import get_container
+from ..models import HealthResponse
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(tags=["service"])
+
+
+@router.get("/health", response_model=HealthResponse, summary="Stav sluzby")
+async def health() -> HealthResponse:
+    container = get_container()
+
+    engines = {}
+    for name, engine in container.engines.items():
+        try:
+            engines[name] = await engine.available()
+        except Exception as exc:
+            logger.error("Engine availability check failed", extra={"engine": name}, exc_info=exc)
+            engines[name] = False
+
+    status = "ok" if any(engines.values()) else "degraded"
+    return HealthResponse(
+        status=status,
+        app=container.settings.app_name,
+        version=container.settings.app_version,
+        engines=engines,
+        queue=container.jobs.stats(),
+    )
+
+
+@router.get("/version", summary="Verze a zakladni informace o sluzbe")
+async def version() -> dict:
+    settings = get_container().settings
+    return {
+        "app": settings.app_name,
+        "version": settings.app_version,
+        "language": "python",
+        "root_path": settings.root_path,
+    }