Цвылев Александр Вадимович
a263272935
Implements previously-stubbed /api/v1 endpoints (hexagonal: ports -> repos
-> services -> routers wired in deps):
- playlists: GET /{id}/cover (serves stored cover, 404 when absent)
- settings: GET/PATCH /settings + GET/PUT /settings/scrobbling — lazy
per-user row, write-only Fernet-encrypted scrobble session key; adds
user_settings table + migration (chains off dc126696f5a6)
- storage: GET /duplicates, /broken, /missing-metadata + admin POST
/cleanup (arq cleanup_storage worker; reconciles local refs only,
guarded against a storage-outage mass delete)
- admin: GET /services, /sources, /settings + POST /reindex; PATCH
/settings and /sources/{source} return 501 (config is env-managed)
Adds NotSupportedError (-> HTTP 501). Integration tests for each surface.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
62 lines
1.3 KiB
Python
62 lines
1.3 KiB
Python
"""Storage / library statistics response schemas (§A6)."""
|
|
|
|
import datetime as dt
|
|
|
|
from pydantic import BaseModel
|
|
|
|
from app.api.schemas.track import TrackOut
|
|
|
|
|
|
class DiskUsageOut(BaseModel):
|
|
total: int
|
|
used: int
|
|
free: int
|
|
|
|
|
|
class FormatBreakdownOut(BaseModel):
|
|
file_format: str
|
|
track_count: int
|
|
total_size: int
|
|
|
|
|
|
class GenreCountOut(BaseModel):
|
|
genre: str
|
|
track_count: int
|
|
|
|
|
|
class StorageStatsOut(BaseModel):
|
|
"""Everything the Storage screen needs in a single call."""
|
|
|
|
# library catalogue
|
|
total_tracks: int
|
|
total_artists: int
|
|
total_albums: int
|
|
total_size: int
|
|
total_duration_seconds: int
|
|
largest_track_size: int
|
|
earliest_added: dt.datetime | None
|
|
latest_added: dt.datetime | None
|
|
|
|
# breakdowns
|
|
by_format: list[FormatBreakdownOut]
|
|
by_metadata_status: dict[str, int]
|
|
by_source: dict[str, int]
|
|
top_genres: list[GenreCountOut]
|
|
|
|
# backing volume (``None`` for object-store backends)
|
|
disk: DiskUsageOut | None
|
|
|
|
|
|
class DuplicateGroupOut(BaseModel):
|
|
"""Tracks sharing one acoustic fingerprint — candidates for de-duplication."""
|
|
|
|
fingerprint: str
|
|
tracks: list[TrackOut]
|
|
|
|
|
|
class CleanupEnqueuedOut(BaseModel):
|
|
"""Acknowledgement that a cleanup job was queued (it runs in the worker)."""
|
|
|
|
status: str
|
|
job_id: str
|