Add GET /movies/{id}/recommendations

Ingestion already stored movie_recommendations edges from TMDb's recommendations list (linking only to movies already ingested into Aurora, per the never-fabricate-a-stub rule), but nothing exposed them. Adds the repository lookup, service assembly, and route to read them back in ranked order. Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-05 08:16:18 -05:00
parent 73488a0d80
commit 4af4ba40ef
6 changed files with 106 additions and 2 deletions
@@ -47,6 +47,7 @@ GET /api/v1/search?q=the%20matrix
 | GET | `/api/v1/movies/{aurora_id}/credits` |
 | GET | `/api/v1/movies/{aurora_id}/images` |
 | GET | `/api/v1/movies/{aurora_id}/videos` |
+| GET | `/api/v1/movies/{aurora_id}/recommendations` |

 `GET /api/v1/movies/{aurora_id}` (cached, see `docs/architecture.md#caching`):

@@ -82,6 +83,22 @@ GET /api/v1/search?q=the%20matrix
 }
 ```

+`GET /api/v1/movies/{aurora_id}/recommendations` returns TMDb's ranked
+recommendations, but only the ones already ingested into Aurora — a
+recommendation pointing at a movie Aurora hasn't seen yet is silently
+dropped rather than fabricated as a stub (section 15), so this list can be
+sparse (or empty) for a young dataset and fills in as more movies get
+ingested:
+
+```json
+{
+  "id": "aur_movie_01m1q7p1c...",
+  "recommendations": [
+    { "id": "aur_movie_...", "type": "movie", "title": "The Matrix Reloaded", "release_date": "2003-05-15", "poster_path": "https://..." }
+  ]
+}
+```
+
 ## Series / Seasons / Episodes

 | Method | Path |