QABot

Revisão técnica assistida por IA

Histórico90224df9-a726-4273-9d4c-811936b52b35
ANÁLISE SALVA

cellarvinhostechteam/appcellar-bff

meus-cupons-impl · 29 de outubro de 2026 às 20:14 · gpt-5.6-sol

48/ 100

Score 48/100. Há um defeito funcional direto na consulta de status PIX, métricas de observabilidade incorretas acima de 100 eventos, riscos de segurança no deploy e no armazenamento de credenciais VTEX, além de consultas não escaláveis na administração de cupons. A implementação possui validações úteis e transação no builder, mas os caminhos críticos apresentados não vieram acompanhados de testes automatizados.

Achados 15

24 arquivos analisados

Alto

Status PIX ignora completamente a resposta retornada pela VTEX

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

Em getPixStatus(), o resultado é atribuído a `$vtexData`, mas o pagamento é lido de `$payments[0]`. `$payments` nunca é definido no método. O operador `??` evita erro fatal, porém `$payment` fica sempre vazio e o endpoint retorna `waiting`, mesmo para pagamentos aprovados ou cancelados.

RecomendaçãoNormalizar e ler a estrutura de `$vtexData`, por exemplo `$payment = $vtexData[0] ?? []`, após validar que o retorno é um array. Criar testes para approved, canceled, finished com autorização, finished com cancelamento, retorno vazio e erro do serviço.
Alto

Deploy de produção executa action não fixada e aplica permissões 777

security
.github/workflows/deploy.yml

O workflow usa `appleboy/ssh-action@master`, permitindo que mudanças futuras na branch do terceiro sejam executadas no pipeline. Também executa `chmod -R 777 storage bootstrap/cache`, concedendo escrita a qualquer usuário do servidor nessas árvores.

RecomendaçãoFixar a action por SHA de commit revisado e substituir 777 por proprietário/grupo específicos do processo web, com permissões mínimas como 775 ou 750 conforme a necessidade.
Alto

Cookies e tokens de autenticação VTEX são enviados diretamente para persistência

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

validateClassicLogin() e validateAccessKey() persistem `clientToken`, `authCookie.Value` e `accountAuthCookie.Value` em VtexAuthSession. refreshToken() também consulta por `auth_cookie_value`. Não há proteção, redução ou criptografia visível neste código antes da persistência desses segredos reutilizáveis.

RecomendaçãoAplicar criptografia em repouso nos atributos sensíveis, evitar usar o cookie bruto como chave de busca e armazenar somente o mínimo necessário. Preferir hash para identificadores pesquisáveis e separar a chave de criptografia do banco. Adicionar testes que garantam que valores brutos não sejam persistidos nem serializados.
Alto

KPIs de observabilidade contabilizam no máximo 100 eventos do período

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

getSnapshot() executa `forPeriod($period)->orderByDesc('created_at')->limit(100)->get()` e calcula `total_attempts`, sucessos, erros, conversão, duração média e distribuição de pagamentos exclusivamente sobre essa coleção. Assim, períodos com mais de 100 eventos exibem totais e taxas referentes apenas aos 100 mais recentes.

RecomendaçãoCalcular KPIs com agregações SQL sobre todo o período e buscar separadamente uma lista limitada para a tabela. Testar períodos com 0, 100 e mais de 100 eventos, incluindo situações em que os eventos antigos alterem a taxa de erro.
Médio

Listagem de cupons carrega toda a tabela e executa uma consulta de cliente por atribuição

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

index() usa `ClienteCupom::orderBy(...)->get()`, agrupando, filtrando e paginando em memória. Dentro de `$items->map()`, executa `Client::where('cellar_id', $item->cellar_id)->first()` para cada atribuição, caracterizando N+1 consultas. A paginação para 10 cupons ocorre somente depois de todo o processamento.

RecomendaçãoMover filtros, agrupamento e paginação para o banco e carregar clientes em lote por `cellar_id` ou por relacionamento/eager loading. Criar um teste de consultas ou benchmark com grande quantidade de cupons e clientes.
Médio

Ativar ID de template inexistente desativa previamente todos os templates

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

setActiveTemplate() primeiro executa `MinhaCellarTemplate::query()->update(['is_active' => false])` e somente depois chama `findOrFail($id)`. Para um ID inexistente, o método responde 404 depois de deixar todos os templates inativos.

RecomendaçãoBuscar o template antes de alterar os demais e realizar desativação/ativação dentro de uma transação. Considerar uma restrição de banco que assegure a regra de template ativo e testar ID inexistente e ativações concorrentes.
Médio

Builder ignora o margin_bottom recebido e validado

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

saveBuilder() valida `sections.*.margin_bottom`, mas ao salvar define `$section->margin_bottom = (int) ($template->section_spacing ?? 16)`. Portanto, qualquer valor individual enviado em `margin_bottom` é descartado silenciosamente.

