QABot

Revisão técnica assistida por IA

Histórico971ac9dc-3dea-43c8-91f8-105ad0ae59f7
ANÁLISE SALVA

cellarvinhostechteam/appcellar-bff

meus-cupons-impl · 29 de outubro de 2026 às 21:03 · gpt-5.6-sol

52/ 100

A implementação apresenta boas práticas pontuais de validação, transações e redução de N+1, mas há riscos relevantes de confiabilidade, segurança e escalabilidade. O problema mais imediato é o saveBuilder aceitar campos opcionais e acessá-los como obrigatórios, produzindo erro 500. Também há operações destrutivas aceitas com payload vazio, persistência e carregamento amplo de credenciais VTEX, possibilidade de SSRF pelo webhook, listagem de cupons totalmente em memória e deploy não atômico. Nos 24 arquivos enviados não há testes automatizados cobrindo os fluxos alterados.

Achados 15

24 arquivos analisados

Alto

saveBuilder acessa campos opcionais inexistentes e pode retornar erro 500

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

A validação declara background_color, bg_color, title_color, subtitle_color e icon_color como nullable, portanto eles podem estar ausentes do payload validado. Depois, o código acessa diretamente $payload['background_color'], $modData['bg_color'], $modData['title_color'], $modData['subtitle_color'] e $modData['icon_color']. Uma requisição válida que omita qualquer um desses campos gera "Undefined array key" no Laravel.

RecomendaçãoTrocar todos os acessos opcionais por coalescência, por exemplo ($payload['background_color'] ?? null) ?: '#F8F9FA' e ($modData['bg_color'] ?? null) ?: '#FFFFFF'. Adicionar teste de integração enviando somente os campos obrigatórios.
Alto

Cookies e tokens de autenticação VTEX são persistidos diretamente

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

validateClassicLogin e validateAccessKey enviam clientToken, authCookie.Value e accountAuthCookie.Value diretamente para VtexAuthSession::updateOrCreate. refreshToken também atualiza esses mesmos segredos. Nos arquivos enviados não há evidência de criptografia antes da persistência.

RecomendaçãoGarantir criptografia em repouso com casts encrypted no model ou mecanismo equivalente, restringir acesso às colunas e definir expiração/remoção das sessões. Criar teste que confirme que o valor armazenado não coincide com o segredo recebido.
Alto

Configuração de webhook aceita destinos internos e permite SSRF

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

saveWebhook valida webhook_url apenas com nullable|url|max:500 e o valor é posteriormente usado por sendAlertWebhook. Assim, URLs HTTP válidas apontando para localhost, endereços privados ou serviços de metadados passam pela validação e podem receber requisições do servidor.

RecomendaçãoPermitir somente HTTPS e, preferencialmente, hosts explicitamente autorizados. Após resolver DNS, rejeitar loopback, link-local, redes privadas e redirecionamentos para esses destinos. Testar IPv4, IPv6, nomes que resolvem para IP privado e redirecionamentos.
Alto

Deploy altera produção de forma não atômica e pode deixar versão parcialmente implantada

reliability
.github/workflows/deploy.yml

O workflow executa git reset diretamente no diretório ativo, instala dependências, roda migrações, limpa caches e somente depois executa npm ci e npm run build. Se a instalação ou o build falhar após o reset ou após a migração, o servidor permanece com combinação parcial de código, banco, dependências e assets.

RecomendaçãoConstruir e testar uma release em diretório separado, executar composer com --no-dev em produção, gerar assets antes da troca e alternar um symlink somente após sucesso. Definir estratégia de rollback e compatibilidade retroativa para migrações.
Médio

Payload vazio do builder apaga todas as seções e módulos

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

A regra sections é apenas present|array, portanto sections: [] é válida. Nesse caso keptSectionIds e keptModuleIds ficam vazios e as consultas whereNotIn(..., []) removem todos os módulos e todas as seções do template dentro da transação.

RecomendaçãoSe um template vazio não for permitido, usar sections => present|array|min:1. Se a limpeza total for um recurso, exigir uma flag explícita de confirmação, controle de versão otimista e teste específico para impedir exclusão acidental por payload incompleto.
Médio

Administração de cupons carrega toda a base e processa busca, métricas e paginação em memória

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

ClienteCupom::orderBy(...)->get() carrega todos os registros. Em seguida, todos os cellar_id são carregados, os cupons são agrupados e filtrados em Collections e somente no final é aplicado slice para dez itens. O consumo de memória e tempo cresce com toda a tabela, independentemente da página exibida.

RecomendaçãoMover agrupamento, filtros e agregações para consultas SQL e paginar antes de carregar detalhes. Buscar clientes apenas para os cupons da página. Adicionar teste de desempenho com volume representativo e limite de consultas/memória.
Médio

Expiração do cupom é determinada apenas pelo primeiro registro do grupo

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

