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

server.js

@@ -1,7 +1,7 @@
 import { createServer } from 'http'
 import express from 'express'
 import { WebSocketServer } from 'ws'
-import { fileURLToPath } from 'url'
+import { fileURLToPath, pathToFileURL } from 'url'
 import { dirname, join } from 'path'
 import { setupWebSocketHandler } from './src/websocket-handler.js'
 import { printServerInfo } from './src/server-utils.js'
@@ -10,36 +10,52 @@ import { loadState, saveState } from './src/persist.js'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 
-const PORT = process.env.PORT || 3000
-const distDir = join(__dirname, 'dist')
+const DIST_DIR = join(__dirname, 'dist')
 
-const app = express()
+// Crea l'app Express (asset statici + route display/controller) senza avviare il
+// listen né il WebSocket: così il routing è testabile in isolamento.
+export function createApp(distDir = DIST_DIR) {
+    const app = express()
 
-app.use(express.static(distDir, { index: false }))
+    app.use(express.static(distDir, { index: false }))
 
-app.get(['/', '/display', '/display/*splat'], (_req, res) => {
-    res.sendFile(join(distDir, 'index.html'))
-})
+    app.get(['/', '/display', '/display/*splat'], (_req, res) => {
+        res.sendFile(join(distDir, 'index.html'))
+    })
 
-app.get(['/controller', '/controller/*splat'], (_req, res) => {
-    res.sendFile(join(distDir, 'controller.html'))
-})
+    app.get(['/controller', '/controller/*splat'], (_req, res) => {
+        res.sendFile(join(distDir, 'controller.html'))
+    })
 
-const server = createServer(app)
-const wss = new WebSocketServer({ noServer: true })
-setupWebSocketHandler(wss, { initialState: loadState(), onStateChange: saveState })
+    return app
+}
 
-server.on('upgrade', (request, socket, head) => {
-    const pathname = new URL(request.url, `http://${request.headers.host}`).pathname
-    if (pathname === '/ws') {
-        wss.handleUpgrade(request, socket, head, (ws) => {
-            wss.emit('connection', ws, request)
-        })
-    } else {
-        socket.destroy()
-    }
-})
+// Avvia HTTP + WebSocket. Lo stato viene caricato da disco e ripersistito ad ogni azione.
+export function startServer(port = process.env.PORT || 3000) {
+    const app = createApp()
+    const server = createServer(app)
+    const wss = new WebSocketServer({ noServer: true })
+    setupWebSocketHandler(wss, { initialState: loadState(), onStateChange: saveState })
 
-server.listen(PORT, '0.0.0.0', () => {
-    printServerInfo(PORT)
-})
+    server.on('upgrade', (request, socket, head) => {
+        const pathname = new URL(request.url, `http://${request.headers.host}`).pathname
+        if (pathname === '/ws') {
+            wss.handleUpgrade(request, socket, head, (ws) => {
+                wss.emit('connection', ws, request)
+            })
+        } else {
+            socket.destroy()
+        }
+    })
+
+    server.listen(port, '0.0.0.0', () => {
+        printServerInfo(port)
+    })
+
+    return server
+}
+
+// Avvia solo se eseguito direttamente (`node server.js`), non quando importato nei test.
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    startServer()
+}