timeline and readme

schema/models/api.py

@@ -0,0 +1,32 @@
+"""
+API Request/Response Schema Definitions
+
+These are separate from the main domain models and represent
+the shape of data sent to/from the API endpoints.
+"""
+
+from dataclasses import dataclass
+from typing import Optional
+from uuid import UUID
+
+
+@dataclass
+class CreateJobRequest:
+    """Request body for creating a transcode/trim job."""
+
+    source_asset_id: UUID
+    preset_id: Optional[UUID] = None
+    trim_start: Optional[float] = None  # seconds
+    trim_end: Optional[float] = None  # seconds
+    output_filename: Optional[str] = None
+
+
+@dataclass
+class SystemStatus:
+    """System status response."""
+
+    status: str
+    version: str
+
+
+# Note: WorkerStatus is defined in grpc.py and reused here