# 📦 Installation — Digital Delivery Roadmap (macOS)

> L'application tourne **100% en local** sur votre Mac.
> Aucune donnée ne quitte votre ordinateur.

---

## Étape 1 — Installer Node.js

1. Ouvrez votre navigateur et allez sur **https://nodejs.org**
2. Téléchargez la version **LTS** (ex: 20.x.x LTS)
3. Ouvrez le fichier `.pkg` téléchargé et suivez l'installation
4. Vérifiez l'installation : ouvrez **Terminal** (Cmd+Espace → "Terminal") et tapez :
   ```
   node --version
   ```
   Vous devriez voir quelque chose comme `v20.11.0`

---

## Étape 2 — Copier le dossier de l'application

1. Copiez le dossier **`roadmap-app`** à l'endroit de votre choix sur votre Mac
   (ex: `Documents/roadmap-app`)

---

## Étape 3 — Installer les dépendances

1. Ouvrez **Terminal**
2. Naviguez vers le dossier de l'application :
   ```bash
   cd ~/Documents/roadmap-app
   ```
   *(adaptez le chemin selon où vous avez copié le dossier)*
3. Installez les dépendances :
   ```bash
   npm install
   ```
   Attendez que l'installation se termine (quelques secondes).

---

## Étape 4 — Lancer l'application

Dans le Terminal (toujours dans le dossier `roadmap-app`) :
```bash
npm start
```

Vous verrez :
```
✅  Roadmap App démarrée
   → Ouvrez http://localhost:3000 dans votre navigateur
```

---

## Étape 5 — Ouvrir dans votre navigateur

Ouvrez **Safari, Chrome ou Firefox** et allez sur :
```
http://localhost:3000
```

---

## Utilisation quotidienne

Pour relancer l'application après un redémarrage de votre Mac :
1. Ouvrez **Terminal**
2. `cd ~/Documents/roadmap-app`
3. `npm start`
4. Ouvrez `http://localhost:3000`

> 💡 **Astuce** : vous pouvez créer un script de lancement rapide.
> Créez un fichier `Lancer Roadmap.command` sur votre Bureau avec ce contenu :
> ```bash
> #!/bin/bash
> cd ~/Documents/roadmap-app
> npm start
> ```
> Puis dans Terminal : `chmod +x ~/Desktop/Lancer\ Roadmap.command`
> Double-cliquez dessus pour lancer l'app !

---

## Importer votre fichier Excel

1. Dans l'application, cliquez sur **"Importer Excel"** (en bas à gauche)
2. Sélectionnez votre fichier `.xlsx`
3. Les projets et données de capacité sont importés automatiquement
4. Les données sont sauvegardées dans `roadmap-app/data/` (fichiers JSON sur votre Mac)

---

## Où sont stockées les données ?

```
roadmap-app/
  data/
    projects.json    ← tous vos projets
    capacity.json    ← données de capacité
```

Ces fichiers restent **uniquement sur votre Mac**.

---

## Arrêter l'application

Dans le Terminal, appuyez sur `Ctrl + C`