CONTRACT.md

[Task-ID/Nome] Especificação Técnica e Plano de Execução

1. Contexto e Objetivo

Estado Atual: Mudança Necessária: Motivação:

2. Contratos de Interface (Payloads & Types)

A implementação deve seguir estritamente as interfaces de dados abaixo.

Input/Output Esperado

// [INSERIR O JSON OU INTERFACE TYPESCRIPT AQUI]
// Exemplo do seu payload de Locales/Regions

3. Fontes de Dados e Integrações

• Endpoint Principal: https://kinsta.com/pt/blog/o-que-sao-variaveis-de-ambiente/
• Dependências: [Ex: API de Tenant Binding, Bibliotecas internas]
• Autenticação/Headers: [Se necessário]

4. Regras de Negócio e Comportamento

• Runtime vs Buildtime: [Explicar onde o código será executado]
• Tratamento de Erros: [O que fazer se a API falhar?]
• Fallbacks: [Existe valor padrão?]

5. Estratégia de Testes (TDD Obrigatório)

Seguiremos o ciclo Red-Green-Refactor.

1. Novos Cenários:

• Cenário A: [Ex: Retornar lista correta de regions]
• Cenário B: [Ex: Validar formato de data por locale]

2. Regressão: Garantir que [Funcionalidade antiga] não quebre.

INPUT.md

Copie e cole este texto no chat do Cursor após carregar o arquivo acima no contexto. Ele força a IA a adotar uma postura de Arquiteto/Sênior focada em TDD.

Role: Você é um Engenheiro de Software Sênior especialista em TDD e Clean Architecture.

Task: Vamos implementar a feature descrita no documento de plano em anexo (CONTRACT.md).

Diretrizes de Execução (Strict Mode):

1. Análise: Leia o payload e as regras de negócio. Confirme se entendeu a diferença entre o método antigo (runtime) e o novo (buildtime).
2. TDD First (Obrigatório):
   • NÃO escreva a implementação ainda.
   • Primeiro, escreva os testes unitários (ou de integração) baseados no JSON de exemplo fornecido.
   • Os testes devem falhar inicialmente (Red state).
   • Verifique edge cases (ex: campos vazios, API fora do ar).
3. Implementação:
   • Escreva o código mínimo necessário para fazer os testes passarem (Green state).
   • Utilize os endpoints especificados na documentação.
4. Refatoração: Melhore a legibilidade e otimize se necessário.

Ação Imediata: Por favor, analise o payload fornecido e gere o arquivo de teste inicial para cobrir os cenários de defaultLocale, regions e locales. Me mostre apenas o código dos testes para eu aprovar.