[Architecture] refactor: per-domain modules with service layers — pure motion, zero new deps (stacked on #294)

backend/.env.example

@@ -30,3 +30,24 @@ COURTLISTENER_API_TOKEN=your-courtlistener-token
 # GET /manifest-signing-key. Rotating the key does not invalidate past exports,
 # but whoever checks one needs the key that was current when it was made.
 MANIFEST_SIGNING_KEY=
+
+# Optional durable job queues (BullMQ). Only needed when an ASYNC_* flag below
+# is "true"; the default (synchronous) deployment needs no Redis.
+REDIS_URL=redis://localhost:6379
+# When "true", DOCX→PDF conversion is enqueued to the BullMQ document-conversion
+# queue (uploads return status "processing"; an in-process worker converts and
+# flips to "ready"). Requires REDIS_URL + the frontend to poll document status.
+# Default "false" runs conversion inline on the request thread.
+ASYNC_DOCUMENT_CONVERSION=false
+# When "true", tabular-review cell extraction runs on the BullMQ
+# tabular-extraction queue (one job per document) instead of inline in the
+# POST /tabular-review/:id/generate request. Extraction then survives client
+# disconnects + server restarts and retries failed documents; the request tails
+# progress over Redis pub/sub and can be resumed via GET .../generate/stream.
+# Requires REDIS_URL. Default "false" runs extraction inline.
+ASYNC_TABULAR_EXTRACTION=false
+# Stale-work reaper: documents stuck "processing" longer than this (with no
+# live conversion job) are flipped to "error" so the UI never spins forever.
+# The sweep runs every STALE_SWEEP_INTERVAL_MS. Defaults: 30 min / 10 min.
+#STALE_DOC_PROCESSING_MS=1800000
+#STALE_SWEEP_INTERVAL_MS=600000