feat(storage): S3-compatible storage adapter + storage_uri rename

Add S3FileStorage adapter (any S3-compatible backend: AWS, MinIO, Garage)
alongside the local adapter, selected via STORAGE_BACKEND. Proxied range
streaming via get_object+Range; as_local_path downloads to a tempfile for
ffmpeg/fpcalc. Rename track.file_path -> storage_uri across domain entity,
ORM, repositories, port, and services, with an Alembic migration. Adds
mocked S3 unit tests.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Senko-san
2026-06-08 17:11:35 +03:00
parent a8348e145a
commit 5c5df5d3cc
15 changed files with 1377 additions and 498 deletions
@@ -30,7 +30,7 @@ def _track_to_entity(row: TrackModel) -> Track:
title=row.title,
artist_id=row.artist_id,
album_id=row.album_id,
file_path=row.file_path,
storage_uri=row.storage_uri,
file_format=row.file_format,
file_size=row.file_size,
source=row.source,
@@ -29,7 +29,7 @@ def _track_to_entity(row: TrackModel) -> Track:
title=row.title,
artist_id=row.artist_id,
album_id=row.album_id,
file_path=row.file_path,
storage_uri=row.storage_uri,
file_format=row.file_format,
file_size=row.file_size,
source=row.source,
@@ -17,7 +17,7 @@ def _to_entity(row: TrackModel) -> Track:
title=row.title,
artist_id=row.artist_id,
album_id=row.album_id,
file_path=row.file_path,
storage_uri=row.storage_uri,
file_format=row.file_format,
file_size=row.file_size,
source=row.source,
@@ -56,7 +56,7 @@ class SqlAlchemyTrackRepository:
id: uuid.UUID,
title: str,
artist_id: uuid.UUID,
file_path: str,
storage_uri: str,
file_format: str,
file_size: int,
source: str,
@@ -68,7 +68,7 @@ class SqlAlchemyTrackRepository:
id=id,
title=title,
artist_id=artist_id,
file_path=file_path,
storage_uri=storage_uri,
file_format=file_format,
file_size=file_size,
source=source,