Aggiungi documentazione: requisiti, implementazione, lezioni apprese

docs/REQUISITI.md

@@ -0,0 +1,46 @@
+# Specifica dei Requisiti — Windjammers Arcade
+
+**Data:** 2026-09-24  
+**Autore:** utente  
+**Stato:** incompleto — implementazione parziale con problemi
+
+## Obiettivo
+
+Creare un gioco web ispirato a **Windjammers** (noto in Giappone come **Flying Power Disc**), sviluppato da Data East e pubblicato da SNK nel 1994 per Neo Geo.
+
+## Requisiti concordati
+
+### Modalità di gioco
+- **VS CPU** con tre livelli di difficoltà: Facile, Normale, Difficile
+- **2 Giocatori** locale
+- **Impostazioni** per riconfigurare i tasti di entrambi i giocatori
+
+### Meccaniche di gioco (ispirate a Windjammers)
+- Campo diviso in due metà da una rete
+- Gol suddiviso in zone da 3 e 5 punti
+- Tre tipi di tiro: normale, lob (alto), supersonic (veloc)
+- Slide (scivolata) per recuperare il disco
+- 3 set per vincere la partita
+
+### Controlli
+| Azione | P1 (default) | P2 (default) |
+|--------|-------------|-------------|
+| Movimento | WASD | Frecce |
+| Tiro | F | K |
+| Lob | G | L |
+| Slide | H | ; |
+
+### Interfaccia
+- Menu principale con selezione modalità
+- Schermata difficoltà (solo VS CPU)
+- Impostazioni tasti con riconfigurazione live
+- HUD con punteggi e timer
+
+### Grafica
+- Sprite procedurali (Canvas API)
+- Stile hand-drawn (ispirato a Kitbitz, CC0)
+- Sfondo campo, reti, porte colorate
+
+---
+
+**Nota:** I requisiti sono stati discussi verbalmente e non sono stati formalizzati in un documento scritto prima dell'implementazione.