QABot

Revisão técnica assistida por IA

Históricod86cf9d2-082a-4973-87e4-9b68ddce62f7
ANÁLISE SALVA

cellarvinhostechteam/appcellar-bff

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

57/ 100

Análise limitada aos 24 arquivos enviados. A implementação apresenta boas práticas pontuais de validação, tratamento de falhas e redução de N+1, porém há riscos relevantes de segurança e confiabilidade: webhook configurável permite destinos internos, credenciais VTEX são persistidas, o deploy não é atômico, mensagens internas são expostas e a listagem de cupons carrega toda a base em memória. Também foram encontrados indicadores incorretos no painel de cupons/observabilidade e ausência de testes enviados para os fluxos alterados.

Achados 15

24 arquivos analisados

Alto

Webhook configurável pode permitir SSRF e exfiltração de dados

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

saveWebhook aceita qualquer valor aprovado por `nullable|url|max:500`, sem restringir esquema, domínio, IP privado ou loopback. testAlert e resendWebhook encaminham requisições pelo ObservabilityService; resendWebhook inclui e-mail, nome, valor e identificador do pedido.

RecomendaçãoAceitar somente HTTPS, aplicar allowlist de hosts, resolver e bloquear IPs privados/loopback/link-local em todas as resoluções e redirecionamentos, desabilitar redirects ou revalidá-los e registrar auditoria das alterações. Evitar enviar PII desnecessária ao webhook.
Alto

Cookies e tokens de autenticação VTEX são persistidos como dados de sessão recuperáveis

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

validateClassicLogin, validateAccessKey e refreshToken gravam `client_token`, `auth_cookie_value` e `account_auth_cookie_value` em VtexAuthSession. Nenhuma proteção criptográfica, expiração efetiva ou limpeza é demonstrada nos arquivos enviados.

RecomendaçãoAplicar criptografia de atributos no model, restringir acesso à tabela, não registrar esses campos, definir expiração e revogação, remover sessões expiradas e avaliar se os cookies precisam ser persistidos. Adicionar testes que confirmem que valores sensíveis não ficam legíveis no banco ou em logs.
Alto

Deploy pode deixar produção em estado parcialmente atualizado

reliability
.github/workflows/deploy.yml

O fluxo executa `git reset --hard`, `composer install` e `php artisan migrate --force` diretamente no diretório ativo antes de `npm ci` e `npm run build`. Se a instalação ou o build falhar após a migração, banco e código/assets podem ficar em versões incompatíveis. Não há release directory, rollback ou health check.

RecomendaçãoUsar deploy atômico por diretórios versionados e troca de symlink, construir dependências/assets antes da ativação, validar health check e implementar rollback. Classificar migrações destrutivas e garantir compatibilidade entre versões durante a troca.
Médio

Mensagens de exceção internas são devolvidas ao usuário

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

index e show concatenam `$e->getMessage()` em mensagens exibidas nas views. O mesmo padrão aparece em MinhaCellarAdminController::storeTemplate e StyleAdminController::uploadMedia.

RecomendaçãoRetornar mensagens genéricas com um identificador de incidente e registrar a exceção completa apenas no log protegido. Tratar ValidationException separadamente em uploadMedia para não transformar toda falha em vazamento de detalhes internos.
Médio

Listagem de cupons carrega e processa toda a base antes de paginar

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

index executa `ClienteCupom::orderBy(...)->get()`, carrega todos os clientes relacionados com `whereIn`, agrupa e filtra em Collection e somente depois aplica `slice` para mostrar 10 registros.

RecomendaçãoMover agrupamento, busca, métricas e paginação para consultas SQL. Paginar os códigos de cupom primeiro e carregar apenas atribuições/clientes da página atual. Criar índices para `cupom`, `cellar_id`, `data_expiracao` e campos efetivamente pesquisados, conforme o banco suportar.
Médio

Métricas declaradas como globais mudam quando uma busca é aplicada

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

O filtro de busca altera `$cuponsCollection` antes do cálculo de `totalCuponsDistintos`, `totalAtribuicoes`, `totalUtilizadosGlobal`, `totalDisponiveisGlobal` e `totalClientesUnicos`, apesar do comentário afirmar que as métricas são calculadas sobre toda a base antes dos filtros.

RecomendaçãoCalcular métricas globais em uma coleção/consulta separada antes de qualquer filtro ou renomear os indicadores para deixar claro que refletem o resultado pesquisado. Cobrir busca e status combinados com testes.
Médio

