🏥 Studio Ippocrate

1. Requisiti di sistema

Verifica che il computer della Segreteria soddisfi questi requisiti:

• Sistema operativo: Windows 10 (64-bit) o Windows 11
• RAM: almeno 2 GB liberi
• Connessione: cablata (LAN) o WiFi stabile sulla rete dello studio
• Sempre acceso durante l'orario di studio

2. Installazione Node.js

1. 1
   Scarica Node.js LTS

   Vai su https://nodejs.org e clicca sul pulsante verde "LTS — Recommended For Most Users" (versione 20.x o superiore). Scarica il file .msi.

2. 2
   Esegui il programma di installazione

   Apri il file scaricato e segui la procedura guidata. Lascia tutte le opzioni di default selezionate. Quando richiesto, spunta "Automatically install the necessary tools" se disponibile.

3. 3
   Verifica l'installazione

   Apri il Prompt dei Comandi (premi Windows + R, digita cmd, premi Invio) e digita:

   node --version
   # Deve rispondere qualcosa come: v20.11.0
   
   npm --version
   # Deve rispondere qualcosa come: 10.2.4

   Se vedi i numeri di versione, Node.js è installato correttamente. ✅

3. Copia del progetto sul PC

Crea una cartella dedicata per il progetto. Ti consigliamo:

C:\StudioIppocrate\

All'interno, la struttura dei file deve essere esattamente questa:

Assicurati che il file package.json contenga esattamente questo:

{
  "name": "studio-ippocrate",
  "version": "2.0.0",
  "main": "server.js",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "socket.io": "^4.6.1"
  }
}

4. Installazione delle dipendenze

1. 1
   Apri il Prompt dei Comandi nella cartella del progetto

   Apri Esplora File, naviga in C:\StudioIppocrate, poi clicca sulla barra dell'indirizzo in alto, digita cmd e premi Invio. Si aprirà il prompt già nella cartella giusta.

2. 2
   Installa le dipendenze del progetto

   npm install
   # Attendi il completamento (30–60 secondi)
   # Verrà creata automaticamente la cartella node_modules\

3. 3
   Installa PM2 globalmente

   PM2 è il gestore di processi che mantiene il server attivo anche se si chiude il prompt o si riavvia il PC:

   npm install -g pm2
   npm install -g pm2-windows-startup
   # Il secondo pacchetto serve per l'avvio automatico con Windows

5. Primo avvio (test)

Avvia il server con PM2 nella cartella del progetto:

# Assicurati di essere in C:\StudioIppocrate\
pm2 start server.js --name "Ippocrate"

Se tutto è corretto, il prompt mostrerà:

Apri Chrome o Edge sul PC della segreteria e vai su http://localhost:3000/admin. Se vedi il pannello segreteria, il server funziona. ✅

Premi Ctrl + C per fermare il server di test. Adesso configuriamo PM2.

6. PM2 — Server sempre attivo

Con PM2 il server rimane attivo in background, si riavvia automaticamente in caso di errore, e continua a funzionare anche dopo la chiusura del prompt.

1. 1
   Avvia il server con PM2

   # Sempre da C:\StudioIppocrate\
   pm2 start server.js --name "Ippocrate"

2. 2
   Verifica che sia in esecuzione

   pm2 list

   ┌────┬────────────────────┬──────────┬──────┬───────────┬──────────┬──────────┐
   │ id │ name               │ mode     │ ↺    │ status    │ cpu      │ memory   │
   ├────┼────────────────────┼──────────┼──────┼───────────┼──────────┼──────────┤
   │ 0  │ Ippocrate           │ fork     │ 0    │ online    │ 0%       │ 60.1mb   │
   └────┴────────────────────┴──────────┴──────┴───────────┴──────────┴──────────┘
3. 3
   Salva la configurazione PM2

   pm2 save
   # Output atteso:
   [PM2] Saving current process list...
   [PM2] Successfully saved in C:\Users\user\.pm2\dump.pm2

Comandi PM2 utili

# Ver stato
pm2 list

# Riavvia il server (es. dopo aggiornamento file)
pm2 restart Ippocrate

# Ferma il server
pm2 stop Ippocrate

# Riprendi il server fermato
pm2 start Ippocrate

# Leggi i log in tempo reale (utile per debug)
pm2 logs Ippocrate

# Cancella i log
pm2 flush

7. Avvio automatico con Windows

L'avvio automatico è già stato configurato con successo su questo PC. Il messaggio ricevuto è stato:

Test di verifica (opzionale)

Per confermare che tutto funzioni dopo un riavvio:

1. Riavvia il PC
2. Aspetta circa 30 secondi dopo l'avvio del desktop
3. Apri il browser e vai su http://localhost:3000/admin
4. Se vedi il pannello segreteria senza aver avviato nulla manualmente → ✅ funziona

pm2 save
pm2-startup install

8. Indirizzi di accesso dalla rete

Output ipconfig del PC server (riferimento)

9. Configurazione Firewall Windows

Se gli altri dispositivi non riescono a connettersi al server, è necessario aprire la porta 3000 nel Firewall di Windows:

1. 1
   Apri Windows Defender Firewall con sicurezza avanzata

   Premi Windows, cerca "Windows Defender Firewall" e apri la versione "con sicurezza avanzata".

2. 2
   Crea una nuova regola in entrata

   Nel pannello sinistro, clicca su "Regole connessioni in entrata" → "Nuova regola..." nel pannello destro.

   • Tipo di regola: Porta
   • Protocollo: TCP
   • Porte locali specifiche: 3000
   • Azione: Consenti la connessione
   • Profilo: Privato (e Dominio se presente)
   • Nome: Studio Ippocrate

Alternativa rapida da Prompt dei Comandi (come Amministratore)

netsh advfirewall firewall add rule name="Studio Ippocrate" ^
  dir=in action=allow protocol=TCP localport=3000

10. Risoluzione problemi comuni

pm2 delete Ippocrate
pm2 start server.js --name "Ippocrate"

cd C:\StudioIppocrate
npm install

pm2 save
pm2-startup install

pm2 list         ← deve mostrare "Ippocrate online"
pm2 logs Ippocrate --lines 20  ← ultimi 20 log