Testando Durante o Desenvolvimento

Testes Unitários Locais

Antes de enviar suas atualizações, verifique se elas passam em todos os testes unitários. Siga estas etapas para executar os testes localmente:

• Copie seu arquivo .env.example na pasta /api e renomeie-o para .env

  cp .env.example ./api/.env

• Adicione NODE_ENV=CI ao seu arquivo /api/.env

• npm run test:client

• npm run test:api

• npm run test:packages:api

• npm run test:packages:data-provider

• npm run test:packages:data-schemas

Executando Testes por Workspace

Os testes são executados usando o Jest a partir de seus respectivos diretórios de workspace. Direcione arquivos de teste específicos com padrões:

cd api && npx jest <pattern>
cd packages/api && npx jest <pattern>
cd packages/data-provider && npx jest <pattern>
cd packages/data-schemas && npx jest <pattern>
cd client && npx jest <pattern>

Filosofia de Testes

• Prefira lógica real em vez de mocks. Use mocks apenas para o que não pode ser controlado localmente, como APIs HTTP externas, serviços com limite de taxa (rate-limited) e chamadas de sistema não determinísticas.
• Use spies quando precisar verificar se funções reais foram chamadas com os argumentos esperados.
• Use mongodb-memory-server para testes baseados em MongoDB, para que as consultas e a validação de esquema sejam executadas com o comportamento real do banco de dados.
• Cubra os estados de carregamento, sucesso e erro para fluxos de UI/dados.