QABot

Revisão técnica assistida por IA

Histórico9e47e244-b3de-450f-8b2f-cb547acd70bc
ANÁLISE SALVA

cellarvinhostechteam/appcellar-bff

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

57/ 100

A amostra apresenta boas práticas de validação, transações e tratamento genérico de erros nas APIs, mas contém riscos relevantes de escalabilidade, deploy não atômico e persistência de credenciais de sessão. O principal problema da implementação de cupons é carregar toda a base antes de filtrar e paginar. Também foram identificados erros reproduzíveis de perda silenciosa de metadados, classificação incorreta de pagamentos e exposição de mensagens internas. A ausência de testes entre os arquivos enviados reduz a confiança nas mudanças.

Achados 11

24 arquivos analisados

Alto

Listagem de cupons carrega e processa toda a base em memória antes da paginação

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

O método executa `$query->get()`, extrai todos os `cellar_id`, carrega todos os clientes com `whereIn`, agrupa os registros, aplica busca e status em Collections e somente depois usa `slice` para mostrar 10 itens. O consumo de memória, tempo de CPU e quantidade de parâmetros do `whereIn` crescem com toda a tabela, independentemente da página solicitada.

RecomendaçãoMover agrupamento, busca, status e paginação para consultas SQL. Paginar os cupons distintos primeiro e carregar apenas as atribuições e clientes dos códigos presentes na página. Adicionar teste de desempenho com uma base representativa e verificar o limite de memória e o número de consultas.
Alto

Falha no deploy pode reativar uma versão parcialmente instalada

reliability
.github/workflows/deploy.yml

O workflow altera diretamente o diretório em produção, executa `git reset`, instala dependências e roda migrações antes do build. O `trap 'php artisan up || true' EXIT` reativa a aplicação mesmo quando `composer install`, `migrate`, `npm ci` ou `npm run build` falham. Nesse cenário, código, banco, dependências e assets podem ficar em versões incompatíveis.

RecomendaçãoAdotar deploy atômico por diretórios de release e troca de symlink somente após dependências, build e smoke test concluírem. Executar migrações compatíveis com versões anterior e nova, adicionar lock contra deploys concorrentes e não reativar automaticamente uma release que não passou na validação.
Médio

Credenciais e cookies de autenticação VTEX são persistidos diretamente a partir da resposta externa

security
app/Http/Controllers/Api/AuthenticationController.php

`validateClassicLogin`, `validateAccessKey` e `refreshToken` gravam `clientToken`, `authCookie.Value` e `accountAuthCookie.Value` em `VtexAuthSession`. Esses valores representam credenciais reutilizáveis. Nos arquivos enviados não há evidência de minimização, expiração local ou criptografia antes da atribuição ao modelo.

RecomendaçãoEvitar persistir cookies quando não forem estritamente necessários. Quando necessários, usar casts criptografados no modelo, restringir acesso às colunas, eliminar valores vencidos com base em `expiresIn` e garantir que nunca sejam serializados, exibidos ou registrados em logs. Criar teste que confirme que os valores armazenados não aparecem em texto legível no banco.
Médio

Atualização de enum pode apagar metadados quando recebe JSON inválido

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

`storeEnum` valida `metadata_json` com `nullable|json`, mas `updateEnum` não valida esse campo. Na atualização, um `metadata_json` inválido faz `json_decode` retornar valor não-array e, em seguida, `$validated['metadata']` é definido como `null`, apagando silenciosamente os metadados existentes.

RecomendaçãoAdicionar `metadata_json => nullable|json` à validação de `updateEnum`. Não alterar `metadata` quando o campo não for enviado e rejeitar explicitamente JSON inválido. Cobrir atualização sem o campo, com JSON válido e com JSON malformado.
Médio

Status PIX pode ser reportado como cancelado sem evidência de cancelamento

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

