Guide a new user (including non-developers) through installing and running arran-dnd locally on Windows
Guide l'utilisateur pas à pas pour installer et lancer le projet sur Windows. Explique chaque étape clairement, comme si la personne n'avait jamais touché à du code. Vérifie chaque prérequis avant de passer à l'étape suivante.
Ces logiciels sont nécessaires. Si tu ne les as pas encore, installe-les dans l'ordre en cliquant sur les liens ci-dessous et en suivant les instructions à l'écran.
Rends-toi sur le site officiel de Node.js et télécharge la version LTS (Long Term Support) : 👉 https://nodejs.org
Suis l'installateur jusqu'à la fin, laisse toutes les options par défaut cochées.
Rends-toi sur le site officiel de Git : 👉 https://git-scm.com/downloads/win
Télécharge la version Windows et suis l'installateur. Laisse toutes les options par défaut. Git Bash sera le terminal que tu utiliseras pour les commandes.
Rends-toi sur le site officiel de Docker : 👉 https://www.docker.com/products/docker-desktop
Télécharge Docker Desktop for Windows. Pendant l'installation :
Après le redémarrage, ouvre Docker Desktop et attends que le logo Docker en bas à gauche soit vert (ça peut prendre 1-2 minutes).
Une fois les trois logiciels installés et l'ordinateur redémarré, ouvre Git Bash et vérifie que tout est en place :
node --version # doit afficher v20 ou plus
git --version # doit afficher une version de git
docker --version # doit afficher une version de docker
Si une commande affiche une erreur, retourne à l'étape d'installation correspondante.
Dans Git Bash, navigue là où tu veux mettre le projet (par exemple ton bureau) puis clone le dépôt :
cd ~/Desktop
git clone <URL_DU_REPO>
cd arran-dnd
Remplace <URL_DU_REPO> par le lien que tu as reçu.
Toujours dans Git Bash, depuis le dossier arran-dnd :
npm install
Cette commande télécharge tous les composants nécessaires au projet. Ça peut prendre quelques minutes.
Le projet a besoin d'un fichier .env qui contient des informations sensibles (clés API, mots de passe). Ce fichier n'est pas inclus dans le dépôt pour des raisons de sécurité.
Demande une copie du fichier .env à Thomas, puis place-le dans le dossier server/ du projet :
arran-dnd/
server/
.env ← colle le fichier ici
Lance la base de données PostgreSQL avec Docker :
docker compose up -d
Vérifie qu'elle tourne bien :
docker compose ps
Tu dois voir un conteneur avec le statut running.
npm run dev
Cette commande démarre tout en même temps : le serveur et l'interface web. Les migrations de base de données sont appliquées automatiquement au démarrage.
Une fois lancé, ouvre ton navigateur et va sur : 👉 http://localhost:5173
| Problème | Solution |
|---|---|
node non reconnu | Réinstalle Node.js et redémarre Git Bash |
docker non reconnu | Assure-toi que Docker Desktop est lancé et redémarre Git Bash |
| Erreur de connexion à la base de données | Lance docker compose up -d et attends quelques secondes |
| Page blanche ou erreur réseau | Vérifie que npm run dev tourne toujours dans Git Bash |
| Erreur d'API (AI) | Vérifie que le fichier server/.env est bien présent et complet |