Scale Check — Auditoria de Prontidão para Produção em 7 Pontos
Você está executando /scale-check no modo plano somente leitura. Sua tarefa é inspecionar a base de código com base nas 7 perguntas de escalabilidade abaixo e apresentar um plano de verificação e correção claro e priorizado na tela do usuário.
Escopo Alvo: $ARGUMENTS (Se vazio, audite todo o repositório).
Regras de Ferro (Leia Antes de Escanear)
- Olhe, não altere: Você está estritamente em modo de diagnóstico e planejamento. NÃO crie, edite ou exclua nenhum arquivo. NÃO execute migrações de banco de dados, comandos que alteram estado ou requisições de rede.
- Descobertas são pistas para verificar, não fatos: A análise estática do repositório não pode ver painéis de nuvem externos, regras de CDN, políticas de WAF ou configurações de banco de dados gerenciados. Enquadre cada problema que você encontrar como uma pista para verificar, nunca como um bug garantido.
- Sempre cite localizações exatas: Cada pista de código deve incluir
caminho/para/arquivo:linhae o símbolo ou consulta específica envolvida. Se algo estiver faltando na base de código, reporte explicitamente: "Não encontrado no repositório — verifique em seu provedor de hospedagem/nuvem." - Corrija um de cada vez, começando pela sobrevivência: Ordene o plano de remediação final sempre começando por Backups (Questão 5) e Limites de Taxa (Questão 7), depois qualquer vazamento de dados privados através de um cache compartilhado (Questão 6), e então as questões restantes na ordem em que geralmente afetam um aplicativo em crescimento: índices e loops (Q1), leituras compartilhadas (Q2), execução como duas cópias (Q3), trabalho lento em requisições (Q4) e cache de ativos públicos (o restante da Q6).
Fluxo de Trabalho de Execução
Fase 1: Identifique a Stack (Passagem Rápida)
Antes de verificar as 7 perguntas, identifique rapidamente a stack do projeto para que você procure nos lugares certos:
- Manifestos e Frameworks: Verifique
package.json,pyproject.toml,requirements.txt,go.mod,Cargo.tomlouGemfile. - Banco de Dados e ORM: Localize
schema.prisma, arquivos de esquema Drizzle, modelos TypeORM/Sequelize, arquivos SQLAlchemy/Alembic, Djangomodels.pyou migrações.sqlbrutas. - Entrypoints e Rotas: Localize rotas de API (
app/api/,pages/api/,src/routes/,controllers/,routers/,main.py,cmd/). - Infraestrutura e Configuração: Verifique
Dockerfile,docker-compose.yml,vercel.json,next.config.*,fly.toml,render.yaml,nginx.conf,.github/workflows/eREADME.md.
Fase 2: Investigue Todas as 7 Perguntas
Execute passagens direcionadas de Glob, Grep e Read para cada uma das 7 perguntas abaixo. Não pule nenhuma pergunta.
As 7 Perguntas
Questão 1: Índices e Consultas Dentro de Loops
- Forma Curta do Cartão: "Páginas que pesquisam ou listam dados: as colunas são indexadas e há alguma consulta dentro de um loop?"
- Pergunta de Diagnóstico Completa: Onde o aplicativo lista, filtra, ordena ou pesquisa registros, as colunas de banco de dados subjacentes (
WHERE,JOIN,ORDER BY, chaves estrangeiras) são suportadas por índices no esquema, e algum endpoint executa uma consulta de banco de dados ou API dentro de um loop (o problema N+1) ou busca linhas ilimitadas sem paginação? - Onde e Como Procurar:
- Esquema vs. Consultas: Compare consultas de lista/pesquisa (
findMany,select,filter,WHERE,ILIKE,ORDER BY) com definições de índice (@@index,index(),CREATE INDEX,db_index=True). Observe que Prisma/SQLAlchemy frequentemente não indexam automaticamente chaves estrangeiras ou colunas de ordenação, a menos que explicitamente declarado. - Loops com E/S: Pesquise em manipuladores de rota e funções de serviço por
for (,for await,.map(async,forEach(asyncou compreensões de lista que chamamdb.,prisma.,supabase.,session.executeoufetch(dentro do corpo da iteração. - Leituras Ilimitadas: Verifique se os endpoints de lista impõem um limite
take/limitou se uma única requisição pode carregar uma tabela inteira na memória.
- Esquema vs. Consultas: Compare consultas de lista/pesquisa (
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
- Índices podem ter sido criados manualmente em consoles de produção SQL sem serem commitados em arquivos de migração.
- Pequenas tabelas de consulta (por exemplo, <50 funções ou categorias estáticas) não causarão gargalos com um índice ausente, embora loops N+1 sobre dados gerados pelo usuário causarão.
Questão 2: Leituras Compartilhadas Repetidas
- Forma Curta do Cartão: "Consultas de leitura que são executadas com frequência e retornam o mesmo resultado para todos."
- Pergunta de Diagnóstico Completa: Quais consultas de leitura de alto tráfego computam ou buscam exatamente os mesmos dados públicos para cada visitante em cada requisição — como feeds de página inicial, catálogos de produtos, configuração global, leaderboards ou contagens públicas — sem armazenar o resultado em cache na memória, Redis/KV ou no cache de dados do framework?
- Onde e Como Procurar:
- Inspecione rotas públicas, homepages, carregadores de layout e middlewares globais que acessam o banco de dados primário em cada carregamento de página sem parâmetros específicos do usuário (
userId,sessionId,orgId). - Verifique agregações caras (
COUNT(*),SUM(), joins de múltiplas tabelas) sendo executadas ao vivo em endpoints públicos. - Procure por primitivas de cache existentes (
unstable_cache,'use cache',revalidate, Redisget/set,@lru_cache,Cache-Control: s-maxage) para ver se as leituras compartilhadas já estão encapsuladas.
- Inspecione rotas públicas, homepages, carregadores de layout e middlewares globais que acessam o banco de dados primário em cada carregamento de página sem parâmetros específicos do usuário (
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
- Um CDN upstream (Cloudflare, CloudFront, Fastly) pode já estar armazenando em cache rotas públicas completas na borda por meio de regras de página do painel.
Questão 3: Executando como Duas Cópias (Ausência de Estado e Armazenamento Local)
- Forma Curta do Cartão: "O aplicativo poderia ser executado como duas cópias, e o que vive na memória de um servidor ou em seu disco?"
- Pergunta de Diagnóstico Completa: Se o tráfego aumentar e você iniciar uma segunda instância do servidor atrás de um balanceador de carga (ou implantar em instâncias serverless de escalonamento automático), o que quebra porque o estado é armazenado na RAM de um único processo ou escrito no sistema de arquivos local de um único contêiner?
- Onde e Como Procurar:
- Estado de Memória Intraprocesso: Pesquise por
new Map(),new Set()em nível de módulo, arrays/objetos mutáveis globais, stores de sessão em memória (MemoryStore), contadores de limite de taxa locais, ou pub/sub intraprocesso (EventEmitter,Sets de WebSocket não conectados) que assumem que todos os usuários atingem o mesmo processo Node/Python/Go. - Dependência de Disco Local: Pesquise por escritas em arquivos locais (
fs.writeFile,fs.createWriteStream,open(..., 'w'),multer.diskStorage, armazenamento/tmpou./uploads) e bancos de dados locais embutidos (sqlite,better-sqlite3, arquivos.db) usados para dados de tempo de execução mutáveis. - Tarefas Agendadas Intraprocesso: Verifique se há
node-cron,setIntervalouAPScheduleriniciados dentro do entrypoint principal do servidor web, o que dispararia tarefas duplicadas se duas instâncias forem executadas simultaneamente.
- Estado de Memória Intraprocesso: Pesquise por
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
Maps em nível de módulo usados estritamente como caches somente leitura com um TTL (ou clientes SDK singleton lazy como Prisma/Stripe) são seguros em várias instâncias.- Aplicativos single-VPS usando um volume persistente montado e sessões sticky podem intencionalmente ser executados como um único nó — sinalize claramente a troca em vez de chamá-lo de quebrado.
Questão 4: Trabalho Síncrono Lento Dentro de Requisições Web
- Forma Curta do Cartão: "Em qualquer lugar onde uma requisição web faz algo lento, como uma chamada de IA, um e-mail ou um arquivo."
- Pergunta de Diagnóstico Completa: Onde uma requisição HTTP mantém a conexão do usuário aberta enquanto espera por trabalho lento, imprevisível ou pesado — como uma chamada de geração LLM/IA, envio de e-mails transacionais, geração de PDFs, redimensionamento de imagens/vídeos, análise de grandes CSVs ou encadeamento de múltiplos webhooks de terceiros — antes de retornar uma resposta?
- Onde e Como Procurar:
- Rastreie controladores
POST/PUT, Server Actions e manipuladores de webhook do início da requisição até o retorno da resposta. - Pesquise por chamadas
awaitbloqueantes para SDKs de IA (openai,@anthropic-ai,@google/genai,ai), provedores de e-mail (resend,nodemailer,sendgrid,postmark), processadores de mídia/arquivo (sharp,ffmpeg,puppeteer,pdfkit) ou APIs externas dentro do caminho crítico da requisição. - Verifique se o projeto tem uma fila de segundo plano ou configuração de worker assíncrono (
bullmq,inngest,trigger.dev,celery,sidekiq,waitUntil) e se as chamadas lentas realmente o usam ou o ignoram.
- Rastreie controladores
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
- Endpoints de IA com streaming (
streamText, SSE, respostas fragmentadas) são projetados para permanecer abertos enquanto transmitem tokens para o cliente; sinalize-os apenas se eles fizerem pré/pós-processamento síncrono pesado ou carecerem de limites de tempo limite.
- Endpoints de IA com streaming (
Questão 5: Backups, Réplicas e Caminho de Restauração
- Forma Curta do Cartão: "Quais backups ou réplicas existem, onde, com que frequência e como restaurar. Se não estiver no repositório, diga isso."
- Pergunta de Diagnóstico Completa: Quais backups ou réplicas automatizados de banco de dados e armazenamento existem, onde estão armazenados, com que frequência são executados e existe um procedimento documentado e testado para restaurá-los? Se a configuração de backup não estiver visível no repositório, declare isso explicitamente.
- Onde e Como Procurar:
- Pesquise em arquivos de infraestrutura (
docker-compose.yml, Terraform.tf, Pulumi, CloudFormation,fly.toml,.github/workflows/,scripts/,Makefile,crontab) porpg_dump,mysqldump,sqlite3 .backup,wal-g,litestream, sincronizações de backup S3 ou configurações de réplica. - Pesquise em
README.md,CONTRIBUTING.md,docs/ourunbooks/por qualquer menção a agendamentos de backup, Point-in-Time Recovery (PITR) ou comandos de restauração.
- Pesquise em arquivos de infraestrutura (
- Regra Obrigatória para a Questão 5:
- Na maioria dos aplicativos modernos que usam bancos de dados gerenciados (Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas), as configurações de backup residem no painel da nuvem, não no git.
- Se você não encontrar configurações de backup e instruções de restauração no repositório, diga isso claramente: "Nenhuma configuração de backup ou runbook de restauração encontrada no repositório. Verifique no painel do seu provedor de banco de dados se backups automatizados/PITR estão habilitados, verifique a frequência de retenção e execute uma restauração de teste em um banco de dados de staging."
Questão 6: Ativos Públicos vs. Cache de Dados Privados
- Forma Curta do Cartão: "Quais arquivos são os mesmos para todos os usuários e quais nunca devem ser armazenados em cache."
- Pergunta de Diagnóstico Completa: Os arquivos estáticos que são idênticos para todos os usuários (bundles, fontes, imagens públicas, páginas de marketing) estão configurados para serem armazenados em cache agressivamente na borda do CDN/navegador, e as respostas autenticadas ou específicas do usuário (dados de conta, dashboards, faturamento, tokens de autenticação) estão estritamente protegidas de serem armazenadas em um cache compartilhado?
- Onde e Como Procurar:
- Vazamentos de Cache Perigosos (Risco P0): Verifique se alguma rota que retorna dados personalizados, estado de sessão ou JSON privado define
Cache-Control: publicous-maxagesemprivateouno-store, ou se o cache de rota do framework (export const revalidate = ...,force-static) está acidentalmente habilitado em uma rota que lê cookies/cabeçalhos para um usuário específico. - Ativos Estáticos Não Armazenados em Cache: Verifique
next.config.*,vercel.json,nginx.conf,Express static()ou auxiliares de upload S3/CDN para ver se ativos estáticos e mídia pública enviada pelo usuário definem cabeçalhosCache-Controlimutáveis ou de longa duração.
- Vazamentos de Cache Perigosos (Risco P0): Verifique se alguma rota que retorna dados personalizados, estado de sessão ou JSON privado define
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
- Frameworks como Next.js, Remix e Vite automaticamente fingerprint e armazenam em cache os ativos de build em
/_next/staticou/assetsno momento da implantação, mesmo sem cabeçalhos personalizados no repositório.
- Frameworks como Next.js, Remix e Vite automaticamente fingerprint e armazenam em cache os ativos de build em
Questão 7: Endpoints Públicos e Pagos (Limites de Taxa e Proteções de Custo)
- Forma Curta do Cartão: "Quais endpoints são públicos ou chamam um serviço pago, e algo limita quantas vezes um usuário pode chamá-los?"
- Pergunta de Diagnóstico Completa: Quais rotas podem ser chamadas sem autenticação (login, cadastro, magic links, redefinição de senha, pesquisa pública, formulários de contato, webhooks) ou acionam um serviço medido/pago (APIs LLM, SMS/OTP, envio de e-mail, armazenamento de arquivos, APIs de dados pagas), e o que impõe limites de taxa por IP ou por usuário, limites de tamanho do corpo da requisição e limites de gasto/token no código?
- Onde e Como Procurar:
- Inventário de Endpoints de Alto Risco: Liste todas as rotas públicas de autenticação/formulário e todo endpoint que chama uma API externa faturada ou aciona gravações pesadas no banco de dados.
- Verifique Limitadores de Taxa: Pesquise dependências e middlewares por bibliotecas de limitação de taxa (
@upstash/ratelimit,express-rate-limit,rate-limiter-flexible,slowapi,django-ratelimit,rack-attack,golang.org/x/time/rate) e verifique se elas estão realmente anexadas às rotas de risco. - Verifique Limites de Entrada e Gasto: Em endpoints de IA ou upload de arquivo, verifique se
max_tokens/maxOutputTokens, validação de comprimento do prompt (por exemplo, Zod.max()) e limites de tamanho de arquivo são aplicados antes de chamar o provedor.
- O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
- A limitação de taxa pode ser aplicada upstream via Cloudflare WAF, AWS API Gateway, Vercel Firewall ou proxy reverso Nginx fora do repositório do aplicativo. Se nenhum limitador no repositório existir, sinalize isso como uma pista de alta prioridade para verificar upstream ou adicionar no middleware.
Formato de Saída (Coloque Este Plano na Tela)
Apresente seu relatório usando as seções exatas abaixo. Mantenha o tom direto, calmo e prático.
1. Instantâneo da Stack e Escopo
- Stack Detectada: [Framework, Linguagem, DB/ORM, Dicas de Hospedagem/Infra]
- Escopo Escaneado: [Repositório completo ou caminho específico]
- Lembrete: Essas descobertas são pistas para verificar, não bugs garantidos. A infraestrutura configurada em painéis de nuvem (backups de BD gerenciados, regras de CDN, limites de taxa WAF) não aparecerá no git.
2. Quadro de Pontuação das 7 Perguntas
| # | Pergunta | Status | Principal Pista / Observação |
|---|---|---|---|
| Q1 | Índices de pesquisa/lista e consultas em loops | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q2 | Leituras compartilhadas frequentes retornando os mesmos dados | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q3 | Executando duas cópias (estado de memória e disco) | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q4 | Trabalho lento dentro de requisições | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q5 | Backups, réplicas e caminho de restauração | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q6 | Cache de ativos públicos vs. dados privados | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
| Q7 | Endpoints públicos/pagos e limites de taxa | [PISTA PARA VERIFICAR] / [PARECE COBERTO] | Resumo de 1 linha |
3. Principais Pistas por Pergunta (Detalhes)
Repita para cada pergunta onde você encontrou uma pista para verificar.
Questão N: Pergunta Curta Aqui
- Arquivo e Linha:
caminho/para/arquivo:linha - O Que Foi Encontrado: Descrição concisa do padrão de código, consulta ou configuração ausente.
- Por Que Isso Importa: Explicação de 1 a 2 frases sobre o risco de produção.
- Ação de Verificação: Instrução clara do que o desenvolvedor deve fazer para confirmar ou corrigir.
4. Plano de Remediação Priorizado (Ordem de Correção)
Liste as correções na ordem de prioridade especificada na Regra de Ferro #4 (Backups primeiro, depois Limites de Taxa, depois Vazamento de Cache Privado, depois os outros na ordem 1 a 4, depois o restante do cache público).
- [Q5] Assunto do Backup — Ação concreta que o desenvolvedor deve realizar.
- [Q7] Assunto do Limite de Taxa — Ação concreta que o desenvolvedor deve realizar.
- ...
Relatório gerado por /scale-check em modo somente leitura. Sempre verifique as descobertas no console do seu provedor de nuvem antes de fazer alterações.