feat: implement full-platform STT API (v2.3 consensus plan)

Batch+realtime transcription API: faster-whisper engine w/ EngineOwner (single GPU owner, OOM downgrade chain, persisted attempted_profiles), hardware-adaptive device manager (T0-T3 VRAM tiers), Redis/in-proc job queue w/ leases + crash recovery, postprocess (glossary/rules/LLM w/ egress guard), privacy-first result store (UUID keys, source deleted after transcribe), retention sweeper, API-key auth (HMAC digests, scopes, job ownership), WebSocket realtime lane (LocalAgreement), CLI (detect/transcribe/bench/serve/key), Docker, benchmark runner. 127 mock-based tests pass; ruff clean. Includes verification checklist and autoplan review notes.
2026-08-12 16:01:21 +09:00
parent b7c30f8b71
commit 7327145d7a
82 changed files with 7351 additions and 0 deletions
@@ -0,0 +1,70 @@
+# luke_scribe 프로덕션 compose — API + Redis + 워커 + 공유 스토어
+# 사용법: docker compose --profile gpu up -d   (또는 --profile cpu)
+services:
+  redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  api:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.cpu
+    profiles: ["cpu"]
+    depends_on:
+      redis:
+        condition: service_healthy
+    environment:
+      LUKESCRIBE_QUEUE_BACKEND: redis
+      LUKESCRIBE_REDIS_URL: redis://redis:6379/0
+      LUKESCRIBE_API_KEYS: ${LUKESCRIBE_API_KEYS:?API 키 필요}
+    volumes:
+      - luke-store:/data/luke-scribe
+    ports:
+      - "8000:8000"
+
+  api-gpu:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.gpu
+    profiles: ["gpu"]
+    depends_on:
+      redis:
+        condition: service_healthy
+    environment:
+      LUKESCRIBE_QUEUE_BACKEND: redis
+      LUKESCRIBE_REDIS_URL: redis://redis:6379/0
+      LUKESCRIBE_API_KEYS: ${LUKESCRIBE_API_KEYS:?API 키 필요}
+    volumes:
+      - luke-store:/data/luke-scribe
+    ports:
+      - "8000:8000"
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: 1
+              capabilities: [gpu]
+
+  worker:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.cpu
+    profiles: ["cpu"]
+    depends_on:
+      redis:
+        condition: service_healthy
+    environment:
+      LUKESCRIBE_QUEUE_BACKEND: redis
+      LUKESCRIBE_REDIS_URL: redis://redis:6379/0
+    command: ["python", "-m", "luke_scribe.cli", "serve"]
+    volumes:
+      - luke-store:/data/luke-scribe
+
+volumes:
+  luke-store: