# 📥 Installazione Node.js su Windows

## ⚠️ Problema
Se vedi l'errore "npm non è riconosciuto come comando interno", significa che **Node.js non è installato** sul tuo computer.

## 🚀 Soluzione: Installare Node.js

### Metodo 1: Installazione Diretta (Consigliato)

1. **Scarica Node.js:**
   - Vai su: https://nodejs.org/
   - Scarica la versione **LTS** (Long Term Support) - consigliata
   - Scegli il file `.msi` per Windows (es. `node-v20.x.x-x64.msi`)

2. **Installa Node.js:**
   - Esegui il file `.msi` scaricato
   - Segui la procedura guidata di installazione
   - ✅ **IMPORTANTE**: Assicurati che la casella "Add to PATH" sia selezionata
   - Clicca "Next" fino alla fine

3. **Riavvia il Terminale/PowerShell:**
   - Chiudi completamente PowerShell/Terminale
   - Riaprilo (questo è importante per caricare le nuove variabili d'ambiente)

4. **Verifica l'installazione:**
   ```powershell
   node --version
   npm --version
   ```
   
   Dovresti vedere qualcosa come:
   ```
   v20.11.0
   10.2.4
   ```

### Metodo 2: Usando Chocolatey (Opzionale)

Se hai Chocolatey installato:

```powershell
choco install nodejs
```

### Metodo 3: Usando Winget (Windows 10/11)

```powershell
winget install OpenJS.NodeJS.LTS
```

---

## ✅ Dopo l'installazione

Una volta installato Node.js, torna nella cartella del progetto e:

```powershell
# 1. Verifica che funzioni
node --version
npm --version

# 2. Installa le dipendenze del progetto
npm install

# 3. Crea il file .env
Copy-Item env.example .env

# 4. Avvia Docker (se non già avviato)
docker-compose up -d

# 5. Crea una sessione
npm run create-session
```

---

## 🔍 Verifica Installazione

Esegui questi comandi per verificare:

```powershell
# Verifica Node.js
node --version

# Verifica npm
npm --version

# Verifica il percorso di installazione
where.exe node
where.exe npm
```

---

## ⚠️ Problemi Comuni

### Se dopo l'installazione i comandi ancora non funzionano:

1. **Riavvia completamente PowerShell/Terminale**
   - Chiudi tutte le finestre
   - Riapri PowerShell come Amministratore

2. **Verifica le variabili d'ambiente:**
   ```powershell
   $env:PATH
   ```
   Dovresti vedere percorsi come `C:\Program Files\nodejs\`

3. **Aggiungi manualmente al PATH (se necessario):**
   - Premi `Win + R`
   - Digita `sysdm.cpl` e premi Invio
   - Vai su "Avanzate" → "Variabili d'ambiente"
   - In "Variabili di sistema", trova "Path" e clicca "Modifica"
   - Aggiungi: `C:\Program Files\nodejs\`
   - Riavvia il computer

---

## 📝 Note

- **Node.js include automaticamente npm**, quindi installando Node.js avrai anche npm
- Scegli sempre la versione **LTS** (Long Term Support) per maggiore stabilità
- Dopo l'installazione, **riavvia sempre il terminale** per applicare le modifiche al PATH

---

## 🆘 Ancora problemi?

Se dopo aver seguito questi passaggi hai ancora problemi:

1. Verifica che Node.js sia effettivamente installato:
   - Vai su `C:\Program Files\nodejs\`
   - Dovresti vedere i file `node.exe` e `npm.cmd`

2. Controlla la versione di Windows:
   ```powershell
   systeminfo | findstr /B /C:"OS Name"
   ```

3. Prova a reinstallare Node.js completamente