Jogo de Dungeons com IA

Visão Geral

Você construirá um jogo de aventura em masmorra com IA durante este tutorial. Este tutorial não assume nenhum conhecimento prévio do @aws/nx-plugin ou tecnologias relacionadas. As técnicas que você aprenderá são fundamentais para construir qualquer aplicação baseada no @aws/nx-plugin, e compreendê-las completamente lhe dará um conhecimento profundo do @aws/nx-plugin e uma compreensão básica de como usar NX.

Nota

Este tutorial é projetado para quem prefere aprender fazendo e deseja criar algo tangível rapidamente. Se prefere aprender cada conceito passo a passo, consulte os Guias de componentes individuais

Ao completar este tutorial, você terá conhecimento para:

• Usar o @aws/nx-plugin para criar novas aplicações
• Usar NX para gerenciar/construir sua base de código
• Construir APIs usando tRPC e FastAPI
• Usar Tanstack router para criar novas páginas
• Usar Tanstack query para chamar APIs de backend
• Fazer modificações no código gerado para adequá-lo a propósitos específicos
• Criar e implantar infraestrutura CDK

O que você vai construir?

Neste tutorial, você construirá um jogo de aventura em masmorra com IA usando @aws/nx-plugin.

Veja como ficará ao final:

Componentes da aplicação

O jogo será construído usando a seguinte arquitetura de componentes:

• API tRPC usando ElectroDB/DynamoDB para gerenciar o estado do jogo
• Função Lambda Python/FastAPI com respostas em streaming para geração de história (alimentada por Amazon Bedrock)
• Frontend React/Vite utilizando:
  • Amazon Cognito/Identity Pools para chamadas seguras de API
  • Tanstack router com roteamento baseado em arquivos e type-safety
  • SDKs gerados para consumir as APIs de Jogo e História (usando Tanstack query)
• Infraestrutura CDK para implantação

Pré-requisitos

Os seguintes requisitos globais são necessários:

Requisitos

• Git
• Node >= 22 (Recomendamos usar algo como NVM para gerenciar versões do Node)
  • verifique executando node --version
• PNPM >= 10 (também pode usar Yarn >= 4, Bun >= 1 ou NPM >= 10 se preferir)
  • verifique executando pnpm --version, yarn --version, bun --version ou npm --version
• UV >= 0.5.29
  1. instale Python 3.12 executando: uv python install 3.12.0
  2. verifique com uv python list --only-installed
• Credenciais da AWS configuradas para sua conta AWS de destino (onde sua aplicação será implantada)

Recomendados

• Docker é necessário para alguns geradores
• Terraform >= 1.12 é necessário se você optar por usar isso para infraestrutura como código em vez do CDK
  • verifique executando terraform --version
• Se estiver usando VSCode, recomendamos instalar o Nx Console VSCode Plugin

Dica

Se você usa um Assistente de IA como Amazon Q Developer, Cursor, Claude Code ou Cline, pode querer também instalar o Nx Plugin para AWS MCP server.

• Garanta que sua conta AWS tenha acesso ao modelo Anthropic Claude 3.5 Sonnet v2 no Bedrock para sua região alvo, seguindo os passos deste guia.