explicit conversion timeout and handling

2026-03-26 18:56:28 -07:00
parent aa5dcddaa3
commit 8e93f75257
7 changed files with 65 additions and 16 deletions
@@ -94,6 +94,7 @@ make run-server
 - defaults S3 endpoint to `localhost:8333` for host-based development
 - auto-normalizes `seaweedfs:8333` to `localhost:8333` for host runs
 - supports optional `UVICORN_HOST` and `UVICORN_PORT` overrides
+- exposes conversion tuning vars (`CONVERSION_IMAGE_DPI`, `CONVERSION_PPTX_TO_PDF_TIMEOUT_SECONDS`, `CONVERSION_PDF_TO_IMAGES_TIMEOUT_SECONDS`)

 Server endpoint base URL:

@@ -133,3 +134,11 @@ Use `.env.example` as your baseline env configuration.
 - This project defaults to **SeaweedFS S3 API** for object transit in development and compose deployments.
 - The Python server uses the `minio` Python SDK, which is intentional because SeaweedFS is S3-compatible.
 - Runtime configuration uses `S3_*` environment variables.
+
+## Conversion Tuning Notes
+
+If conversion fails on larger decks, tune these environment variables:
+
+- `CONVERSION_IMAGE_DPI` (default `150`): lower values reduce image generation time.
+- `CONVERSION_PPTX_TO_PDF_TIMEOUT_SECONDS` (default `180`): timeout for LibreOffice export.
+- `CONVERSION_PDF_TO_IMAGES_TIMEOUT_SECONDS` (default `600`): timeout for Poppler rasterization.