giochino/docs/IMPLEMENTAZIONE.md

Report Implementazione — Stato Attuale

Data: 2026-09-24
Stato: NON FUNZIONANTE

Cosa è stato fatto

Struttura file

giochino/
├── index.html          # Gioco principale (Canvas JS) — NON FUNZIONA
├── server.js           # Server HTTP Node.js
├── server2.js          # Server HTTP Node.js (backup)
├── server3.js          # Server HTTP Node.js (backup)
├── pong.py             # Versione Python pygame — NON TESTATA
├── kitbitz-mcp-call.sh # Test MCP Kitbitz
├── validate.py         # Script validazione JS
├── Schermata.png       # Screenshot dell'utente
├── README.md           # Documentazione base
└── docs/               # Questa cartella

Server HTTP

• Creati 3 diversi server Node.js (server.js, server2.js, server3.js)
• Il server resta attivo su porta 8095 (via nohup)
• Servizio file HTML funziona (HTTP 200)

Gioco JavaScript — Problemi riscontrati

Tentativo 1

• Problema: Menu disegnato su Canvas non apparebbava (sfondo nero con solo testo HTML visibile)
• Causa probabile: Funzione drawMenu() non chiamata correttamente o errori JS silenziosi

Tentativo 2

• Problema: Menu con elementi HTML apparevano ma i tasti non rispondevano
• Causa probabile: Event listener non registrava correttamente i tasti frecce
• Errore specifico: La tastiera dell'utente genera codici non standard (convert, nonconvert, NumPadEnter) invece di ArrowUp/ArrowDown

Tentativo 3

• Problema: Pagina si blocca completamente dopo selezione "VS CPU"
• Causa probabile: Loop di gioco con errore runtime non gestito

Tentativo 4

• Problema: Nessun menu, gioco parte direttamente ma disco non si muove con F
• Causa probabile: Logica di stato mal implementata, conflitti nel loop principale

Analisi dei fallimenti

1. Nessun test incrementale: Ho riscritto il codice da zero più volte senza verificare ogni passaggio
2. Debug insufficiente: Assenza di try-catch e logging effettivo
3. Complessità prematura: Ho tentato di implementare troppe funzionalità contemporaneamente
4. Mancanza di validazione: Il validator JS (validate.py) rilevava solo errori sintattici, non runtime
5. Assunza errata sulle API: Non ho verificato il comportamento reale degli eventi Canvas/tastiera nel browser

Cosa manca

• Menu funzionante con navigazione tastiera
• Selezione difficoltà
• Gioco vero e proprio con fisica disco
• IA CPU
• Sistema punteggio con set
• Impostazioni tasti funzionanti
• Integrazione con asset Kitbitz (mai iniziata)