feat: local storage logic & endpoints

app/core/config.py

@@ -49,6 +49,15 @@ class Settings(BaseSettings):
     media_path: Path = Path("/data/media")
     transcode_cache_path: Path = Path("/data/transcode-cache")
     max_parallel_downloads: int = 2
+    storage_backend: Literal["local", "s3"] = "local"
+    upload_tmp_dir: Path | None = None
+
+    # -- S3 storage (deferred; set storage_backend="s3" to use) ----------
+    s3_endpoint_url: str | None = None
+    s3_bucket: str | None = None
+    s3_region: str | None = None
+    s3_access_key: SecretStr | None = None
+    s3_secret_key: SecretStr | None = None
 
     # -- external services (all optional; graceful degradation) ----------
     ml_service_url: str | None = None

app/core/hashing.py

@@ -0,0 +1,12 @@
+"""File hashing utilities."""
+
+import hashlib
+from pathlib import Path
+
+
+def sha256_of_file(path: Path) -> str:
+    h = hashlib.sha256()
+    with open(path, "rb") as f:
+        for chunk in iter(lambda: f.read(65536), b""):
+            h.update(chunk)
+    return h.hexdigest()