Gioco di Dungeon con IA

Panoramica

In questo tutorial costruirai un gioco di avventura in stile dungeon alimentato da IA. Questo tutorial non presuppone alcuna conoscenza pregressa di @aws/nx-plugin o tecnologie correlate. Le tecniche che apprenderai sono fondamentali per costruire qualsiasi applicazione basata su @aws/nx-plugin, e una comprensione completa ti darà una profonda conoscenza dello strumento insieme alle basi per utilizzare NX.

Nota

Questo tutorial è pensato per chi preferisce imparare facendo e vuole creare rapidamente qualcosa di tangibile. Se preferisci apprendere ogni concetto passo dopo passo, consulta le guide dei singoli componenti

Gli utenti che completeranno questo tutorial acquisiranno le conoscenze per:

• utilizzare @aws/nx-plugin per creare nuove applicazioni
• usare NX per gestire/compilare il codice
• costruire API usando sia tRPC che FastAPI
• utilizzare Tanstack router per creare nuove pagine
• usare Tanstack query per chiamare API backend
• modificare il codice generato per adattarlo allo scopo
• creare e distribuire infrastrutture CDK

Cosa costruirai?

In questo tutorial creerai un gioco di avventura in stile dungeon alimentato da IA utilizzando @aws/nx-plugin.

Ecco un’anteprima del risultato finale:

Componenti dell’applicazione

L’architettura del gioco utilizza i seguenti componenti:

• API tRPC che usa ElectroDB/DynamoDB per gestire lo stato del gioco
• Funzione Lambda Python/FastAPI con risposte in streaming per la generazione della storia (basata su Amazon Bedrock)
• Frontend React/Vite che utilizza:
  • Amazon Cognito/Identity Pools per chiamate API sicure
  • Tanstack router con routing basato su file e type safety
  • SDK generati per chiamare le API di Gioco e Storia (con Tanstack query)
• Infrastruttura CDK per il deployment

Prerequisiti

Sono necessarie le seguenti dipendenze globali:

Obbligatori

• Git
• Node >= 22 (Consigliamo l’uso di strumenti come NVM per gestire le versioni di Node)
  • verifica con node --version
• PNPM >= 10 (puoi usare anche Yarn >= 4, Bun >= 1 o NPM >= 10 se preferisci)
  • verifica con pnpm --version, yarn --version, bun --version o npm --version
• UV >= 0.5.29
  1. installa Python 3.12 eseguendo: uv python install 3.12.0
  2. verifica con uv python list --only-installed
• Credenziali AWS configurate per il tuo account AWS di destinazione (dove verrà distribuita l’applicazione)

Consigliati

• Docker è necessario per alcuni generatori
• Terraform >= 1.12 è richiesto se scegli di usarlo per l’infrastructure as code invece di CDK
  • verifica con terraform --version
• Se usi VSCode, consigliamo di installare il Nx Console VSCode Plugin

Consiglio

Se utilizzi un assistente AI come Amazon Q Developer, Cursor, Claude Code o Cline, potresti voler installare il Plugin Nx per AWS MCP server.

• Assicurati che il tuo account AWS abbia abilitato l’accesso al modello Anthropic Claude 3.5 Sonnet v2 in Bedrock per la regione target seguendo i passaggi della questa guida.