Entity Registry — Document conceptuel

Ce que c’est

L’Entity Registry est un remplacement piloté par les métadonnées de toutes les hypothèses codées en dur sur le domaine dans l’Explorer. Au lieu que l’Explorer sache que gold_cases a une colonne start_time, ou que le type d’entité Signal Case se mappe à la clé de dimension cases — toute cette connaissance vit dans des fichiers YAML, se compile en tables registre dbt, et l’Explorer la lit à l’exécution.

L’Explorer peut supposer le schéma des métadonnées. Il ne peut pas supposer de contenu métier.

Cela suit le même pattern que les Signals, Theses et Verdicts : source de vérité YAML → compilateur → SQL dbt → consommation à l’exécution.

Architecture

entities/*.yaml                              ← source of truth
      │
      ▼
scripts/entitycompile.py ──validates──▶ contracts/gold_contract.v1.json
      │
      ├──▶ dbt/{pack}/models/registry/entity_registry.sql
      └──▶ dbt/{pack}/models/registry/entity_relationships.sql
                  │
                  ▼
            dbt build --select registry
                  │
                  ├──▶ {tenant}.entity_registry        (TABLE)
                  ├──▶ {tenant}.entity_relationships    (TABLE)
                  │
                  ▼
      explorer/src/lib/server/queries/entityRegistry.ts
        loadRegistry() → per-tenant cache, invalidated by DB mtime

Pour le document conceptuel complet incluant l’inventaire des hypothèses codées en dur, le format YAML, les schémas de tables, les phases d’implémentation et la stratégie de test, voir la version anglaise.