JiriUhlirandClaude Opus 5
156289fe2d
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>
48 lines
1.3 KiB
Python
48 lines
1.3 KiB
Python
"""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,
|
|
}
|