Status do scheduler é sempre reportado como ativo

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

getSnapshot define `'scheduler_active' => true` sem verificar execução recente do scheduler. O painel pode indicar operação saudável mesmo quando o cron foi removido ou está falhando.

RecomendaçãoRegistrar heartbeat periódico do scheduler em cache ou banco e considerar ativo somente se o heartbeat estiver dentro de uma tolerância definida. Exibir estado desconhecido quando não houver evidência recente.
Médio

Verificação de saúde pode reenviar alertas idênticos repetidamente

reliability
app/Console/Commands/CheckObservabilityHealthCommand.php

O comando consulta uma janela retroativa e envia alerta sempre que encontra qualquer erro. Não há deduplicação, cooldown ou marcação dos eventos alertados; invocações sucessivas dentro da mesma janela reenviam os mesmos erros.

RecomendaçãoCriar chave de deduplicação por evento/janela, aplicar cooldown e guardar o último evento ou timestamp alertado. Adicionar teste executando o comando duas vezes sobre os mesmos eventos e confirmar apenas um alerta.
Médio

Ativação concorrente pode deixar mais de um template ativo

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

setActiveTemplate e setActiveTemplateSelect desativam os demais e ativam o escolhido dentro de transação, mas não aplicam lock nem há evidência de restrição de unicidade. Duas transações intercaladas podem terminar ativando templates distintos.

RecomendaçãoSerializar a operação com lock pessimista/advisory e, quando suportado, criar restrição no banco garantindo no máximo um template ativo. Adicionar teste concorrente ou de integração para essa invariável.
Médio

Exclusão de grupo e enums não é atômica

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

destroyGroup exclui primeiro os AppEnum associados e depois o AppEnumGroup sem transação. Uma falha entre as operações deixa o grupo existente sem seus valores.

RecomendaçãoExecutar ambas as exclusões em transação e preferir chave estrangeira com cascade quando compatível com a regra de negócio. Testar rollback quando a segunda operação falhar.
Médio

Upload aceita SVG e devolve diretamente a URL do arquivo

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

uploadMedia permite `svg` na regra `mimes` e retorna a URL gerada pelo storage. SVG pode conter conteúdo ativo se for servido inline no mesmo domínio ou em origem confiável pelo navegador.

RecomendaçãoRemover SVG da lista ou sanitizá-lo rigorosamente. Servir uploads em domínio isolado, com Content-Type e Content-Disposition seguros, CSP restritiva e sem cookies da aplicação.
Médio

Distribuição de pagamentos ignora transações bem-sucedidas sem valor preenchido

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

A consulta da distribuição filtra `is_success = true` e também `whereNotNull('total_value_cents')`, embora o agrupamento utilize apenas `payment_method`. Sucessos sem valor ficam fora da distribuição e os totais podem divergir do success_count.

RecomendaçãoRemover o filtro de valor se o indicador representa método de pagamento ou documentar a regra e exibir separadamente a quantidade excluída. Criar teste com sucesso, método preenchido e total_value_cents nulo.
Baixo

Busca de catálogo permite intervalos excessivos ou invertidos

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

searchProducts valida `_from` e `_to` isoladamente até 1000, mas não limita o tamanho da página nem exige `_to >= _from`. Uma chamada pode solicitar intervalo de 0 a 1000 ou encaminhar intervalo invertido ao provedor.

RecomendaçãoValidar `_to >= _from`, impor tamanho máximo de página e rejeitar listas vazias para tipos sku/ids. Adicionar testes nos limites e no intervalo invertido.
Baixo

Falha no cd ocorre antes da ativação de set -e

reliability
.github/workflows/deploy.yml

O script executa `cd /www/wwwroot/bff.cellarvinhos.com` antes de `set -e`. Se o diretório não existir, o script continua inicialmente no diretório anterior.

RecomendaçãoColocar `set -Eeuo pipefail` como primeira instrução e usar `cd /www/wwwroot/bff.cellarvinhos.com || exit 1`. Validar explicitamente o remote e a branch antes do reset.
Médio

Não foram enviados testes automatizados para os fluxos alterados

testing

Entre os 24 arquivos fornecidos não há testes para listagem e métricas de cupons, autenticação VTEX, builder destrutivo, observabilidade, uploads ou deploy.

RecomendaçãoAdicionar testes de feature e integração cobrindo autorização, filtros e métricas de cupons, proteção de segredos, SSRF, deduplicação de alertas, rollback transacional, concorrência de templates, sanitização de upload e falhas intermediárias do deploy.