Prepare seu ambiente

🧰 Prepare seu ambiente

Se esta é sua primeira vez com terminal

Você não precisa ter assistido à apresentação. Comece aqui e depois siga um LAB por vez.

• Terminal: janela em que você digita comandos. No Windows, abra o PowerShell ou Prompt de Comando pelo menu Iniciar; no macOS ou Linux, abra o aplicativo Terminal
• Pasta atual: lugar em que o terminal está trabalhando. cd nome-da-pasta entra em uma pasta; cd .. volta um nível
• Repositório: a pasta deste projeto, com código, textos e histórico. Clonar baixa uma cópia para seu computador
• Raiz do repositório: a pasta principal devday-exchange-community-rio-2026, antes de entrar em apps, labs ou exercises
• Node.js: executa os exemplos JavaScript/TypeScript. npm: instala os pacotes que a interface precisa. Git: obtém o projeto e compara alterações

Nos blocos marcados como comandos, copie uma linha, cole no terminal e pressione Enter. Aguarde o resultado antes da próxima. Nos blocos texto para enviar, cole na conversa do produto indicado, não no terminal. As saídas esperadas são exemplos do que ler; não são comandos para copiar.

Instale apenas o que faltar

1. Execute os três comandos da tabela abaixo. Se uma ferramenta responder com sua versão, ela já está disponível.
2. Se aparecer “comando não encontrado” ou “não é reconhecido”, abra o link oficial da ferramenta, selecione seu sistema e instale. Para Node.js, use uma versão de 24.12.0 a 24.21.0. O arquivo .nvmrc recomenda 24.21.0, a mesma versão da CI. A faixa aceita está no campo engines.
3. Feche e abra o terminal de novo, então repita a verificação. Não prossiga com um Node fora de 24.12.0 a 24.21.0. npm ci recusa essa instalação: os projetos usam engine-strict.
4. Editor e navegador são locais à sua escolha. Não é preciso instalar uma extensão de IA no editor.

Ferramenta	Requisito	Para que serve
Node.js	24.12.0 a 24.21.0 (.nvmrc recomenda 24.21.0)	Executar os testes e a aplicação
npm	Incluído no Node.js	Instalar dependências pelo lockfile
Git	Disponível no terminal	Clonar o repositório e acompanhar mudanças
Editor e navegador	Seus preferidos, atualizados	Explorar arquivos e usar a demo
Acesso ao produto do LAB	Confira o guia escolhido	Experimentar Dots, CLI ou Cloud

A CI usa Node.js 24.21.0, o valor de .nvmrc. A Alô, TI e o portal aceitam 24.12.0 a 24.21.0 (engines). Abaixo de 24.12.0 a instalação ou os testes não passam: o Next.js 16 pede Node 20.9.0, os testes .mts só carregam a partir do 22.18 e o Firebase do portal pede 24.12.0. As versões da aplicação estão em package.json e package-lock.json.

node --version
npm --version
git --version

Como ler a saída: node --version começa com v, como v24.21.0; npm --version traz números; git --version começa com git version. O arquivo .nvmrc recomenda v24.21.0 para a CI. A faixa aceita vai de v24.12.0 a v24.21.0.

Os testes offline e o mock não exigem conta OpenAI nem chave de API. Instalar dependências requer acesso ao registro npm. O acesso aos produtos dos LABS deve ser preparado separadamente.

Obtenha o projeto antes de escolher um LAB de código

Dots não pede clone: o LAB usa o ChatGPT e duas páginas públicas do GitHub. Para CLI, Cloud ou Decisions, abra um terminal na pasta onde você guarda projetos e execute:

git clone --branch main https://github.com/glaucia86/devday-exchange-community-rio-2026.git
cd devday-exchange-community-rio-2026
node --test exercises/ticket-router/starter/router.test.mjs

Para conferir a pasta atual em qualquer um desses sistemas:

node -p "process.cwd()"

O caminho exibido deve terminar em devday-exchange-community-rio-2026. Se terminar em apps/decisions, use cd ../.. para voltar à raiz. Se abriu outro terminal, ele pode ter começado em uma pasta diferente; confira de novo.

No final do teste inicial, procure esta contagem. O desenho dos símbolos e os tempos variam:

tests 3
pass 3
fail 0

