QABot

Revisão técnica assistida por IA

Histórico859298f6-32b8-4cf8-abdd-08afa174b943
ANÁLISE SALVA

cellarvinhostechteam/appcellar-bff

meus-cupons-impl · 30 de outubro de 2026 às 15:01 · gpt-5.6-sol

58/ 100

A branch apresenta boa organização geral, validações de entrada e uso de transações em operações críticas, mas há riscos relevantes de confiabilidade no deploy e nos alertas, possibilidade de SSRF por DNS rebinding, consultas administrativas não escaláveis e inconsistências funcionais em métricas e templates. Não foram fornecidos testes automatizados entre os 24 arquivos, deixando os principais fluxos sem evidência de regressão. Score: 58/100.

Achados 15

24 arquivos analisados

Alto

Deploy em produção não é atômico e pode deixar aplicação parcialmente atualizada

reliability
.github/workflows/deploy.yml

O workflow executa diretamente no diretório ativo: `git reset --hard origin/main`, seguido de `composer install`, migrações, otimização e somente depois `npm ci`/`npm run build`. Durante esse intervalo, requisições podem atingir uma combinação de código, dependências, banco e assets de versões diferentes. Se uma etapa posterior à migração falhar, `set -e` interrompe o processo sem rollback do código ou do banco.

RecomendaçãoAdotar deploy por releases em diretórios versionados, executar Composer e build antes da troca de symlink, habilitar modo de manutenção apenas na janela necessária e definir estratégia de rollback para código e migrações. Incluir `--no-dev` no `composer install` de produção se dependências de desenvolvimento não forem necessárias.
Alto

Comando de saúde reenviará o mesmo alerta repetidamente

reliability
app/Console/Commands/CheckObservabilityHealthCommand.php

`handle()` consulta todos os erros dentro de uma janela móvel e chama `sendAlertWebhook()` sempre que `totalErrors > 0`. Não há registro do último evento alertado, cooldown ou chave de deduplicação. Com execução recorrente pelo scheduler, um único erro permanece na janela e pode gerar um alerta a cada execução.

RecomendaçãoPersistir o último evento ou intervalo alertado e aplicar deduplicação/cooldown. Testar que execuções consecutivas com o mesmo conjunto de `checkout_events` produzem apenas um alerta e que novos erros reabrem o alerta.
Alto

Validação do webhook continua vulnerável a DNS rebinding

security
app/Http/Controllers/Admin/ObservabilityController.php

`saveWebhook()` resolve o host uma vez com `gethostbyname()` e salva a URL para uso posterior. Um domínio pode resolver para IP público durante a validação e para endereço privado quando `sendAlertWebhook()` fizer a requisição. A validação também não demonstra fixação do IP validado nem bloqueio de redirecionamentos no envio.

RecomendaçãoCentralizar a proteção no cliente HTTP que envia o webhook: resolver e validar todos os endereços A/AAAA imediatamente antes da conexão, bloquear faixas privadas/reservadas em cada redirecionamento, desabilitar redirects quando possível e conectar ao IP validado preservando host/SNI. Adicionar testes com resolução pública seguida de privada.
Alto

Listagem de cupons carrega toda a tabela antes de filtrar e paginar

performance
app/Http/Controllers/Admin/CupomAdminController.php

`ClienteCupom::orderBy(...)->get()` materializa todos os cupons; depois o controller agrupa, cria arrays de usuários, filtra e aplica `slice()` em memória. A paginação de 10 itens não limita registros lidos do banco. O mapa de clientes também carrega todos os `cellar_id` encontrados.

RecomendaçãoMover busca, status, agrupamento, contagens e paginação para consultas SQL. Buscar os usuários apenas dos cupons da página atual e criar índices para `cupom`, `cellar_id`, `data_expiracao` e colunas efetivamente usadas pelos filtros.
Médio

Métricas declaradas como globais são alteradas pelo filtro de busca

bug
app/Http/Controllers/Admin/CupomAdminController.php

O filtro de busca modifica `$cuponsCollection` antes do cálculo de `totalCuponsDistintos`, `totalAtribuicoes`, `totalUtilizadosGlobal`, `totalDisponiveisGlobal` e `totalClientesUnicos`. Isso contradiz o comentário `calculadas sobre toda a base antes dos filtros` e faz os cards variarem conforme a pesquisa.

RecomendaçãoCalcular as métricas a partir de uma coleção ou consulta base não filtrada, ou renomear explicitamente os indicadores como métricas do resultado pesquisado. Cobrir pesquisa e status em testes de controller.
Médio

Remover o template ativo pode deixar o sistema sem template ativo

bug
app/Http/Controllers/Admin/MinhaCellarAdminController.php

`destroyTemplate()` exclui qualquer template sem verificar `is_active` ou promover outro. Em `index()`, quando não há ativo mas existem templates, o primeiro é usado apenas como `$currentTemplate`; ele não é atualizado para `is_active = true`. Consumidores que consultem o template ativo continuarão sem resultado.

RecomendaçãoImpedir a remoção do template ativo enquanto houver dependência ou, dentro de transação, promover outro template. Adicionar teste para exclusão do ativo com zero, um e vários templates remanescentes.
Médio

Criação automática de template em requisição GET possui efeito colateral e condição de corrida

