test: ripara la suite Vitest e migra gli e2e all'architettura attuale

La suite era allineata a una vecchia forma dello stato (sp.punt/sp.set/
sp.servHome) e a una vecchia architettura e2e (controller su :3001).
Baseline iniziale: 77/170 test Vitest falliti.

Vitest (ora 212/212 verdi):
- gameState.test.js: riscritto con helper che derivano punteggio/set/
  servizio dalla striscia; aggiunto blocco formInizio
- server-utils.js: getNetworkIPs accetta interfacce iniettabili e
  printServerInfo accetta gli IP iniettabili (deterministico anche su WSL);
  filtro LAN unificato (esclude 127./169.254./172.)
- websocket + stress: punteggio letto via punteggio(striscia)
- ControllerPage/DisplayPage: forzato layout mobile (viewport portrait),
  punteggi impostati via striscia; aggiunto test bottone REFERTO
- nuovi: referto.test.js, persist.test.js (mock fs), wsMixin.test.js,
  integration/server.test.js (routing)

Refactor di supporto:
- referto.js: estratta buildRefertoHtml(state, now) pura; generaReferto
  resta wrapper con window.open/print
- server.js: estratti createApp()/startServer(); avvio solo se entrypoint

e2e (migrazione parziale, NON ancora verificata verde):
- tutti i riferimenti controller :3001 -> :3000/controller
- forzato viewport portrait sul controller prima del goto
- reset helper: chiude il dialog di configurazione che doReset apre
- game-simulation: gestione del dialog SET VINTO automatico a 25

src/referto.js

@@ -7,9 +7,11 @@ function vincitoreSet(s) {
     return null
 }
 
-export function generaReferto(state) {
+// Costruisce l'HTML del referto (funzione pura, testabile).
+// `now` è iniettabile per rendere deterministica la data nei test.
+export function buildRefertoHtml(state, now = new Date()) {
     const { sp, modalitaPartita } = state
-    const { nomi, striscia, form } = sp
+    const { nomi, striscia } = sp
 
     const setReali = striscia.filter(s => !s._phantom)
 
@@ -20,7 +22,7 @@ export function generaReferto(state) {
         else if (v === 'g') setVinti.guest++
     }
 
-    const dataOra = new Date().toLocaleString('it-IT', {
+    const dataOra = now.toLocaleString('it-IT', {
         day: '2-digit', month: '2-digit', year: 'numeric',
         hour: '2-digit', minute: '2-digit',
     })
@@ -125,6 +127,13 @@ export function generaReferto(state) {
 </body>
 </html>`
 
+    return html
+}
+
+// Apre il referto in una nuova scheda e avvia la stampa (effetto collaterale,
+// solo browser). La generazione dell'HTML è delegata a buildRefertoHtml.
+export function generaReferto(state) {
+    const html = buildRefertoHtml(state)
     const w = window.open('', '_blank')
     w.document.write(html)
     w.document.close()

src/server-utils.js

@@ -9,7 +9,34 @@ function isWSL() {
   } catch { return false }
 }
 
-export function getNetworkIPs() {
+// Un IPv4 è "pubblicabile" in LAN se non è loopback, link-local o bridge Docker.
+function isLanIPv4(address) {
+  return !!address
+    && !address.startsWith('127.')
+    && !address.startsWith('169.254.')
+    && !address.startsWith('172.')
+}
+
+// Estrae gli IP LAN da un oggetto in stile os.networkInterfaces().
+// Esportata per poter essere testata in isolamento, senza dipendere dalla piattaforma.
+export function collectIPs(nets) {
+  const out = []
+  for (const name of Object.keys(nets || {})) {
+    for (const net of nets[name]) {
+      if (net.family === 'IPv4' && !net.internal && isLanIPv4(net.address)) {
+        out.push(net.address)
+      }
+    }
+  }
+  return out
+}
+
+// Restituisce gli IP di rete della macchina.
+// Passando `nets` (oggetto in stile os.networkInterfaces) si forza il percorso
+// deterministico, scavalcando il rilevamento WSL/PowerShell: utile nei test.
+export function getNetworkIPs(nets) {
+  if (nets) return collectIPs(nets)
+
   if (isWSL()) {
     try {
       const out = execSync(
@@ -18,23 +45,15 @@ export function getNetworkIPs() {
       )
       return out.toString().trim().split('\n')
         .map(s => s.trim())
-        .filter(ip => ip && !ip.startsWith('127.') && !ip.startsWith('169.254.') && !ip.startsWith('172.'))
+        .filter(isLanIPv4)
     } catch { return [] }
   }
 
-  const nets = networkInterfaces()
-  const networkIPs = []
-  for (const name of Object.keys(nets)) {
-    for (const net of nets[name]) {
-      if (net.family === 'IPv4' && !net.internal) networkIPs.push(net.address)
-    }
-  }
-  return networkIPs
+  return collectIPs(networkInterfaces())
 }
 
-export function printServerInfo(port = 3000) {
-  const networkIPs = getNetworkIPs()
-
+// `networkIPs` è iniettabile per rendere la stampa testabile in modo deterministico.
+export function printServerInfo(port = 3000, networkIPs = getNetworkIPs()) {
   console.log(`\nSegnapunti Server`)
   console.log(`   Display:    http://127.0.0.1:${port}/display`)
   console.log(`   Controller: http://127.0.0.1:${port}/controller`)