RecomendaçãoPersistir `$secData['margin_bottom']` com o fallback desejado, ou remover o campo da API se ele não deveria ser configurável. Adicionar teste de round-trip com margens diferentes entre seções.
Médio

Alerta de saúde limita a consulta e reporta contagem potencialmente falsa

reliability
app/Console/Commands/CheckObservabilityHealthCommand.php

A consulta aplica `limit(10)` antes de calcular `$errorCount = $recentErrors->count()`. Se houver 50 erros no período, a mensagem e o título do webhook informarão somente 10 erros recentes, sem indicar que o resultado foi truncado.

RecomendaçãoExecutar um `count()` separado sobre todo o período e buscar apenas os 10 registros para exibição. Informar explicitamente que os detalhes são uma amostra. Validar também que `--minutes` seja maior que zero.
Médio

Normalização da feature flag acontece depois da validação de unicidade

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

store() valida a chave original com `unique:feature_flags,key` e depois a transforma com `strtoupper(str_replace(' ', '_', ...))`. Por exemplo, `foo bar` pode passar na validação mesmo quando `FOO_BAR` já existe e falhar posteriormente na restrição do banco, normalmente como erro 500.

RecomendaçãoNormalizar a chave antes da validação, usando prepareForValidation em um FormRequest ou alterando o input antes de chamar validate. Manter a restrição única no banco e testar colisões por caixa e espaços.
Médio

Endpoints de autenticação VTEX não validam entradas obrigatórias

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

Métodos como validateClassicLogin(), sendAccessKey(), validateAccessKey(), setPassword() e refreshToken() obtêm campos via `input()` e os encaminham ao serviço sem `validate()`. Campos ausentes, e-mails inválidos e senhas nulas chegam à integração e tendem a produzir erro remoto ou 500 em vez de uma resposta 422 previsível.

RecomendaçãoAdicionar validação explícita por endpoint, incluindo email, tamanho de senha/chave, authenticationToken, locale e fingerprint. Cobrir campos ausentes, tipos inválidos e limites de tamanho em testes de API.
Médio

Mensagens internas de exceção são devolvidas diretamente aos clientes

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

Todos os blocos catch retornam `['error' => $e->getMessage()]` com status 500. Mensagens de serviços HTTP, banco ou configuração podem revelar URLs, detalhes do provedor e informações operacionais.

RecomendaçãoRegistrar a exceção internamente com identificador de correlação e retornar mensagem genérica ao cliente. Mapear erros esperados da VTEX para códigos 4xx/5xx estáveis sem expor detalhes internos.
Médio

Exceção VTEX usa qualquer código de exceção como status HTTP

reliability
app/Exceptions/VTEXAPIException.php

render() passa `$this->getCode() ?: 500` diretamente como status da resposta. Códigos de exceção não são necessariamente códigos HTTP válidos; valores como 1, negativos ou acima de 599 podem produzir resposta inválida. A mensagem interna também é exposta integralmente.

RecomendaçãoAceitar ou mapear somente códigos HTTP entre 400 e 599, usando 502 como padrão para falhas do provedor. Retornar mensagem pública controlada e manter detalhes apenas nos logs.
Médio

Busca de catálogo aceita parâmetros inválidos e os converte em erro 500

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

searchProducts() não valida `type`, `value`, `_from` ou `_to`. Nos tipos `sku` e `ids`, executa `explode(',', $value)`; com value ausente, isso pode gerar TypeError, que não é capturado pelo `catch (\Exception $e)` em versões atuais do PHP, pois TypeError implementa Throwable.

RecomendaçãoValidar `type`, exigir `value`, limitar intervalo e quantidade de IDs e capturar somente falhas esperadas após a validação. Retornar 422 para entrada inválida e testar value ausente, intervalos negativos e listas excessivas.
Médio

Deploy não é atômico e instala dependências de frontend sem lock estrito

reliability
.github/workflows/deploy.yml

O workflow altera diretamente o diretório em uso, executa migrações antes da conclusão do build e usa `npm install`. Uma falha posterior à migração ou durante o build pode deixar código, banco, assets e caches em estados incompatíveis. `npm install` também pode alterar a resolução em comparação ao lockfile.

RecomendaçãoConstruir uma release separada, usar `npm ci`, validar aplicação/build antes da troca de symlink e definir estratégia de rollback compatível com migrações. Colocar a aplicação em manutenção quando necessário e não modificar diretamente a release ativa.
Médio

Alterações críticas apresentadas não incluem testes automatizados

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

Entre os 24 arquivos fornecidos não há arquivos de teste para status PIX, métricas acima de 100 eventos, ativação de templates, builder, cupons ou autenticação VTEX. O uso da variável inexistente `$payments` é um exemplo de regressão que um teste simples de endpoint detectaria.

RecomendaçãoAdicionar testes de feature e unidade para os fluxos citados, priorizando getPixStatus, getSnapshot, setActiveTemplate, saveBuilder, normalização de chaves e validação dos endpoints VTEX. Incluir execução obrigatória dos testes no workflow antes do deploy.