Configuration requise
Ce qu'il faut installer avant de lancer votre pack, avec ou sans Docker.
Pour le pack Full Stack
Ce que contient chaque pack
| Pack | Applications incluses dans le téléchargement | Fonctionne seul |
|---|---|---|
| Full Stack | API, site de commande, tableau de bord du personnel | Oui, les trois ensemble |
| Site de commande | Site de commande | Non : il a besoin que l'API du template tourne |
| Tableau de bord du personnel | Tableau de bord du personnel | Non : il a besoin que l'API du template tourne |
| API backend | API | Oui, en servant uniquement l'API |
Un pack à application unique n'inclut pas les autres applications. Le site et le tableau de bord lisent tout depuis l'API du template, et le code de l'API ne se trouve que dans les packs Full Stack et API backend.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine avec le plugin Compose sous Linux. Le pack Full Stack démarre avec une seule commande
docker compose. - Une connexion internet pour le premier build, qui télécharge les images de base et les dépendances.
- Rien d'autre : Docker fournit Node.js, et la base de données est un fichier SQLite dans un volume Docker.
Avec Docker
- Docker Desktop sous macOS ou Windows, ou Docker Engine sous Linux. Votre application a son propre
Dockerfile; Compose n'est pas nécessaire. - Une connexion internet pour le premier build, qui télécharge l'image de base et les dépendances.
Sans Docker
- Node.js 24 ou plus récent, la version que déclare chaque application et qu'utilise son image Docker. Vérifiez la vôtre avec
node -v. - Yarn 4, via Corepack. Exécutez
corepack enableune fois ; chaque application fixe sa propre version de Yarn, doncyarnchoisit la bonne. Si votre Node.js n'a pas Corepack, installez-le d'abord avecnpm install -g corepack. - Aucun package global.
Base de données
Aucun serveur de base de données. L'API utilise SQLite par défaut et yarn seed crée le fichier pour vous ; Docker utilise aussi SQLite. MySQL est pris en charge par un changement de configuration, pas de code.
Ports
Chaque application écoute sur un port local fixe. Assurez-vous que rien d'autre ne les utilise, ou, avec Docker, déplacez-en un avec SITE_PORT, ADMIN_PORT ou API_PORT dans un .env à côté de docker-compose.yml.
| Application | Port |
|---|---|
| API | 8000 |
| Site de commande | 3030 |
| Tableau de bord du personnel | 3031 |
Port
Le site écoute sur le port 3030 et attend l'API sur 8000. Assurez-vous que rien d'autre ne les utilise.
Port
Le tableau de bord écoute sur le port 3031 et attend l'API sur 8000. Assurez-vous que rien d'autre ne les utilise.
Port
L'API écoute sur le port 8000 et accepte par défaut le site depuis 3030 et le tableau de bord depuis 3031. Assurez-vous que rien d'autre n'utilise le port 8000.
Une API à connecter
Votre application n'a aucune donnée propre. Elle a besoin que l'API du template tourne, avec ses données, à l'adresse que vous définissez dans son .env. L'API est vendue comme un pack à part, l'API backend, et fait partie du Full Stack.
Services optionnels
Aucun de ces services n'est nécessaire pour lancer le restaurant en local. Chacun s'active avec ses variables dans le .env de l'API ; une variable laissée en commentaire garde sa fonctionnalité désactivée.
| Service | Sans lui |
|---|---|
| Stripe ou PayPal | Le paiement propose un paiement de démonstration intégré qui marque une commande comme payée sans déplacer d'argent, pour essayer le parcours. |
| Cloudflare R2 ou un autre bucket compatible S3 | Les fichiers envoyés sont stockés sur le disque de l'API (avec Docker, dans le volume de données), et l'API sert elle-même les photos de démonstration. |
| Resend, pour les e-mails | « Forgot password » répond comme d'habitude mais n'envoie rien, et le journal de l'API indique que l'e-mail n'est pas configuré. |
| Une clé Google AI (Gemini) | L'assistant IA, le rédacteur de fiches du studio et le restylage de photos indiquent qu'ils ne sont pas connectés. |
| Une clé et un secret Higgsfield | Les photos et clips générés par le studio restent désactivés. |
| Le fichier du modèle de suppression d'arrière-plan | Le bouton « Remove background » du studio n'apparaît pas. Il tourne sur votre propre serveur, ne demande aucune clé et ne coûte rien par image. |