Juego de Mazmorra con IA

Resumen

Durante este tutorial construirás un juego de aventura de mazmorras impulsado por IA. Este tutorial no asume ningún conocimiento previo del @aws/nx-plugin o tecnologías relacionadas. Las técnicas que aprenderás son fundamentales para construir cualquier aplicación basada en @aws/nx-plugin, y comprenderlo completamente te dará un conocimiento profundo de este plugin y una comprensión básica de cómo usar NX.

Nota

Este tutorial está diseñado para personas que prefieren aprender haciendo y quieren crear algo tangible rápidamente. Si prefieres aprender cada concepto paso a paso, consulta las guías individuales de componentes.

Al completar este tutorial, los usuarios podrán:

• Utilizar el @aws/nx-plugin para crear nuevas aplicaciones
• Usar NX para gestionar/construir su base de código
• Construir APIs usando tanto tRPC como FastAPI
• Usar Tanstack router para crear nuevas páginas
• Emplear Tanstack query para llamar a APIs backend
• Modificar código generado para adaptarlo a propósitos específicos
• Crear e implementar infraestructura CDK

¿Qué vas a construir?

En este tutorial crearás un juego de aventura de mazmorras con IA usando @aws/nx-plugin.

Puedes ver cómo quedará al finalizar aquí:

Componentes de la aplicación

El juego se construirá usando la siguiente arquitectura de componentes:

• API tRPC que usa ElectroDB/DynamoDB para gestionar el estado del juego
• Función Lambda en Python/FastAPI con respuestas en streaming para generación de historias (con tecnología de Amazon Bedrock)
• Frontend React/Vite que utiliza:
  • Amazon Cognito/Identity Pools para llamadas API seguras
  • Tanstack router con enrutamiento basado en archivos y tipos seguros
  • SDKs generados para interactuar con las APIs del juego e historia (usando Tanstack query)
• Infraestructura CDK para implementar la aplicación

Requisitos previos

Se necesitan las siguientes dependencias globales antes de continuar:

Requeridos

• Git
• Node >= 22 (Recomendamos usar algo como NVM para gestionar tus versiones de Node)
  • Verifica ejecutando node --version
• PNPM >= 10 (También puedes usar Yarn >= 4, Bun >= 1 o NPM >= 10 si lo prefieres)
  • Verifica ejecutando pnpm --version, yarn --version, bun --version o npm --version
• UV >= 0.5.29
  1. Instala Python 3.12 ejecutando: uv python install 3.12.0
  2. Verifica con uv python list --only-installed
• Credenciales de AWS configuradas para tu cuenta objetivo de AWS (donde se desplegará tu aplicación)

Recomendados

• Docker es requerido para algunos generadores.
• Terraform >= 1.12 es necesario si eliges usarlo para infraestructura como código en lugar de CDK
  • Verifica ejecutando terraform --version
• Si usas VSCode, recomendamos instalar el Plugin Nx Console para VSCode.

Consejo

Si usas un Asistente de IA como Amazon Q Developer, Cursor, Claude Code o Cline, también puedes querer instalar el Nx Plugin para AWS MCP server.

• Asegúrate que tu cuenta de AWS tiene acceso habilitado al modelo Anthropic Claude 3.5 Sonnet v2 en Bedrock para tu región objetivo, siguiendo los pasos de esta guía.