> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalogue de données (couches silver & gold)

> Les tables d'analyse que Solya lit — les couches silver et gold, regroupées par usage.

Solya exécute ses analyses sur un **lac de données** Databricks avec deux couches. Ce catalogue liste les
tables ; pour les données opérationnelles (gérées par l'application), voir [Modèle de données](/fr/developers/data-model).

## Couches

* **Silver** — données source nettoyées et normalisées (dimensions et entités conformes) produites
  par l'[ingestion](/fr/data-layer/overview).
* **Gold** — analyses prêtes pour le métier : faits, instantanés, résumés, tendances, prévisions et
  données de décision IA. C'est ce que les tableaux de bord, KPIs, recherche, alertes et recommandations lisent.

<Note>
  Parcourez l'une de ces tables directement dans l'
  [explorateur de datasets](/fr/data-platform/datasets-explorer) (filtrer, paginer, exporter).
</Note>

## Couche gold

### Faits (transactions)

| Table                 | Contient                                                   |
| --------------------- | ---------------------------------------------------------- |
| `fact_sales_lines`    | Transactions de ventes individuelles.                      |
| `fact_order_lines`    | Lignes de commande/achat.                                  |
| `fact_movement_lines` | Mouvements de stock (réceptions, transferts, ajustements). |

### Stock

| Table            | Contient                                                 |
| ---------------- | -------------------------------------------------------- |
| `stock_ledger`   | Mouvements de stock historiques avec soldes courants.    |
| `stock_snapshot` | Stock actuel par magasin/variante (point dans le temps). |

### Dimensions

| Table                  | Contient                               |
| ---------------------- | -------------------------------------- |
| `dim_products`         | Maître produit.                        |
| `dim_product_variants` | Maître variante.                       |
| `dim_inventory_items`  | Identité inventaire produit × magasin. |
| `dim_brands`           | Maître marque.                         |
| `dim_shops`            | Maître magasin.                        |

### Résumés

| Table                 | Contient               |
| --------------------- | ---------------------- |
| `dim_product_summary` | Agrégats par produit.  |
| `dim_variant_summary` | Agrégats par variante. |
| `dim_brand_summary`   | Agrégats par marque.   |
| `dim_shop_summary`    | Agrégats par magasin.  |

### Analyses, tendances & IA

| Table                    | Contient                                                                                                                              |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `product_shop_analytics` | Métriques produit × magasin pré-agrégées.                                                                                             |
| `brand_shop_analytics`   | Métriques marque × magasin pré-agrégées.                                                                                              |
| `sales_trends`           | Analyse des tendances de ventes.                                                                                                      |
| `stock_trends`           | Analyse des tendances de stock (alimente le risque de rupture).                                                                       |
| `sales_forecasts`        | Prévisions de ventes par variante/magasin/date.                                                                                       |
| `decision_vector`        | Scores IA par variante/magasin (risque de rupture & surstock, urgence de réassort/transfert, réduction recommandée, surplus/déficit). |

## Couche silver

| Table                                                                | Contient                           |
| -------------------------------------------------------------------- | ---------------------------------- |
| `brands`, `products`, `product_variants`                             | Dimensions de catalogue conformes. |
| `shops`, `suppliers`, `collections`, `countries`                     | Dimensions de référence.           |
| `inventory_items`                                                    | Identité inventaire conforme.      |
| `taxonomy`, `brand_taxonomy`, `product_taxonomy`, `variant_taxonomy` | Hiérarchies de classification.     |

## Lire ces données dans l'application

L'application référence les colonnes gold/silver via des **constantes typées** (sous
`src/constants/datasetColumns/{gold,silver}/`) afin que SQL reste synchronisé avec le schéma — une
renommage de colonne remonte en erreur TypeScript plutôt qu'en bug silencieux. Vous ne questionnez pas ces
tables directement via l'API publique ; à la place, les endpoints dédiés (analyses, recherche,
risques, prévisions) les lisent pour vous — voir [Recettes API](/fr/developers/recipes/read-data).

<Note>
  Ces sont des tables d'analyse **en lecture seule**, remplies par la plateforme données. Les données
  gérées par l'application que vous créez (plans, règles, alertes, étiquettes…) vivent dans la base de données opérationnelle — voir
  [Modèle de données](/fr/developers/data-model).
</Note>