From 1cb432401de8d9a4d53d3f280001b677bf637b38 Mon Sep 17 00:00:00 2001
From: Hermann_Kitio <hermann_kitio@noreply.codeberg.org>
Date: Thu, 16 Apr 2026 04:35:42 +0200
Subject: [PATCH] Actualiser README.md

---
 README.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 63 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b3a8b05..1115653 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,64 @@
-# expria-backend
+expria-frontend
+Interface utilisateur d'Expria — Coach IA de préparation au TCF Canada.
+Plateforme SaaS francophone ciblant les candidats à l'immigration Express Entry
+(Algérie, Maroc, Cameroun).
+Stack technique
+
+React 18 + Vite — frontend pur, pas de logique serveur
+TypeScript — typage strict
+Tailwind CSS — styles utilitaires
+Supabase JS — authentification côté client uniquement
+
+Documents de référence
+Lire ces fichiers avant toute modification :
+FichierContenudocs/DEVELOPMENT_PRINCIPLES.mdCycle de travail, règles, conventions — obligatoiredocs/ARCHITECTURE.mdStack, structure, flux de donnéesdocs/PLANS_TARIFAIRES.mdPlans Free / Standard / Premium et permissionsdocs/PARCOURS_UTILISATEURS.mdParcours exact de chaque type d'utilisateurdocs/GOLDEN_DATASET.mdTests manuels anti-régression
+Structure des dossiers
+src/
+├── api/              # Fonctions d'appel API (une par domaine)
+├── components/       # Composants React réutilisables
+│   ├── ui/           # Composants génériques (Button, Modal, Badge)
+│   ├── simulation/   # Composants spécifiques aux simulations
+│   ├── rapport/      # Composants d'affichage des rapports
+│   ├── dashboard/    # Composants du dashboard utilisateur
+│   └── paywall/      # Composants de blocage / upgrade
+├── pages/            # Pages de l'application (une par route)
+├── hooks/            # Hooks React personnalisés
+├── lib/
+│   ├── access.ts     # Source de vérité des permissions par plan ⚠️
+│   ├── supabase.ts   # Client Supabase (auth uniquement)
+│   └── constants.ts  # Constantes globales
+└── types/            # Types TypeScript partagés
+
+⚠️ src/lib/access.ts est la source de vérité unique des permissions par plan.
+Ce fichier doit rester identique à src/lib/access.ts dans expria-backend.
+Toute modification des plans tarifaires met ce fichier à jour en premier.
+
+Variables d'environnement
+Créer un fichier .env à la racine (ne jamais committer) :
+VITE_API_URL=http://localhost:3000          # URL backend en développement
+VITE_SUPABASE_URL=https://xxx.supabase.co
+VITE_SUPABASE_ANON_KEY=xxx                  # Clé publique uniquement
+
+❌ Aucune clé privée ne doit apparaître dans ce fichier ou dans le code frontend.
+
+Commandes
+bash# Installer les dépendances
+npm install
+
+# Démarrer en développement
+npm run dev
+
+# Builder pour la production
+npm run build
+
+# Prévisualiser le build
+npm run preview
+Déploiement
+Plateforme : Cloudflare Pages
+Déploiement : manuel via CLI
+bashnpm run build
+npx wrangler pages deploy dist --project-name=expria
+Domaine : expria.app
+Dépôt lié
+Backend : codeberg.org/germannoff/expria-backend