`getPixStatus` considera somente `$vtexData[0]`. Para `rawStatus === 'finished'`, quando não encontra campos de cancelamento nem autorização, define o resultado como `canceled`. Assim, uma resposta finalizada mas inconclusiva, ou uma transação cujo pagamento relevante não seja o primeiro elemento, pode ser exibida como cancelada.

RecomendaçãoAvaliar todos os pagamentos e selecionar o pagamento PIX ou o identificador correspondente à transação consultada. Para `finished` sem evidência conclusiva, retornar `waiting` ou um estado `unknown`, em vez de inferir cancelamento. Adicionar testes para múltiplos pagamentos, `finished` autorizado, cancelado e inconclusivo.
Médio

Mensagens internas de banco são exibidas diretamente no painel administrativo

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

Nos blocos `catch`, `index` monta `Erro ao consultar tabela: ` com `$e->getMessage()` e `show` inclui a mesma mensagem em flash. Exceções de banco podem revelar nomes de tabelas, colunas, host, driver ou detalhes da consulta.

RecomendaçãoRegistrar a exceção internamente com um identificador de correlação e retornar ao usuário uma mensagem genérica. Aplicar o mesmo padrão aos demais controladores que concatenam `$e->getMessage()` em respostas ou mensagens de sessão.
Médio

Remoção do template ativo não é atômica

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

`destroyTemplate` ativa outro template com `update` e depois exclui o atual, sem transação. Se a exclusão falhar, os dois podem permanecer ativos. Também há janela de concorrência entre a escolha do substituto, sua ativação e a exclusão.

RecomendaçãoExecutar seleção do substituto, ativação e exclusão em uma única transação, usando bloqueio das linhas relevantes. Reforçar no banco a invariável de apenas um template ativo quando o banco utilizado permitir.
Médio

Validação anti-SSRF do webhook é vulnerável a troca de DNS entre validação e envio

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

`saveWebhook` resolve o host uma única vez com `gethostbyname` e salva a URL original. O envio posterior usa novamente o hostname por meio de `sendAlertWebhook`. Um domínio controlado pode resolver para IP público durante a validação e depois para IP privado, além de `gethostbyname` verificar apenas resolução IPv4 individual.

RecomendaçãoAplicar a validação de destino imediatamente antes de cada conexão, resolver todos os registros A e AAAA, rejeitar qualquer endereço privado, reservado, link-local ou de metadata e impedir redirecionamentos para destinos não permitidos. Preferencialmente usar allowlist de provedores de webhook conhecidos.
Médio

Não há testes enviados para os fluxos críticos alterados

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

Entre os 24 arquivos fornecidos não há arquivos de teste, apesar de existirem fluxos de cupons, autenticação, persistência de sessão, alteração destrutiva de templates, webhooks e normalização de status de pagamento.

RecomendaçãoAdicionar testes de integração para filtros e paginação de cupons, isolamento de IDs no builder, transações de templates, JSON inválido de enums, SSRF de webhook, múltiplos pagamentos PIX e armazenamento seguro das sessões VTEX. Incluir esses testes como etapa obrigatória anterior ao deploy.
Baixo

Action de deploy é referenciada por tag mutável em vez de commit imutável

security
.github/workflows/deploy.yml

O workflow usa `appleboy/ssh-action@v1.2.0`. Tags podem ser alteradas no repositório de origem, fazendo o workflow executar código diferente sem mudança neste repositório.

RecomendaçãoFixar a action pelo SHA completo de um commit revisado e usar ferramenta automatizada para propor atualizações controladas da dependência.
Baixo

Login cria um novo token a cada autenticação sem política de substituição visível

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

Cada chamada bem-sucedida de `login` executa `createToken('api-token')`. O logout remove apenas `currentAccessToken`; não há neste controlador limite, revogação dos tokens anteriores ou diferenciação por dispositivo.

RecomendaçãoDefinir explicitamente a política de sessões: revogar token anterior quando só uma sessão for permitida ou registrar nome/dispositivo e limitar tokens ativos por usuário. Configurar expiração e testar login repetido, logout e revogação.