mcma-backend

olly/mcma-backend

Fork 0

Commit Graph

Author	SHA1	Message	Date
Цвылев Александр Вадимович	048854f92a	feat(api): offline-first sync layer Implements the stubbed /sync endpoints: - GET /sync/changes — delta pull (likes, plays, changed playlists with their track ids, changed catalogue tracks) over the half-open window (since, cursor]; the cursor is the DB clock, so it's immune to app/DB skew. - POST /sync/push — idempotent append of client like/play events (ON CONFLICT DO NOTHING by client-supplied id); events for tracks the server doesn't have are skipped (graceful degradation). Adds a server-ingestion column `synced_at` to the likes + play_history event logs (migration) as the delta ordering key, so an event pushed with an older event time still surfaces for other devices. Repos gain list_since/add_event (likes, history), list_changed_since (playlists, tracks) and playlist.track_ids; wired via SyncService in deps. Also fixes test isolation exposed by the registry-backed /admin/sources endpoint: test_sources_api clears the process-cached source registry, and test_admin_api no longer hardcodes the environment name. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-28 15:04:13 +03:00
Senko-san	48e3418c7f	feat(sources): local_folder source backend + import pipeline Docker Build & Publish / build (push) Has been cancelled Details Docker Build & Publish / push (push) Has been cancelled Details Docker Build & Publish / Prune old image versions (push) Has been cancelled Details First ingest path beyond manual upload (plan §1C). Source abstraction + the first concrete backend, so a homelab can index an existing library. - domain: SourceBackend/IndexableSource ports + SourceInfo/SourceFile shapes - infrastructure/sources: LocalFolderSource (walks a mounted dir, idempotent source_id = relative path) + registry built from settings - application: LibraryImportService — batch sibling of UploadService; dedup on (source, source_id), copy into storage, minimal track (metadata_status=pending, enrichment fills the rest in 1D), per-file failures isolated - workers: scan_local_folder arq task (registered) + enqueue helper (503 if Redis down) - api: GET /sources, POST /sources/{source}/scan (admin, enqueues), /health - config: LOCAL_MEDIA_IMPORT_PATH; README + .env.example documented - tests: scanner, registry, import service (fakes) + DB-gated sources API path Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-08 20:02:09 +03:00

Author

SHA1

Message

Date

Цвылев Александр Вадимович

048854f92a

feat(api): offline-first sync layer

Implements the stubbed /sync endpoints:
- GET /sync/changes — delta pull (likes, plays, changed playlists with
  their track ids, changed catalogue tracks) over the half-open window
  (since, cursor]; the cursor is the DB clock, so it's immune to app/DB
  skew.
- POST /sync/push — idempotent append of client like/play events
  (ON CONFLICT DO NOTHING by client-supplied id); events for tracks the
  server doesn't have are skipped (graceful degradation).

Adds a server-ingestion column `synced_at` to the likes + play_history
event logs (migration) as the delta ordering key, so an event pushed
with an older event time still surfaces for other devices. Repos gain
list_since/add_event (likes, history), list_changed_since (playlists,
tracks) and playlist.track_ids; wired via SyncService in deps.

Also fixes test isolation exposed by the registry-backed /admin/sources
endpoint: test_sources_api clears the process-cached source registry,
and test_admin_api no longer hardcodes the environment name.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-28 15:04:13 +03:00

Senko-san

48e3418c7f

feat(sources): local_folder source backend + import pipeline

Docker Build & Publish / build (push) Has been cancelled

Details

Docker Build & Publish / push (push) Has been cancelled

Details

Docker Build & Publish / Prune old image versions (push) Has been cancelled

Details

First ingest path beyond manual upload (plan §1C). Source abstraction +
the first concrete backend, so a homelab can index an existing library.

- domain: SourceBackend/IndexableSource ports + SourceInfo/SourceFile shapes
- infrastructure/sources: LocalFolderSource (walks a mounted dir, idempotent
  source_id = relative path) + registry built from settings
- application: LibraryImportService — batch sibling of UploadService; dedup on
  (source, source_id), copy into storage, minimal track (metadata_status=pending,
  enrichment fills the rest in 1D), per-file failures isolated
- workers: scan_local_folder arq task (registered) + enqueue helper (503 if
  Redis down)
- api: GET /sources, POST /sources/{source}/scan (admin, enqueues), /health
- config: LOCAL_MEDIA_IMPORT_PATH; README + .env.example documented
- tests: scanner, registry, import service (fakes) + DB-gated sources API path

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-08 20:02:09 +03:00

2 Commits