Confira: o terminal está na pasta devday-exchange-community-rio-2026 e os três testes passam. Quando um LAB disser “na raiz do repositório”, é esta pasta. Se node ou git não existir, instale pela fonte oficial da tabela e reabra o terminal.

Se já tiver uma cópia, não clone por cima nem descarte alterações. Confira git status --short; atualize somente quando souber o que está preservando. O material publicado fica em main.

Se não conseguiu chegar até aqui:

O que apareceu	O que fazer
A pasta de destino já existe	Não clone por cima. Abra a cópia existente ou escolha outra pasta para um clone novo
Cannot find module	Confira node -p "process.cwd()" e o caminho do comando. Não crie um arquivo vazio para esconder o erro
Falha de download/conexão	Confira a conexão e tente o mesmo comando novamente; não mude configurações de segurança para contornar o problema
Terminal mostra > e parece esperar mais texto	Pode faltar fechar uma aspa. Cancele com Ctrl+C e cole novamente a linha inteira do guia

O site do evento é um portal de leitura. A Alô, TI só aparece em 127.0.0.1 depois que você inicia a aplicação no seu computador. 127.0.0.1 significa “esta máquina”; o servidor da demo não é o site público do evento.

Os exercícios de código não precisam de npm install. A instalação com npm ci --ignore-scripts é necessária apenas para abrir a interface Alô, TI, conforme Execute a demo. Os LABS de CLI e Cloud explicam separadamente o login e a preparação do produto.

🪟 Usando Windows com PowerShell?

Se o PowerShell informar que npm.ps1 não pode ser carregado, abra o Prompt de Comando ou use npm.cmd no lugar de npm. O mesmo vale para npx.cmd. Essa alternativa não exige mudar a política de execução do sistema.

✅ Verifique seu ambiente

Na raiz do repositório, com Node.js de 24.12.0 a 24.21.0:

node --test exercises/ticket-router/starter/router.test.mjs
node --test exercises/ticket-router/solution/router.test.mjs
node --test apps/decisions/tests/*.test.mts
node --test exercises/ticket-router/review-candidate/router.test.mjs exercises/decisions-contract/inspect.test.mts
node scripts/check-workshop-examples.mjs
node scripts/check-doc-links.mjs
node --test scripts/check-dots-guide.test.mjs

O scripts/check-dots-guide.test.mjs confere o texto do LAB de Dots e não entra nessa contagem. O conjunto contém 88 testes: 3 do starter, 8 da solução, 5 da candidata de revisão, 5 do exercício de contrato e 67 da aplicação (Alô, TI e Triagem ao vivo). Além deles, a verificação pedagógica executa 18 casos de aceitação em cada versão do encaminhador: starter com 10 falhas esperadas, candidata com 2 e solução sem falhas. Consulte a CI do commit atual para o resultado. Testes verdes da candidata não significam que ela já está correta.

Dentro de apps/decisions, após instalar as dependências:

npm run typecheck
npm test
npm run build

Para Chromium, siga o guia da aplicação. A instalação do navegador de teste é adicional ao uso normal da demo.

GitHub Actions · Evidências e limitações

🎒 Checklist para acompanhar e reproduzir

No encontro

• Confirmei minha inscrição.
• Salvei o material para reproduzir as demonstrações depois.
• Sei que Glaucia conduz as demos; não preciso instalar nem executar os LABS junto com a apresentação.

Em casa, quando for praticar

• Escolhi um LAB e li seus requisitos.
• Para os LABS de código: Node.js de 24.12.0 a 24.21.0, npm e Git respondem no terminal.
• Para abrir as demos: instalação, tipos, build e npm start em apps/decisions, conforme os comandos diretos acima.
• Se o ensaio incluir o Codex CLI: codex --version mostra codex-cli 0.161.0, codex login status confirma a sessão, a abertura usa -m gpt-6-luna -s workspace-write, a pasta foi confiada antes do projetor e, dentro do agente, node --version mostra v24.21 ou posterior. A Alô, TI desse bloco sobe com npm run dev em apps/decisions, antes do relógio.
• Clonei a branch indicada e executei os testes offline.
• Se vou abrir a Alô, TI, instalei as dependências e conferi o modo Simulado.
• Conferi meu acesso ao produto necessário e os limites de uso aplicáveis.
• Se optar por voz real, autorizei meu orçamento de teste e segui a configuração segura.
• Usarei somente dados fictícios ou públicos.