datakeen-session-react 1.1.140-dev.24 → 1.1.140-dev.25

package/README.md

@@ -15,11 +15,26 @@
 | `staging` | [![pipeline](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/badges/staging/pipeline.svg)](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/-/pipelines) | [![coverage](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/badges/staging/coverage.svg)](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/-/commits/staging) | [![npm rc](https://img.shields.io/npm/v/datakeen-session-react/rc?label=%40rc&color=orange)](https://www.npmjs.com/package/datakeen-session-react?activeTab=versions) |
 | `dev` | [![pipeline](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/badges/dev/pipeline.svg)](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/-/pipelines) | [![coverage](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/badges/dev/coverage.svg)](https://gitlab.com/datakeenteam/teamfullstack/client-sessions-react-sdk/-/commits/dev) | [![npm dev](https://img.shields.io/npm/v/datakeen-session-react/dev?label=%40dev&color=yellow)](https://www.npmjs.com/package/datakeen-session-react?activeTab=versions) |
 
-<div style="color: #3C3C40; font-size: 16px;">
+---
 
-## 📦 Installation du SDK
+## Table des matières
 
-Pour intégrer le SDK Datakeen Session dans votre projet React, vous pouvez utiliser npm, yarn ou pnpm :
+1. [Installation](#installation)
+2. [Stratégie de publication](#stratégie-de-publication)
+3. [Démarrage rapide](#démarrage-rapide)
+4. [API publique](#api-publique)
+5. [Configuration de l'URL API](#configuration-de-lurl-api)
+6. [Flux de vérification supportés](#flux-de-vérification-supportés)
+7. [Architecture du SDK](#architecture-du-sdk)
+8. [Système de polling](#système-de-polling)
+9. [Internationalisation (i18n)](#internationalisation-i18n)
+10. [Documentation avancée](#documentation-avancée)
+11. [Développement et tests](#développement-et-tests)
+12. [Support](#support)
+
+---
+
+## Installation
 
 ```bash
 # Via npm
@@ -32,200 +47,537 @@ yarn add datakeen-session-react
 pnpm add datakeen-session-react
 ```
 
-### 🔖 Stratégie de publication automatique multi-environnements
-
-Le SDK utilise une **pipeline CI/CD automatisée** qui publie automatiquement sur npm avec trois tags distincts selon la branche Git :
-
-| Branche Git | Tag NPM   | Format de version                   | Environnement               | Commande d'installation                  |
-| ----------- | --------- | ----------------------------------- | --------------------------- | ---------------------------------------- |
-| `main`      | `@latest` | `1.1.135` (Stable)                  | **Production**              | `npm install datakeen-session-react`     |
-| `staging`   | `@rc`     | `1.1.135-rc.0` (Release Candidate)  | **Pré-production** (QA/UAT) | `npm install datakeen-session-react@rc`  |
-| `dev`       | `@dev`    | `1.1.135-dev.3` (Integration Build) | **Développement**           | `npm install datakeen-session-react@dev` |
-
-#### 📦 Installation par environnement
+### Peer dependencies requises
 
 ```bash
-# Production (stable) - par défaut
-npm install datakeen-session-react
-# ou explicitement
-npm install datakeen-session-react@latest
+npm install axios react react-dom
+# axios@^1.8.0  react@^18.0.0  react-dom@^18.0.0
+```
 
-# Pré-production (Release Candidate pour tests QA/UAT)
-npm install datakeen-session-react@rc
+---
 
-# Développement (dernières fonctionnalités en cours)
-npm install datakeen-session-react@dev
-```
+## Stratégie de publication
+
+Le SDK utilise une **pipeline CI/CD automatisée** qui publie sur npm avec trois tags distincts selon la branche Git :
 
-#### 🔄 Processus de publication automatique
+| Branche Git | Tag NPM   | Format de version         | Environnement      | Commande d'installation                  |
+|-------------|-----------|---------------------------|--------------------|------------------------------------------|
+| `main`      | `@latest` | `1.1.x` (Stable)          | **Production**     | `npm install datakeen-session-react`     |
+| `staging`   | `@rc`     | `1.1.x-rc.y` (RC)         | **Pré-production** | `npm install datakeen-session-react@rc`  |
+| `dev`       | `@dev`    | `1.1.x-dev.y` (Dev Build) | **Développement**  | `npm install datakeen-session-react@dev` |
 
 Chaque merge sur les branches principales déclenche automatiquement :
 
-1. **Branche `dev`** → Incrémente la pré-version → Publie sur `@dev` (ex: `1.1.135-dev.0`, `1.1.135-dev.1`, ...)
-2. **Branche `staging`** → Incrémente la pré-version RC → Publie sur `@rc` (ex: `1.1.135-rc.0`, `1.1.135-rc.1`, ...)
-3. **Branche `main`** → Incrémente le patch → Publie sur `@latest` (ex: `1.1.135`, `1.1.136`, ...)
+1. **`dev`** → Incrémente la pré-version → Publie sur `@dev`
+2. **`staging`** → Incrémente la RC → Publie sur `@rc`
+3. **`main`** → Incrémente le patch → Publie sur `@latest`
 
-> **💡 Note :** Ce système permet de tester et valider les nouvelles fonctionnalités à travers plusieurs environnements avant leur déploiement en production, garantissant ainsi la stabilité du SDK.
+---
 
-## 🚀 Guide de démarrage rapide
+## Démarrage rapide
 
 ### Prérequis
 
-- Une application React fonctionnelle (React 16.8+ recommandé pour support des Hooks)
+- React 18+
 - Un identifiant de session Datakeen valide (obtenu via l'API Datakeen)
 
-### Étape 1 : Importer le SDK
+### Option 1 — Hook `useSession` (recommandé)
 
-```jsx
+```tsx
 import useSession from "datakeen-session-react";
+
+const VerificationPage = () => {
+  const { SessionComponent } = useSession(
+    "votre-session-id",
+    { selfie: false, requireMobile: false }, // optionnel
+    "https://app-v3.datakeen.co/backend"     // optionnel
+  );
+
+  return <div>{SessionComponent}</div>;
+};
 ```
 
-### Étape 2 : Initialiser et afficher la session
+### Option 2 — Composant `DatakeenSession`
 
-```jsx
-const MonComposant = () => {
-  // Initialisation avec l'ID de session
-  const { SessionComponent } = useSession("votre-session-id");
+```tsx
+import { DatakeenSession } from "datakeen-session-react";
 
-  return (
-    <div>
-      {/* Intégrez le composant de session où vous le souhaitez */}
-      {SessionComponent}
-    </div>
-  );
-};
+const VerificationPage = () => (
+  <DatakeenSession
+    sessionId="votre-session-id"
+    sessionConfig={{ selfie: false, requireMobile: false }}
+    apiBaseUrl="https://app-v3.datakeen.co/backend"
+  />
+);
+```
+
+### Option 3 — Configuration globale avec `ConfigProvider`
+
+```tsx
+import { DatakeenSession, ConfigProvider } from "datakeen-session-react";
+
+const App = () => (
+  <ConfigProvider apiBaseUrl="https://app-v3.datakeen.co/backend">
+    <DatakeenSession sessionId="votre-session-id" />
+  </ConfigProvider>
+);
 ```
 
-## 💡 Cas d'utilisation courants
+---
+
+## API publique
 
-### Intégration dans une page de vérification d'identité
+### `useSession(sessionId, sessionConfig?, apiBaseUrl?)` — Hook principal
 
-```jsx
-import React from "react";
+```typescript
 import useSession from "datakeen-session-react";
 
-const VerificationPage = () => {
-  // Vous pouvez récupérer l'ID de session depuis votre backend
-  const sessionId = "votre-session-id";
-  const { SessionComponent } = useSession(sessionId);
-
-  return (
-    <div className="verification-container">
-      <h1>Vérification d'identité</h1>
-      <p>Merci de suivre les étapes ci-dessous pour vérifier votre identité</p>
-
-      {/* Le SDK gère automatiquement toutes les étapes du processus */}
-      <div className="session-wrapper">{SessionComponent}</div>
-    </div>
-  );
-};
+const { SessionComponent } = useSession(
+  sessionId: string,
+  sessionConfig?: SessionConfig,
+  apiBaseUrl?: string
+);
 ```
 
-### Intégration dans un flux d'onboarding
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `sessionId` | `string` | ✅ | ID unique de la session Datakeen |
+| `sessionConfig` | `SessionConfig` | ❌ | Options de configuration du flux |
+| `apiBaseUrl` | `string` | ❌ | URL de base de l'API (override la config globale) |
 
-```jsx
-import React, { useState } from "react";
-import useSession from "datakeen-session-react";
+**`SessionConfig`**
 
-const OnboardingFlow = () => {
-  const [step, setStep] = useState(1);
-  const [sessionId, setSessionId] = useState(null);
-
-  // Fonction pour initialiser la session après l'étape 1
-  const initializeSession = async (userData) => {
-    // Exemple d'appel API pour obtenir un ID de session
-    const response = await fetch("https://api.votreservice.com/init-session", {
-      method: "POST",
-      body: JSON.stringify(userData),
-    });
-
-    const data = await response.json();
-    setSessionId(data.sessionId);
-    setStep(2);
-  };
-
-  // Rendu conditionnel basé sur l'étape
-  if (step === 1) {
-    return (
-      <div>
-        <h2>Étape 1: Informations de base</h2>
-        {/* Votre formulaire de collecte d'informations */}
-        <button
-          onClick={() =>
-            initializeSession({
-              /* données utilisateur */
-            })
-          }
-        >
-          Continuer
-        </button>
-      </div>
-    );
-  }
+| Propriété | Type | Description |
+|-----------|------|-------------|
+| `selfie` | `boolean` | Active la vérification par selfie biométrique |
+| `requireMobile` | `boolean` | Force l'utilisation d'un appareil mobile (redirection QR code) |
 
-  if (step === 2 && sessionId) {
-    const { SessionComponent } = useSession(sessionId);
+**Retour :** `{ SessionComponent: React.ReactElement }`
 
-    return (
-      <div>
-        <h2>Étape 2: Vérification d'identité</h2>
-        {SessionComponent}
-      </div>
-    );
-  }
-};
+---
+
+### `DatakeenSession` — Composant principal
+
+```tsx
+import { DatakeenSession } from "datakeen-session-react";
+
+<DatakeenSession
+  sessionId="votre-session-id"
+  sessionConfig={{ selfie: true }}
+  apiBaseUrl="https://app-v3.datakeen.co/backend"
+/>
+```
+
+Gère automatiquement : loading/erreur/expiration, layouts mobile/desktop, couleurs dynamiques depuis le template, redirection QR code si `requireMobile`.
+
+---
+
+### `ConfigProvider` — Provider de configuration
+
+```tsx
+import { ConfigProvider } from "datakeen-session-react";
+
+<ConfigProvider apiBaseUrl="https://app-v3.datakeen.co/backend">
+  {/* Tous les DatakeenSession enfants utilisent cette URL */}
+  <DatakeenSession sessionId="session-1" />
+</ConfigProvider>
+```
+
+---
+
+### `configureApiBaseURL(baseURL)` — Configuration runtime
+
+```typescript
+import { configureApiBaseURL } from "datakeen-session-react";
+
+// À appeler une fois au démarrage de l'application
+configureApiBaseURL("https://app-v3.datakeen.co/backend");
+```
+
+---
+
+### `useI18n()` — Hook de traduction
+
+```typescript
+import { useI18n } from "datakeen-session-react";
+
+const { t, translateCodeDescription, translateDocumentType, setLanguage, currentLanguage } = useI18n();
+
+// Changer la langue ("fr" | "en")
+await setLanguage("en");
+
+// Traduire un code d'analyse (ex: "2.2")
+const desc = translateCodeDescription("2.2");
+
+// Traduire un type de document
+const label = translateDocumentType("passport");
+```
+
+---
+
+### `I18nProvider` / `useI18nContext()` — Contexte i18n
+
+```tsx
+import { I18nProvider, useI18nContext } from "datakeen-session-react";
+
+// Provider
+<I18nProvider defaultLanguage="fr">
+  {children}
+</I18nProvider>
+
+// Hook contexte
+const { language, setLanguage } = useI18nContext();
+```
+
+---
+
+### Utilitaires d'analyse — `extractRootCauses`, `hasAnalysisFailed`, `getPrimaryRootCause`
+
+```typescript
+import { extractRootCauses, hasAnalysisFailed, getPrimaryRootCause } from "datakeen-session-react";
+import type { Prediction, AnalysisResult } from "datakeen-session-react";
+
+// Extraire toutes les causes d'échec
+const causes: string[] = extractRootCauses(predictions);
+
+// Vérifier si l'analyse a échoué
+const failed: boolean = hasAnalysisFailed(predictions);
+
+// Obtenir la cause principale
+const primary: string | null = getPrimaryRootCause(predictions);
 ```
 
-## 📋 Flux de vérification supportés
+**Interface `Prediction`**
 
-Le SDK prend en charge les documents d'identité des pays suivants :
+```typescript
+interface Prediction {
+  code: string;            // ex: "1.0", "2.2", "4.0"
+  codeName: string;        // ex: "conform", "non_conform"
+  codeDescription: string;
+  type: string;
+  userInput?: { birthDate?: string; firstName?: string; lastName?: string };
+}
+```
+
+**Codes de résultat principaux :**
+
+| Code | Statut | Signification |
+|------|--------|---------------|
+| `1.0` | `ai_approved` | Document vérifié avec succès |
+| `2.x` | `ai_rejected` | Document refusé (ex: `2.1` qualité, `2.2` non-conforme) |
+| `3.0` | `failed` | Erreur d'analyse |
+| `4.0` | `to_verify` | Vérification manuelle requise |
 
-- 🇫🇷 France
+---
 
-Les types de documents supportés incluent :
+### Service qualité image — `professionalImageQuality`
 
-- Carte Nationale d'Identité
-- Passeport
-- Permis de conduire
-- Titre de séjour
+```typescript
+import { professionalImageQuality } from "datakeen-session-react";
+import type { QualityAnalysis, QualityEnhancementOptions } from "datakeen-session-react";
 
-## 🔧 Personnalisation
+// Analyser la qualité
+const analysis: QualityAnalysis = professionalImageQuality.analyzeQuality(width, height);
+
+// Amélioration automatique depuis flux vidéo
+const { dataUrl, analysis, enhanced } = professionalImageQuality.autoEnhanceImage(
+  videoElement,
+  { x: 0, y: 0, width: 640, height: 480 },
+  { outputFormat: "jpeg", jpegQuality: 0.92 }
+);
+```
 
-Le SDK s'intègre naturellement avec votre interface utilisateur et adopte automatiquement les styles CSS de votre application. Pour une personnalisation avancée, vous pouvez encapsuler le composant de session dans vos propres conteneurs stylisés.
+---
 
-## ⚙️ Configuration de l'environnement
+### Chargement CSS dynamique — `useRouteCSS`
 
-Le SDK utilise des variables d'environnement pour la configuration. Pour configurer l'URL de l'API, créez un fichier `.env` à la racine de votre projet avec le contenu suivant :
+```typescript
+import { useRouteCSS } from "datakeen-session-react";
 
+// Charger le CSS d'une route au montage
+const { loadCSS, unloadCSS } = useRouteCSS("selfie", {
+  unloadOnUnmount: true
+});
 ```
-VITE_API_BASE_URL=https://dev2.datakeen.co/backend/session
+
+**Routes CSS disponibles :** `start`, `user-input`, `contact-info`, `otp`, `selfie`, `document-check`, `end-flow`, `jdi`, `video-recorder`, `ui-components`
+
+---
+
+## Configuration de l'URL API
+
+Le SDK résout l'URL API dans cet ordre de priorité :
+
+1. Prop `apiBaseUrl` passée à `useSession` / `DatakeenSession`
+2. `ConfigProvider` parent avec `apiBaseUrl`
+3. `configureApiBaseURL()` appelée au runtime
+4. `window.VITE_API_BASE_URL` (variable globale injectée)
+5. `import.meta.env.VITE_API_BASE_URL` (Vite)
+6. Fallback : `http://localhost:8888`
+
+### Configuration par environnement (exemple)
+
+```typescript
+// sdk-configuration.ts
+import { configureApiBaseURL } from "datakeen-session-react";
+
+const urls = {
+  production: "https://app-v3.datakeen.co/backend",
+  staging:    "https://app.staging.datakeen.co/backend",
+  development:"https://app.dev.datakeen.co/backend",
+};
+
+configureApiBaseURL(urls[process.env.NODE_ENV] ?? urls.development);
 ```
 
-Pour une configuration rapide, vous pouvez utiliser la commande suivante dans le projet SDK :
+### Via `.env` (Vite)
+
+```env
+VITE_API_BASE_URL=https://app-v3.datakeen.co/backend
+```
 
+Commande de setup rapide :
 ```bash
 npm run setup:env
 ```
 
-Cette commande génère les fichiers `.env` nécessaires pour le SDK et le projet de démo.
+Voir [docs/configuration.md](./docs/configuration.md) et [docs/dynamic-configuration.md](./docs/dynamic-configuration.md) pour plus de détails.
 
-Pour plus de détails sur la configuration de l'environnement, consultez [la documentation dédiée](./docs/environment.md).
+---
 
-## 💬 Support et assistance
+## Flux de vérification supportés
 
-Pour toute question technique ou problème d'intégration :
+### Types de nœuds dans un parcours (template)
 
-- **Email Support**: support@datakeen.co
-- **Documentation API**: [https://api.datakeen.co/docs](https://api.datakeen.co/docs)
-- **Site Web**: [www.datakeen.co](https://www.datakeen.co)
+| Type de nœud | Description |
+|---|---|
+| `information-input` | Saisie données utilisateur (identité, contact, adresse, champs custom) |
+| `document-collection` | Collecte et analyse de document (upload ou photo recto/verso) |
+| `controle-jdi` | Justificatif de domicile (JDI) |
+| `selfie-capture` | Capture selfie biométrique (via Unissey) |
+| `biometric-capture` | Capture biométrique |
+| `video-capture` | Capture vidéo du document |
+| `condition` | Branchement conditionnel basé sur les données de session |
+| `end` | Écran de fin et callback |
+| `custom` | Nœud personnalisé avec champs définis dans le template |
 
-</div>
+### Documents d'identité supportés
+
+- 🇫🇷 Carte Nationale d'Identité
+- 🇫🇷 Passeport
+- 🇫🇷 Permis de conduire
+- 🇫🇷 Titre de séjour
+
+### Types de champs custom (`CustomField`)
+
+```typescript
+type CustomFieldValueType =
+  | "text" | "enum" | "number" | "boolean"
+  | "date" | "address" | "list";
+```
+
+---
+
+## Architecture du SDK
+
+```
+DatakeenSession
+  ├── useSessionData          → Chargement & normalisation session depuis API
+  ├── useStepNavigation       → Navigation graph-like (edges + conditions)
+  └── SessionContent          → Dispatcher étapes → composants
+        ├── StartSession
+        ├── UserInputForm      (identity / contact / address / custom fields)
+        ├── DocumentCollection (upload + photo recto/verso + retry)
+        ├── JDI flow           (Justificatif de domicile)
+        ├── Selfie / VideoCapture / BiometricCapture
+        ├── OTPVerification
+        ├── ContactInfoForm
+        ├── PdfGeneration
+        └── EndFlow
+```
+
+### Gestion d'état
+
+- **Store global** : `SessionContext` (session, step, userInput, contactInfo)
+- **Mémoire session** : `sessionMemoryStore` (Map<sessionId, données>) — persiste userInput entre les étapes
+- **Retry counts** : Stockés dans `session.retryCounts: Record<nodeId, number>`
+
+### Navigation
+
+La navigation suit les **edges du template** (graphe orienté). Les nœuds `condition` et `external-verification` s'auto-exécutent et sont sautés lors du retour arrière.
+
+```typescript
+// Primitives exposées par useStepNavigation
+setStep(n, skipHistory?)    // navigation directe
+goBack()                    // retour (skip auto-executing nodes)
+goToNextStep(nodeId, template, handle?) // suit les edges
+canGoBack                   // boolean
+```
+
+Voir [docs/navigation-history.md](./docs/navigation-history.md).
+
+### Nœud conditionnel
+
+Le nœud `condition` évalue des expressions basées sur :
+- `userInput.*` — données saisies par l'utilisateur
+- `session.result.*` — résultat d'analyse IA
+- `{documentTemplateId}.*` — champs extraits du document
+
+Voir [docs/condition-node.md](./docs/condition-node.md).
+
+---
+
+## Système de polling
+
+Le système de polling (v2.0.0) supporte les **analyses multiples par session** et suit l'état via `analysisId`.
+
+### Cycle d'états d'une analyse
+
+| `status` | `analysisId` | `progress` | `code` | Signification |
+|----------|-------------|-----------|--------|---------------|
+| `processing` | `null` | 50% | `null` | Analyse en cours |
+| `ai_approved` | set | 100% | `1.0` | Document approuvé |
+| `ai_rejected` | set | 100% | `2.x` | Document refusé |
+| `to_verify` | set | 100% | `4.0` | Vérification manuelle |
+| `failed` | set | 100% | `3.0` | Erreur d'analyse |
+
+### Options de polling
+
+```typescript
+analyzeFiles(sessionId, nodeId, files, docTypeId, {
+  enablePolling: true,
+  pollingOptions: {
+    interval: 2000,          // ms entre chaque poll
+    maxAttempts: 300,        // max 10 min
+    timeout: 600000,
+    onProgress: (status) => { /* ... */ },
+    onComplete: (result) => { /* ... */ },
+    onFailed:   (error) =>  { /* ... */ },
+  }
+});
+```
+
+Voir [docs/POLLING_SYSTEM.md](./docs/POLLING_SYSTEM.md) pour la documentation complète.
+
+---
+
+## Internationalisation (i18n)
+
+Le SDK utilise sa propre instance **i18next** (isolée de l'application hôte).
+
+- **Langues supportées** : `fr` (défaut), `en`
+- **Persistance** : `localStorage` clé `datakeen-sdk-language`
+- **Ressources** : traductions principales, types de documents, noms de pays (ISO2/ISO3)
+
+```tsx
+// Intégration avec I18nProvider
+<I18nProvider defaultLanguage="fr">
+  <DatakeenSession sessionId="..." />
+</I18nProvider>
+
+// Changement de langue depuis l'application hôte
+const { setLanguage } = useI18nContext();
+setLanguage("en");
+```
+
+---
+
+## Documentation avancée
+
+| Document | Description |
+|----------|-------------|
+| [docs/JOURNEY_NODE_BUILDER.md](./docs/JOURNEY_NODE_BUILDER.md) | Architecture runtime, ajouter un nouveau type de nœud |
+| [docs/POLLING_SYSTEM.md](./docs/POLLING_SYSTEM.md) | Système de polling v2.0.0 — **point de départ recommandé** |
+| [docs/condition-node.md](./docs/condition-node.md) | Nœud conditionnel — tokens, expressions, exemples |
+| [docs/navigation-history.md](./docs/navigation-history.md) | Système d'historique de navigation |
+| [docs/configuration.md](./docs/configuration.md) | Configuration de base |
+| [docs/dynamic-configuration.md](./docs/dynamic-configuration.md) | Configuration dynamique multienv |
+| [docs/environment.md](./docs/environment.md) | Variables d'environnement |
+| [docs/migration-guide.md](./docs/migration-guide.md) | Guide de migration depuis l'ancienne API |
+| [docs/sdk_integration_guide.md](./docs/sdk_integration_guide.md) | Intégration dans un projet Vite + React |
+
+### Exemples de code
+
+| Fichier | Description |
+|---------|-------------|
+| [examples/usage-example.tsx](./examples/usage-example.tsx) | Intégration basique |
+| [examples/analysis-progress-example.tsx](./examples/analysis-progress-example.tsx) | Polling avec barre de progression |
+| [examples/sdk-configuration.ts](./examples/sdk-configuration.ts) | Configuration par environnement |
+| [examples/test-updated-urls.ts](./examples/test-updated-urls.ts) | Tests de validation des URLs |
+
+---
+
+## Développement et tests
+
+### Scripts disponibles
+
+```bash
+# Build production (CJS + ESM + types)
+pnpm build
+
+# Build en mode watch
+pnpm build:watch
+
+# Développement avec hot-reload
+pnpm dev
+
+# Lancer les tests Jest
+pnpm test
+
+# Lancer le SDK + la démo en parallèle
+pnpm dev:full
+
+# Lint
+pnpm lint
+```
+
+### Stack technique
+
+| Outil | Version | Rôle |
+|-------|---------|------|
+| TypeScript | 5.8 | Typage strict |
+| Rollup | 4.x | Bundler (CJS + ESM + types) |
+| Babel | 7.x | Transpilation |
+| Jest | 29.x | Tests unitaires |
+| React Testing Library | — | Tests composants |
+| Cypress | 13.x | Tests composants E2E |
+| Tailwind CSS | 4.x | Styles |
+| ESLint | 9.x | Linting (flat config) |
+
+### Formats de build
+
+| Format | Chemin | Usage |
+|--------|--------|-------|
+| CommonJS | `dist/cjs/` | Node.js / bundlers CJS |
+| ES Module | `dist/esm/` | Bundlers modernes (Vite, etc.) |
+| TypeScript | `dist/types/` | Déclarations de types |
+
+### Ajouter un nouveau nœud
+
+1. Étendre `SessionTemplateNode` dans `src/types/session.ts`
+2. Créer le composant dans `src/components/`
+3. Brancher dans `src/components/template/TemplateNodeRenderer.tsx`
+4. Gérer navigation et persistance
+5. Ajouter styles et traductions (`src/i18n/fr.json`, `en.json`)
+6. Écrire les tests
+
+Voir [docs/JOURNEY_NODE_BUILDER.md](./docs/JOURNEY_NODE_BUILDER.md) pour la checklist complète.
+
+---
+
+## Support
+
+- **Email** : support@datakeen.co
+- **Documentation API** : [https://api.datakeen.co/docs](https://api.datakeen.co/docs)
+- **Site Web** : [www.datakeen.co](https://www.datakeen.co)
+
+---
 
 <div style="background-color: #11E5C5; color: white; padding: 15px; border-radius: 5px; margin-top: 30px; display: flex; align-items: center; justify-content: space-between;">
   <div>
     <strong>Datakeen</strong> - Solutions d'identité numérique
   </div>
   <div>
-    Dernière mise à jour: Juin 2025
+    Dernière mise à jour: Mars 2026
   </div>
 </div>