Os registros são agrupados somente por cupom e $primeiro = $items->first() fornece data_expiracao, título, descrição e regras para todo o grupo. Como a consulta está ordenada por data_expiracao ascendente, um registro antigo expirado pode classificar todo o cupom como expirado mesmo que outras atribuições do mesmo código tenham validade diferente.

RecomendaçãoDefinir e impor a invariável de que metadados e expiração são únicos por código. Caso a expiração seja por atribuição, calcular o status por registro ou usar a regra de negócio apropriada, como MAX(data_expiracao). Criar teste com o mesmo código e datas de expiração divergentes.
Médio

Métricas chamadas de globais mudam conforme busca e filtro de status

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

totalCuponsDistintos, totalAtribuicoes, totalUtilizadosGlobal, totalDisponiveisGlobal e totalClientesUnicos são calculados depois que cuponsCollection é filtrada por search e status. Portanto, pesquisar um cliente ou selecionar expirados altera os totais apresentados como métricas globais.

RecomendaçãoCalcular métricas globais antes dos filtros ou renomeá-las claramente como métricas do resultado filtrado. Se ambos forem necessários, retornar dois conjuntos distintos e cobrir o comportamento com testes.
Médio

refreshToken carrega todas as sessões de autenticação para localizar um cookie

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

Quando não encontra a sessão por user_id, o código executa VtexAuthSession::all()->first(...) e materializa todas as sessões, incluindo seus tokens e cookies, para comparar auth_cookie_value em PHP. O custo de memória e tempo cresce linearmente com a tabela e expõe desnecessariamente todos os segredos ao processo da requisição.

RecomendaçãoConsultar diretamente com where('auth_cookie_value', $authCookie)->first(). Preferencialmente armazenar também um identificador ou hash indexado para localização, mantendo o valor utilizável criptografado. Adicionar índice e teste que confirme consulta limitada a uma sessão.
Médio

Painel informa scheduler ativo sem verificar seu estado

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

getSnapshot retorna scheduler_active => true de forma constante. Consequentemente, o painel continuará indicando scheduler ativo mesmo se o cron tiver sido removido, estiver falhando ou nunca tiver executado.

RecomendaçãoRegistrar heartbeat a cada execução do scheduler e considerar ativo somente quando o heartbeat estiver dentro de uma janela definida. Testar estados saudável, atrasado e inexistente.
Médio

Criação de grupo normaliza a chave somente após validar unicidade

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

storeGroup valida unique:app_enum_groups,key sobre o valor original e só depois executa strtolower(trim($validated['key'])). Entradas como "FOO" ou " foo " podem passar pela validação contra uma chave existente "foo" e falhar posteriormente na restrição única do banco, sem tratamento local.

RecomendaçãoNormalizar key com prepareForValidation em um FormRequest ou com merge antes de validate. Manter a constraint única no banco e tratar UniqueConstraintViolationException como erro 422 amigável. Testar diferenças de caixa e espaços.
Médio

Mensagens internas de exceção são devolvidas à interface administrativa

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

index e show concatenam $e->getMessage() nas mensagens enviadas às views ou à sessão. Exceções de banco podem conter nomes de tabelas, colunas, conexão e trechos de SQL.

RecomendaçãoRegistrar a exceção no servidor com identificador de correlação e mostrar mensagem genérica ao usuário. Aplicar o mesmo padrão ao uploadMedia de StyleAdminController, que também retorna $e->getMessage() no JSON.
Médio

Erros 4xx da VTEX são refletidos diretamente para o consumidor da API

security
app/Exceptions/VTEXAPIException.php

render oculta a mensagem apenas para status >= 500. Para códigos entre 400 e 499, retorna diretamente $this->getMessage(), que pode conter detalhes fornecidos pelo serviço externo ou pelo cliente HTTP.

RecomendaçãoMapear erros conhecidos para mensagens públicas controladas e registrar a mensagem original apenas em logs protegidos, com correlation ID. Não refletir corpo ou diagnóstico bruto do provedor.
Médio

Fluxos críticos alterados não possuem testes no conjunto enviado

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

Entre os 24 arquivos enviados não há arquivos de teste para cupons, saveBuilder, autenticação VTEX, observabilidade ou deploy. Casos como campos opcionais ausentes, exclusão por sections vazio, expirações divergentes e normalização de chaves ficam sem proteção contra regressão.

RecomendaçãoAdicionar testes feature para controllers, testes de autorização e segurança, testes de integração para persistência criptografada e testes de volume para cupons. Incluir execução obrigatória da suíte e análise estática antes do deploy.
Baixo

Fallback de cliente cria nome e e-mail que parecem dados reais

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

Quando Client não é encontrado, o controller produz "Cliente #<id>" e "cliente.<id>@cellar.com.br". O e-mail sintético não é identificado como indisponível e pode ser interpretado ou copiado como dado real.

RecomendaçãoExibir marcadores inequívocos, como "Cliente não encontrado" e null/"E-mail indisponível", sem fabricar endereço em domínio real. Diferenciar falha de consulta da inexistência do cliente e registrar a ocorrência.