Stocker et maintenir les UUID Orbit

Votre produit n’a pas besoin de recopier l’intégralité du catalogue. Une table de sélection peut rester minimale :

create table user_interests (
  user_id uuid not null,
  orbit_interest_id uuid not null,
  label text not null,
  category text not null check (
    category in ('games', 'movies', 'anime', 'series', 'music', 'books')
  ),
  resolved_at timestamptz,
  primary key (user_id, orbit_interest_id)
);

Il n’existe pas de clé étrangère entre votre base et Orbit. label et category représentent l’instantané choisi par l’utilisateur ; ils ne recréent pas une source de vérité locale.

Appliquer une résolution

Appelez POST /v1/interests/resolve par lots de 100 UUID au maximum, puis traitez chaque statut :

• resolved : conservez l’UUID et rafraîchissez éventuellement le libellé ou la catégorie ;
• replaced : remplacez l’UUID par replacedBy et l’instantané dans la même transaction ;
• unavailable : masquez ou retirez la sélection selon les règles de votre produit ;
• not_found : marquez la référence invalide et demandez une nouvelle sélection, sans inventer d’alias.

Vous n’avez pas besoin d’une table d’alias ou d’un cache complet du catalogue pour gérer les sélections. L’endpoint resolve porte précisément ce cycle de vie.

Quand résoudre

Une tâche périodique, une migration de profil ou une lecture métier importante suffisent généralement. Évitez un appel à chaque rendu et regroupez les UUID pour limiter la latence et la consommation.