feat(reco): radio + similar with metadata fallback (§6.5)

POST /radio + /radio/next (stateless infinite feed: seed track / from-likes,
exploration mix, client-passed exclude_ids) and GET /tracks|artists/{id}/similar,
replacing the stubs. Recommender port abstracts the (future) ML service —
NullRecommender is wired now so RecommendationService always uses its metadata
heuristics (genre/artist similarity, random exploration filler), never a hard ML
dependency. Adds TrackRepository.list_similar/sample_playable + Artist.list_similar,
reason codes for the client, RemoteRecommender skeleton (TODO: ML contract).

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

This commit is contained in:

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

2026-07-28 21:59:15 +03:00

parent 313af3a070

commit 591a938e71

11 changed files with 586 additions and 10 deletions

									
										app/infrastructure/ml/__init__.py
									
		+1
		
												View File
												
				@@ -0,0 +1 @@

				"""ML/recommender adapters (plan §6.5). ML is optional — see Recommender port."""

				`@@ -0,0 +1 @@`
				`"""ML/recommender adapters (plan §6.5). ML is optional — see Recommender port."""`