Lancer le tableau de bord sans Docker
Installez et démarrez chaque application avec Node.js et Yarn, un terminal par application.
Pour le pack Front + Back
Avant de commencer : installez Node.js 22.9 ou plus récent et lancez corepack enable une fois. Aucun serveur de base de données n'est nécessaire.
Ouvrez chaque terminal dans le dossier dashboard-2-full-stack. Démarrez l'API en premier : le tableau de bord y lit toutes ses données.
| Application | Dossier | Adresse |
|---|---|---|
| API | back-end | localhost:8000/ |
| Tableau de bord | front-end | localhost:3030Local |
Démarrez l'API
Installez et configurez
.env.examplefonctionne tel quel en local : SQLite dans./database.sqlite, l'API sur le port8000, et le tableau de bord autorisé depuishttp://localhost:3030.Terminaldansdashboard-2-full-stackcorepack enable cd back-end yarn install cp .env.example .envUn problème ?Créez la base de données
yarn seedcréedatabase.sqlite, ses tables et les données d'exemple : 12 admins, 5 rôles et 25 permissions, 15 utilisateurs et 12 supprimés, 15 projets et 12 supprimés, 10 tâches, 13 paramètres d'application et 50 pays. Le relancer conserve vos admins et leurs mots de passe, utilisateurs, projets, tâches et pays, et ajoute ce qui manque. Il remet les paramètres d'application et les permissions des cinq rôles intégrés à leurs valeurs d'exemple, et donne le rôle Viewer à chaque admin autre queadmin@example.comqui ne l'a pas encore.Terminaldansback-endyarn seedDémarrez le serveur
yarn devredémarre l'API à chaque enregistrement d'un fichier.Terminaldansback-endyarn devRésultat attendu: Le contrôle de santéLocal répond avec
Un problème ?"status":"ok"et"database":"up".
Démarrer le tableau de bord
Dans un deuxième terminal :
Installez et configurez
Le
.envcopié relie le tableau de bord à l'API sur le port8000, et au même serveur pour les mises à jour des permissions en direct.Terminaldansdashboard-2-full-stackcd front-end yarn install cp .env.example .envDémarrez-le et connectez-vous
Terminaldansfront-endyarn devRésultat attendu: localhost:3030Local ouvre la page de connexion. Connectez-vous avec
Un problème ?admin@example.comet le mot de passeAdmin@123.
Sans le .env copié, le tableau de bord ne cherche pas du tout l'API : il fonctionne sur sa fausse API intégrée avec des données d'exemple conservées dans votre navigateur.
Démarrer le tableau de bord
Aucun fichier .env n'est nécessaire : sans adresse d'API définie, le tableau de bord fonctionne sur sa fausse API intégrée avec des données d'exemple.
Démarrez-le et connectez-vous
Terminaldansdashboard-2-front-endyarn devRésultat attendu: localhost:3030Local ouvre la page de connexion. Connectez-vous avec
Un problème ?admin@example.comet le mot de passeAdmin@123, et la vue d'ensemble s'ouvre avec un avis « Sample data ».
Pour le relier à votre API, copiez les paramètres d'exemple avec cp .env.example .env : ils attendent l'API sur http://localhost:8000/api. Changez NEXT_PUBLIC_API_BASE_URL et NEXT_PUBLIC_WEBSOCKET_BASE_URL si la vôtre tourne ailleurs, puis relancez yarn dev.
Build de production de l'API
Définissez d'abord le .env de l'API 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 encore à la valeur d'exemple, ou tant que CORS_ORIGIN est vide.
NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=https://admin.your-domain.com
FRONTEND_URL=https://admin.your-domain.comGénérez le secret avec node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Puis, dans back-end, construisez l'API, créez les tables une fois avec yarn seed:prod, et démarrez-la :
back-endyarn build
yarn seed:prod
yarn start:prodyarn seed:prod est la seule commande qui crée les tables, et elle ajoute aussi les données d'exemple et les admins d'exemple avec leurs mots de passe publics. Avant la mise en ligne, connectez-vous et changez les mots de passe des admins d'exemple dans Settings, Security, ou supprimez-les, et gardez votre propre JWT_SECRET comme ci-dessus, avant que le tableau de bord ne soit accessible à quelqu'un d'autre. Lancez-la une seule fois : une seconde exécution remet les paramètres d'application et les permissions des rôles intégrés à leurs valeurs d'exemple.
Build de production du tableau de bord
Dans le dossier du tableau de bord, construisez une fois puis démarrez. Il sert sur le port 3030, ou sur PORT depuis .env ou l'environnement.
yarn build
yarn startLe tableau de bord compile ses valeurs NEXT_PUBLIC_* au moment du build : relancez donc yarn build après avoir modifié .env.
Repartir de zéro avec des données d'exemple neuves
Arrêtez l'API, puis supprimez le fichier de base de données et remplissez-la de nouveau, dans back-end. Cela supprime tout ce que vous avez créé.
back-endrm -f database.sqlite* && yarn seedDans PowerShell :
back-endRemove-Item database.sqlite*; yarn seedyarn reset vide chaque table et les garde ; yarn drop supprime chaque table. Lancez yarn seed après l'une ou l'autre.