Jeu de Donjon IA

Aperçu

Au cours de ce tutoriel, vous allez construire un jeu d’aventure donjon alimenté par l’IA. Ce tutoriel ne nécessite aucune connaissance préalable du @aws/nx-plugin ou des technologies associées. Les techniques que vous apprendrez sont fondamentales pour construire toute application basée sur @aws/nx-plugin, et leur compréhension complète vous donnera une maîtrise approfondie du @aws/nx-plugin ainsi qu’une connaissance de base de NX.

Note

Ce tutoriel est conçu pour les personnes qui préfèrent apprendre en pratiquant et souhaitent rapidement créer quelque chose de concret. Si vous préférez apprendre chaque concept étape par étape, reportez-vous aux guides des composants individuels.

À l’issue de ce tutoriel, les utilisateurs auront acquis les connaissances nécessaires pour :

• utiliser le @aws/nx-plugin pour créer de nouvelles applications
• utiliser NX pour gérer/construire leur base de code
• construire des APIs avec tRPC et FastAPI
• utiliser Tanstack router pour créer de nouvelles pages
• utiliser Tanstack query pour appeler des APIs backend
• modifier du code généré pour l’adapter à des besoins spécifiques
• créer et déployer une infrastructure CDK

Que allez-vous construire ?

Dans ce tutoriel, vous allez créer un jeu d’aventure donjon alimenté par l’IA avec @aws/nx-plugin.

Vous pouvez visualiser le résultat final ici :

Composants de l’application

Le jeu sera construit selon l’architecture suivante :

• Une API tRPC utilisant ElectroDB/DynamoDB pour la gestion de l’état du jeu
• Une fonction Lambda Python/FastAPI avec des réponses en streaming pour la génération d’histoire (alimentée par Amazon Bedrock)
• Un frontend React/Vite utilisant :
  • Amazon Cognito/Identity Pools pour les appels API sécurisés
  • Tanstack router avec routage basé sur les fichiers et typage strict
  • Des SDK générés pour appeler les APIs de jeu et d’histoire (utilisant Tanstack query)
• Une infrastructure CDK pour le déploiement

Prérequis

Les dépendances globales suivantes sont nécessaires :

Nécessaires

• Git
• Node >= 22 (Nous recommandons d’utiliser un gestionnaire comme NVM pour les versions de Node)
  • vérifiez avec node --version
• PNPM >= 10 (vous pouvez aussi utiliser Yarn >= 4, Bun >= 1 ou NPM >= 10 si vous préférez)
  • vérifiez avec pnpm --version, yarn --version, bun --version ou npm --version
• UV >= 0.5.29
  1. installez Python 3.12 en exécutant : uv python install 3.12.0
  2. vérifiez avec uv python list --only-installed
• Identifiants AWS configurés pour votre compte AWS cible (où votre application sera déployée)

Recommandés

• Docker est requis pour certains générateurs
• Terraform >= 1.12 est requis si vous choisissez de l’utiliser pour l’infrastructure as code au lieu de CDK
  • vérifiez avec terraform --version
• Si vous utilisez VSCode, nous recommandons d’installer l’extension Nx Console pour VSCode

Astuce

Si vous utilisez un assistant IA comme Amazon Q Developer, Cursor, Claude Code ou Cline, vous pouvez également souhaiter installer le plugin Nx pour AWS MCP server.

• Vérifiez que votre compte AWS a activé l’accès au modèle Anthropic Claude 3.5 Sonnet v2 dans Bedrock pour votre région cible en suivant les étapes décrites dans ce guide.