Modèle de données

Objectif

Le modèle de données doit permettre de reconstruire ce qu’Orbit sait, pourquoi il le sait, quand il l’a appris et qui peut l’utiliser.

Entités centrales

Brain

• id
• propriétaire / tenant
• capacité CU
• CU actifs
• politiques globales
• statut et métadonnées de billing

Space

• id
• brain_id
• type de schéma + version
• nom
• qualité de contexte
• politique de récupération
• visibilité / confidentialité

Pillar

• id
• space_id
• clé sémantique définie par le schéma
• ancre canonique du graphe
• qualité agrégée

Memory

• id
• space_id
• pillar_id ou parent sémantique
• contenu canonique / résumé
• état
• coût CU
• importance
• confiance
• fraîcheur
• timestamps
• permissions

MemoryRelation

Relations typées : parent, confirme, contredit, remplace, dérive-de, similaire-à, référence.

Source

• provider
• identifiant externe
• URI
• checksum/version
• timestamps source
• classification

Provenance

Lien immuable entre une mémoire, une source, un extracteur, un workflow et les transformations qui l’ont produite.

Connector

Configuration d’accès à une source externe, scopes, état, curseur de sync, santé et politique de routing.

ContextPack

Snapshot de contexte livré : requête, mémoires sélectionnées, score, CU utilisés, politiques et version du moteur.

UsageEvent

Événement append-only pour coût, tokens, compute, storage, connector, workflow et attribution Brain/Space.

Règles d’intégrité

• supprimer une source ne doit pas effacer silencieusement la provenance historique ;
• une compression doit conserver les liens vers les mémoires sources ;
• une mémoire remplacée reste traçable ;
• les permissions sont vérifiées à la lecture et à la livraison ;
• les IDs externes ne deviennent jamais des clés primaires internes.