Aller au contenu

Documentation du labo Snowflake-like

Ce répertoire documente l'intégralité du dépôt snowflake-lab-kit : un labo local, open source et auto-hébergé sur le NUC, qui reproduit l'environnement Snowflake d'un projet client (socle lakehouse, collecte et retraitement, fonctions Cortex AI_*, prévision t0-gamma). Le but est de travailler en autonomie dans un contexte proche du réel, puis de transposer le travail chez le client sans le réécrire.

État au 2026-10-26 : le labo est implémenté et fonctionnel, 919 tests unitaires et 83 tests d'intégration passent (dont 3 sautés sans le groupe forecast) (voir tests-et-gate.md).

Cette documentation est aussi publiée, avec une page d'accueil de présentation du labo, sur http://docs.openflake.nuc (réseau local ; construction et reconstruction dans exploitation.md).

Documents

Document Contenu
architecture.md Vue d'ensemble, services et modules, flux de données, correspondance avec Snowflake et écarts de fidélité, schémas Mermaid
exploitation.md Provisionnement des briques du NUC, variables .env, démarrage, arrêt, URL, identifiants, utilisation courante, dépannage
socle.md MinIO, Iceberg, Polaris, Trino, DuckDB, RBAC, types, Time Travel, rétention, branches et tags
collecte-retraitement.md Landing, raw, colonnes de preuve, intake assisté par IA, registre de schémas, mapping, exceptions, dbt standardized et semantic, SCD2, lineage, schémas shared_*
cortex-lab.md Contrats AI_*, SQL à deux étages, routage LiteLLM, façades Python, bascule CORTEX_BACKEND, ajout d'une fonction
prevision.md Modèle t0-gamma, construction des entrées, table forecast, backtest, conteneur, transposition vers Snowpark Container Services
donnees-synthetiques.md Sources pms, bookings, rate_shop, shared_calendar, référentiel des établissements, générateur
tests-et-gate.md Organisation des tests, marqueurs, commandes, contenu de chaque groupe, gate /gate
portabilite-snowflake.md Ce qui change chez le client : adapter dbt, nom de la base, CORTEX_BACKEND, conteneur de prévision
guide-agent.md Mode d'emploi pour un agent de code (Claude Code ou équivalent) : règles, vérification de la pile, emplacement des données, recettes SQL, Cortex, ingestion, dbt, métriques, prévision, tests, pièges, bloc à reprendre dans le CLAUDE.md d'un autre projet
methode-claude-code.md Règles du projet, hooks, agents, skills, cycle PLAN.md, approbation, gate
decisions.md Décisions tranchées et leur raison
veille-snowflake-2026-10.md Veille Snowflake du 2026-10-24 : nouveautés par domaine (Cortex, Iceberg, ingestion, SPCS, gouvernance, feuille de route), statut, date, source, impact sur le labo, actions proposées et décisions ouvertes

Parcours de lecture

Conventions de cette documentation

  • Les chemins sont relatifs à la racine du dépôt (/home/stephanev/Documents/snowflake/snowflake-lab-kit).
  • Le code fait foi. Quand le code et PLAN.md divergent, la documentation décrit le code et signale l'écart.
  • Ce qui n'a pas pu être vérifié dans le code ou dans la documentation Snowflake est marqué « à vérifier ».
  • Aucun secret n'apparaît ici : les documents disent où se trouvent les identifiants, jamais leur valeur.
  • Prose en français, identifiants en anglais, aucun tiret cadratin (règle du dépôt, contrôlée par un hook et par un test).

Sources de référence dans le dépôt

Source Rôle
CLAUDE.md Règles non négociables, carte des composants, décisions qui étaient ouvertes
PLAN.md Plan approuvé (périmètre, références Snowflake, décisions déléguées, avenant Traefik du 2026-10-23)
README.md Présentation du kit Claude Code et guide rapide du labo
.claude/skills/lakehouse-conventions/SKILL.md Référence du socle et des couches de données
.claude/skills/cortex-compat/SKILL.md, .claude/skills/cortex-compat/references/contracts.md Référence et contrats de cortex_lab
.claude/skills/forecast-t0/SKILL.md Référence de la prévision
data/README.md Provenance des données du labo
website/ Site de documentation : page d'accueil, configuration MkDocs, assemblage et construction stricte, Dockerfile, configuration nginx