reliability
app/Http/Controllers/Admin/MinhaCellarAdminController.php

`index()` chama `MinhaCellarTemplate::create()` quando não encontra registros. Duas requisições simultâneas podem ambas observar a tabela vazia e tentar criar `code = principal`; além disso, apenas abrir a página altera o banco.

RecomendaçãoCriar o template inicial por migration/seeder ou comando idempotente. Se o fallback for mantido, usar transação, restrição única para `code` e tratamento explícito da corrida.
Médio

Erros internos do upload são devolvidos diretamente ao cliente

security
app/Http/Controllers/Admin/StyleAdminController.php

`uploadMedia()` captura qualquer `Throwable` e retorna `$e->getMessage()` na resposta JSON. Exceções do storage podem conter nomes de bucket, caminhos, detalhes de configuração, credenciais indiretas ou mensagens do provedor.

RecomendaçãoRegistrar a exceção no servidor com identificador de correlação e retornar mensagem genérica. Tratar `ValidationException` separadamente para preservar erros de validação seguros, sem expor mensagens das demais exceções.
Médio

Tipo de marketingData pode provocar TypeError ao hidratar o DTO

bug
app/DTOs/OrderFormDTO.php

O construtor declara `public readonly ?string $marketingData`, enquanto `fromArray()` repassa diretamente `$data['marketingData']`. Se o payload fornecer um array ou objeto nessa chave, a construção falha com `TypeError`; outras estruturas do order form já são tipadas como arrays.

RecomendaçãoAlinhar o tipo ao contrato real do payload, provavelmente `?array`, ou criar um DTO específico. Validar o tipo em `fromArray()` e adicionar casos de teste para valor ausente, nulo, array válido e tipo inválido.
Médio

Cadastro de enum aceita grupo inexistente e JSON inválido silenciosamente

reliability
app/Http/Controllers/Admin/EnumAdminController.php

`storeEnum()` valida `group` apenas como string, sem `exists:app_enum_groups,key`. Já `metadata_json` e `metadata_schema_json` são processados com `json_decode`; quando o JSON é inválido, o código simplesmente mantém metadados nulos e conclui a operação com mensagem de sucesso.

RecomendaçãoAdicionar validação de existência do grupo e regra de JSON válido. Verificar `json_last_error()` ou usar a regra `json`, retornando erro 422 em vez de descartar silenciosamente os dados.
Médio

Nível da árvore de categorias é encaminhado sem limite

performance
app/Http/Controllers/Api/CatalogController.php

`getCategoryTree()` converte diretamente `level` para inteiro e chama `getCategoryTree($level)`, sem mínimo ou máximo. Valores negativos ou muito altos são aceitos e encaminhados ao serviço externo, diferentemente de `searchProducts()`, que limita paginação.

RecomendaçãoValidar `level` como inteiro dentro da faixa suportada pela VTEX, aplicando um máximo pequeno e documentado. Criar testes para valores negativos, não numéricos, limite e acima do limite.
Médio

Distribuição de pagamentos omite sucessos sem valor total preenchido

bug
app/Http/Controllers/Admin/ObservabilityController.php

A consulta de distribuição aplica `whereNotNull('total_value_cents')`, embora conte por `payment_method` e não utilize o valor. Checkouts bem-sucedidos com método preenchido e `total_value_cents` nulo entram no total de sucessos, mas desaparecem da distribuição.

RecomendaçãoRemover a condição sobre `total_value_cents` ou documentar que o gráfico representa apenas transações com valor. Adicionar teste comparando a soma da distribuição com a população esperada de sucessos.
Médio

Logout assume que sempre existe token de acesso atual

reliability
app/Http/Controllers/Api/AuthApiController.php

`logout()` executa `$request->user()->currentAccessToken()->delete()` sem verificar retorno nulo. Se o usuário estiver autenticado por mecanismo que não produza um PersonalAccessToken atual, a chamada a `delete()` falha.

RecomendaçãoObter o token em variável, validar sua existência e definir comportamento explícito para autenticação sem token. Cobrir logout autenticado por bearer token, sem autenticação e por outro guard habilitado pela aplicação.
Baixo

Configuração do cron remove indiscriminadamente linhas que contenham o domínio

reliability
.github/workflows/deploy.yml

O deploy filtra o crontab com `grep -Fv "bff.cellarvinhos.com"`. Qualquer outro job legítimo que contenha esse texto será removido, mesmo que não seja o scheduler configurado pelo workflow.

RecomendaçãoAdicionar marcadores exclusivos de início/fim para o bloco gerenciado ou comparar a linha exata do scheduler. Preservar todas as demais entradas do crontab.
Médio

Não há evidência de testes automatizados para os fluxos alterados

testing

Entre os 24 arquivos fornecidos não há arquivos de teste. Permanecem sem cobertura demonstrada os fluxos de cupons, templates, webhook, observabilidade, autenticação, DTOs e validações de catálogo.

RecomendaçãoAdicionar testes unitários e de feature priorizando: deduplicação de alertas, filtros e métricas de cupons, exclusão/ativação de templates, SSRF do webhook, distribuição de pagamentos, hidratação dos DTOs, logout e limites do catálogo. Executar a suíte como etapa obrigatória antes do deploy.