Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!
Solucionado
No README.md do projeto diz que o arquivo .env deveria ser criado automaticamente, o que não ocorreu provavelmente porque esse arquivo .env está no gitIgnore. Eu criei o .env manualmente na pasta raiz do projeto, mas não sei o que devo colocar nesse .env. Por favor, poderiam me ajudar? Muito obrigado.
Olá, Romualdo. Como vai?
Você tocou em um ponto fundamental do desenvolvimento de software moderno! O seu raciocínio está totalmente correto: o arquivo .env fica obrigatoriamente listado no .gitignore porque ele armazena dados sensíveis que nunca devem ser expostos publicamente no GitHub.
Como o curso é sobre Spec Driven Development e agentes de IA, o seu projeto precisa se comunicar com as APIs dos modelos de linguagem. O arquivo .env (de environment, ou ambiente) serve exatamente para guardar essas credenciais de acesso e chaves privadas.
Para resolver o seu problema agora e fazer o projeto funcionar, trago o passo a passo do que você deve colocar dentro dele e uma boa prática de mercado indispensável.
.env?Geralmente, projetos que utilizam agentes de IA precisam de chaves de API específicas. Abra o arquivo .env que você criou na raiz e insira as variáveis abaixo (substituindo os valores fictícios pelas suas chaves reais):
# Exemplo de chaves para os modelos de IA
OPENAI_API_KEY=sk-proj-SuaChaveSecretaDaOpenAIAqui...
GEMINI_API_KEY=AIzaSySuaChaveSecretaDoGeminiAqui...
ANTHROPIC_API_KEY=sk-ant-SuaChaveSecretaDaAnthropicAqui...
# Configurações do ambiente do projeto
PORT=3000
NODE_ENV=development
⚠️ Atenção: Não coloque espaços antes ou depois do sinal de igual (
=) e não mude o nome das variáveis (o texto antes do=deve ser exatamente o que o projeto espera ler).
.env.exampleComo o .env original está oculto pelo Git, uma das maiores boas práticas do mercado é criar um segundo arquivo na raiz chamado .env.example.
Esse arquivo não vai para o .gitignore e serve como um manual ou "molde" para que outros desenvolvedores (ou você mesmo no futuro) saibam quais variáveis o projeto precisa para rodar, sem expor as chaves reais.
A estrutura do seu .env.example deve ser assim:
# Modelo de configuração do projeto (Copie este arquivo e mude para .env)
OPENAI_API_KEY=insira_sua_chave_da_openai_aqui
GEMINI_API_KEY=insira_sua_chave_do_gemini_aqui
PORT=3000
Se o projeto que você baixou já tiver um arquivo chamado .env.example ou .env.dist, basta você duplicá-lo, renomear a cópia para apenas .env e preencher com os seus dados!
Parabéns por investigar os bastidores do projeto e resolver o problema do arquivo oculto manualmente. Esse entendimento de infraestrutura é vital para trabalhar com agentes autônomos.
Espero que possa ter lhe ajudado e bons estudos com os agentes de IA!
Olá Romualdo! Tudo bem?
Sobre o arquivo .env, é normal que ele não esteja disponível no repositório, pois geralmente contém informações sensíveis, como credenciais de banco de dados, que não devem ser compartilhadas publicamente.
O que você pode fazer é criar o seu próprio arquivo .env na raiz do projeto. Em seguida, adicionar o seguintes valores conforme esse readme disponibilizado na aula 05. Deixo abaixo também:
# Database
DATABASE_URL=postgresql://admin:admin123@localhost:5432/api_ecommerce
# Redis
REDIS_HOST=localhost
REDIS_PORT=6379
# JWT
JWT_ACCESS_SECRET=seu-secret-super-seguro-min-32-chars
JWT_ACCESS_EXPIRATION=15m
JWT_REFRESH_SECRET=seu-secret-refresh-super-seguro
JWT_REFRESH_EXPIRATION=7d
# Application
NODE_ENV=development
PORT=3000
Lembre-se de substituir os valores acima pelas suas credenciais reais.
Espero ter ajudado.
Qualquer dúvida que surgir, compartilhe no fórum. Abraços e bons estudos!
Muito obrigado Monalisa Meyrelle de Sousa Silva e Evandro Santana Amadio.