Lancer la boutique en local
Installez et démarrez chaque application avec Node.js et Yarn, un terminal par application.
Pour le pack Full Stack
Avant de commencer : installez Node.js 22 ou plus récent et exécutez corepack enable une fois. Aucun serveur de base de données n'est nécessaire.
Ouvrez chaque terminal là où les commandes ci-dessous l'attendent : dans e-commerce-1 pour le pack Full Stack, ou à côté du dossier de l'application pour un pack à application unique.
| Application | Dossier | Adresse |
|---|---|---|
| API | back-end | localhost:8000Local |
| Boutique | storefront | localhost:3030Local |
| Tableau de bord admin | admin-dashboard | localhost:3031Local |
Démarrez l'API en premier : les deux frontends lisent toutes leurs données à partir de l'API.
Démarrez l'API
Installez et configurez
.env.examplefonctionne tel quel pour le développement en local.Un problème ?Terminalcorepack enable cd back-end yarn install cp .env.example .envCréez la base de données
yarn seedcréedatabase.sqlite, ses tables et la boutique de démonstration. Le relancer n'ajoute que ce qui manque.Terminaldansback-endyarn seedDémarrez le serveur
Terminaldansback-endyarn devRésultat attendu: localhost:8000/api/healthLocal répond
Un problème ?{"status":"ok"}.
Démarrez la boutique
Dans un deuxième terminal :
Installez et configurez
Le
.envcopié fait pointer la boutique vers l'API sur le port8000.Terminalcd storefront yarn install cp .env.example .envDémarrez l'application
Terminaldansstorefrontyarn devRésultat attendu: localhost:3030Local ouvre la boutique en anglais ; l'arabe se trouve sous
Un problème ?/ar.
Démarrez la boutique
L'API ne fait pas partie de ce pack. Ne créez pas encore de fichier .env : sans lui, la boutique fonctionne sur sa boutique d'exemple intégrée.
Démarrez l'application
Terminaldansstorefrontyarn devRésultat attendu: localhost:3030Local ouvre la boutique avec une mention « Sample data ». N'importe quel e-mail et mot de passe vous connectent en tant que client d'exemple, et ce que vous modifiez est conservé dans le navigateur.
Une fois l'API du template lancée, créez .env à partir de .env.example et réglez NEXT_PUBLIC_API_BASE_URL sur son adresse. C'est ce qui désactive la boutique d'exemple.
Démarrez le tableau de bord admin
Dans un troisième terminal :
Installez et configurez
Terminalcd admin-dashboard yarn install cp .env.example .envDémarrez-le et connectez-vous
Terminaldansadmin-dashboardyarn devRésultat attendu: localhost:3031Local ouvre le formulaire de connexion, prérempli avec le Super Admin :
Un problème ?admin@example.comavec le mot de passeAdmin@123.
Démarrez le tableau de bord admin
L'API ne fait pas partie de ce pack. Ne créez pas encore de fichier .env : sans lui, le tableau de bord fonctionne sur sa boutique d'exemple intégrée.
Démarrez-le et connectez-vous
Terminaldansadmin-dashboardyarn devRésultat attendu: localhost:3031Local ouvre le formulaire de connexion, prérempli avec
admin@example.cometAdmin@123. Avec la boutique d'exemple, n'importe quel e-mail valide avec un mot de passe d'au moins 6 caractères vous connecte en tant que Super Admin, et vos modifications sont conservées dans le navigateur.
L'assistant IA et le studio IA restent indisponibles avec la boutique d'exemple, car tous deux ont besoin des clés de l'API. Tout le reste fonctionne.
ConfigurationBuild de production
Les mêmes dossiers, construits une fois puis démarrés. Configurez d'abord back-end/.env pour la production : avec NODE_ENV=production, l'API ne crée aucune table au démarrage, et elle refuse de démarrer tant que JWT_SECRET est vide ou garde la valeur d'exemple, ou tant que CORS_ORIGIN est vide.
NODE_ENV=production
JWT_SECRET=<a long random string>
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031Générez le secret avec node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Puis construisez l'API, créez ses tables une fois et démarrez-la. yarn db:sync:prod crée des tables vides ; yarn seed:prod, à sa place, ajoute la boutique de démonstration et ses comptes.
back-endyarn build
yarn db:sync:prod
yarn start:prodChaque frontend, la boutique sur 3030 et le tableau de bord admin sur 3031 (les deux mêmes commandes dans admin-dashboard) :
storefrontyarn build
yarn startLes frontends intègrent leur .env au moment du build : relancez donc yarn build après l'avoir modifié. Avant de déployer quelque part en public, lisez la checklist de production.
Repartir de données de démonstration neuves
Arrêtez l'API, puis supprimez le fichier de la base de données et recréez-la avec les données de démonstration. Cela supprime tout ce que vous avez créé.
back-endrm -f database.sqlite* && yarn seedDans PowerShell :
back-endRemove-Item database.sqlite*; yarn seed