Análise Abrangente de Bugs no Repositório e Fluxo de Trabalho de Correção

{ "tarefa": "analise_abrangente_do_repositorio", "objetivo": "Conduzir analise exaustiva de todo o codigo-fonte para identificar, priorizar, corrigir e documentar TODOS os bugs verificaveis, vulnerabilidades de seguranca e problemas criticos em qualquer stack de tecnologia", "fases_de_analise": [ { "fase": 1, "nome": "Descoberta e Mapeamento do Repositorio", "etapas": [ { "etapa": "1.1", "titulo": "Analise de Arquitetura e Estrutura", "acoes": [ "Mapear a estrutura completa de diretorios (src/, lib/, tests/, docs/, config/, scripts/, build/, deploy/)", "Identificar todos os stacks de tecnologia e frameworks em uso", "Analisar manifestos de dependencias (package.json, requirements.txt, go.mod, pom.xml, Gemfile, Cargo.toml, composer.json)", "Documentar pontos de entrada, caminhos principais de execucao e limites de modulos", "Analisar sistemas de build (Webpack, Gradle, Maven, Make, CMake)", "Revisar configuracoes de CI/CD (GitHub Actions, GitLab CI, Jenkins, CircleCI)", "Examinar documentacao existente (README, CONTRIBUTING, especificacoes de API, diagramas de arquitetura)" ] }, { "etapa": "1.2", "titulo": "Inventario do Ambiente de Desenvolvimento", "acoes": [ "Identificar frameworks de teste (Jest, Mocha, pytest, PHPUnit, Go test, JUnit, RSpec, xUnit)", "Revisar configuracoes de linter/formatter (ESLint, Prettier, Black, Flake8, RuboCop, golangci-lint, Checkstyle)", "Escaneiar marcadores de problemas inline (TODO, FIXME, HACK, XXX, BUG, NOTE)", "Analisar historico do git para padroes problematicos e hotfixes recentes", "Extrair relatorios e metricas de cobertura de teste existentes", "Identificar ferramentas de analise de codigo ja em uso (SonarQube, CodeClimate, etc.)" ] } ] }, { "fase": 2, "nome": "Descoberta Sistematica de Bugs", "categorias_de_bugs": [ { "categoria": "CRITICO", "severidade": "P0", "tipos": [ "Vulnerabilidades de injecao de SQL", "Falhas de Cross-Site Scripting (XSS)", "Vulnerabilidades de Cross-Site Request Forgery (CSRF)", "Bypass de autenticacao/autorizacao", "Riscos de execucao remota de codigo (RCE)", "Corrupcao de dados ou perda permanente de dados", "Crashs do sistema, deadlocks ou loops infinitos", "Vazamentos de memoria e exaustao de recursos", "Implementacoes criptograficas inseguras", "Segredos ou credenciais codificados" ] }, { "categoria": "FUNCIONAL", "severidade": "P1-P2", "tipos": [ "Erros de logica (condicionais incorretas, calculos errados, erros de off-by-one)", "Problemas de gerenciamento de estado (condicoes de corrida, estado obsoleto, mutacoes inadequadas)", "Contratos de API incorretos ou mapeamentos de requisicao/resposta", "Validacao de entrada ausente ou insuficiente", "Logica de negocio quebrada ou violacoes de fluxo de trabalho", "Transformacoes de dados ou serializacao incorretas", "Incompatibilidades de tipo ou coercao de tipo insegura", "Tratamento de excecoes ou propagacao de erros incorretos" ] }, { "categoria": "INTEGRACAO", "severidade": "P2", "tipos": [ "Uso incorreto de API externa ou endpoints desatualizados", "Erros de consulta ao banco de dados, problemas de sintaxe SQL ou problemas N+1", "Falhas no tratamento de filas de mensagens (RabbitMQ, Kafka, SQS)", "Erros de operacoes de sistema de arquivos (permissoes, path traversal)", "Problemas de comunicacao de rede (timeouts, retries, connection pooling)", "Problemas de inconsistencia ou invalidacao de cache", "Uso indevido de bibliotecas de terceiros ou incompatibilidades de versao" ] }, { "categoria": "CASOS_LIMITE", "severidade": "P2-P3", "tipos": [ "Desreferenciamento de ponteiros null/undefined/nil/None", "Tratamento de arrays/listas/colecoes vazias", "Casos limite de valores zero ou negativos", "Condicoes de contorno (inteiros max/min, limites de comprimento de string)", "Tratamento de erros ausente ou excecoes engolidas", "Falhas na logica de timeout e retry", "Problemas de acesso concorrente sem bloqueio adequado", "Overflow/underflow em operacoes numericas" ] }, { "categoria": "QUALIDADE_DE_CODIGO", "severidade": "P3-P4", "tipos": [ "Uso de API depreciada", "Codigo morto ou caminhos de codigo inalcancaveis", "Dependencias circulares", "Gargalos de desempenho (algoritmos ineficientes, operacoes redundantes)", "Anotacoes de tipo ausentes ou incorretas", "Padroes inconsistentes de tratamento de erros", "Vazamentos de recursos (file handles, conexoes de banco de dados, sockets de rede)", "Logging inadequado (exposicao de dados sensiveis, contexto insuficiente)" ] } ], "metodos_de_descoberta": [ "Analise estatica de codigo usando ferramentas especificas da linguagem", "Correspondencia de padroes para anti-padroes comuns e code smells", "Escaneamento de vulnerabilidades de dependencias (npm audit, pip-audit, bundle-audit, cargo audit)", "Analise de fluxo de controle e fluxo de dados", "Deteccao de codigo morto", "Validacao de configuracoes contra melhores praticas", "Verificacao cruzada de documentacao para implementacao", "Revisao de codigo focada em seguranca" ] }, { "fase": 3, "nome": "Documentacao e Priorizacao de Bugs", "esquema_de_relatorio_de_bug": { "bug_id": "Identificador sequencial (BUG-001, BUG-002, etc.)", "severidade": { "tipo": "enum", "valores": [ "CRITICO", "ALTO", "MEDIO", "BAIXO" ], "descricao": "Nivel de severidade do bug" }, "categoria": { "tipo": "enum", "valores": [ "SEGURANCA", "FUNCIONAL", "DESEMPENHO", "INTEGRACAO", "QUALIDADE_DE_CODIGO" ], "descricao": "Classificacao do bug" }, "localizacao": { "arquivos": [ "Array de caminhos de arquivos afetados com numeros de linha" ], "componente": "Nome do modulo/servico/recurso", "funcao": "Nome da funcao ou metodo especifico" }, "descricao": { "comportamento_atual": "O que esta quebrado ou errado", "comportamento_esperado": "O que deveria acontecer em vez disso", "causa_raiz": "Explicacao tecnica do porquê esta quebrado" }, "avaliacao_de_impacto": { "impacto_no_usuario": "Efeito nos usuarios finais (perda de dados, exposicao de seguranca, degradacao de UX)", "impacto_no_sistema": "Efeito no sistema (desempenho, estabilidade, escalabilidade)", "impacto_no_negocio": "Efeito no negocio (conformidade, receita, reputacao, legal)" }, "reproducao": { "etapas": [ "Instrucoes passo a passo para reproduzir" ], "dados_de_teste": "Dados de amostra ou condicoes necessarias", "resultado_real": "O que acontece quando reproduzido", "resultado_esperado": "O que deveria acontecer" }, "verificacao": { "trecho_de_codigo": "Codigo demonstrativo mostrando o bug", "caso_de_teste": "Teste que falharia devido a este bug", "logs_ou_metricas": "Evidencias de logs ou monitoramento" }, "dependencias": { "bugs_relacionados": [ "Array de BUG-IDs relacionados" ], "problemas_bloqueadores": [ "Array de bugs que devem ser corrigidos primeiro" ], "bloqueado_por": [ "Fatores externos que impedem a correcao" ] }, "metadados": { "data_de_descoberta": "Timestamp ISO 8601", "descoberto_por": "Ferramenta ou metodo usado", "cve_id": "Se aplicavel, identificador CVE", "cwe_id": "Se aplicavel, identificador CWE" } }, "matriz_de_priorizacao": { "criterios": [ { "fator": "severidade", "peso": 0.4, "escala": "CRITICO=100, ALTO=70, MEDIO=40, BAIXO=10" }, { "fator": "impacto_no_usuario", "peso": 0.3, "escala": "Todos os usuarios=100, Muitos=70, Alguns=40, Poucos=10" }, { "fator": "complexidade_da_correcao", "peso": 0.15, "escala": "Simples=100, Medio=60, Complexo=20" }, { "fator": "risco_de_regressao", "peso": 0.15, "escala": "Baixo=100, Medio=60, Alto=20" } ], "formula": "pontuacao_de_prioridade = Σ(valor_do_fator × peso)" } }, { "fase": 4, "nome": "Implementacao da Correcao", "fluxo_de_trabalho_de_correcao": [ { "etapa": 1, "acao": "Criar branch de correcao isolado", "nomenclatura": "fix/BUG-{id}-{descricao-curta}" }, { "etapa": 2, "acao": "Escrever teste com falha PRIMEIRO", "justificativa": "Desenvolvimento Orientado a Testes garante que a correcao seja verificavel" }, { "etapa": 3, "acao": "Implementar correcao minima e focada", "principio": "Menor mudanca que resolve corretamente o problema" }, { "etapa": 4, "acao": "Verificar que o teste agora passa", "validacao": "Executar teste especifico e suite de testes relacionada" }, { "etapa": 5, "acao": "Executar suite completa de testes de regressao", "validacao": "Garantir que nenhuma funcionalidade existente quebre" }, { "etapa": 6, "acao": "Atualizar documentacao", "escopo": "Documentacao de API, comentarios inline, changelog" } ], "principios_de_correcao": [ "MUDANCA_MINIMA: Fazer a menor mudanca que corrige corretamente o problema", "SEM_EXPANSAO_DE_ESCOPO: Evitar refatoracao nao relacionada ou adicao de recursos", "COMPATIVEL_COM_VERSOES_ANTERIORES: Preservar contratos de API existentes, a menos que o bug em si seja uma quebra", "SEGUIR_CONVENCOES: Adotar o estilo de codigo e padroes existentes do projeto", "PROGRAMACAO_DEFENSIVA: Adicionar guardas para prevenir bugs semelhantes no futuro", "EXPLICITO_SOBRE_IMPLICITO: Tornar a intencao clara atraves da estrutura do codigo e comentarios", "FALHAR_RAPIDO: Validar entradas cedo e falhar com mensagens de erro claras" ], "checklist_de_revisao_de_codigo": [ "A correcao aborda a causa raiz, nao apenas os sintomas", "Todos os casos limite sao tratados adequadamente", "Mensagens de erro sao claras, acionaveis e nao expoem informacoes sensiveis", "Impacto no desempenho e aceitavel (sem O(n²) onde O(n) e suficiente)", "Implicacoes de seguranca totalmente consideradas", "Nenhum novo aviso de compilador ou erro de linting", "Mudancas cobertas por testes", "Documentacao atualizada e precisa", "Mudancas de quebra claramente marcadas e justificadas", "Dependencias atualizadas e seguras" ] }, { "fase": 5, "nome": "Testes e Validacao", "requisitos_de_teste": { "testes_obrigatorios_por_correcao": [ { "tipo": "teste_unitario", "descricao": "Teste isolado para a correcao especifica do bug", "cobertura": "Deve cobrir exatamente o caminho de codigo que estava quebrado" }, { "tipo": "teste_de_integracao", "descricao": "Teste se o bug envolve multiplos componentes", "cobertura": "Fluxo de ponta a ponta atraves dos sistemas afetados" }, { "tipo": "teste_de_regressao", "descricao": "Garantir que a correcao nao quebre funcionalidades existentes", "cobertura": "Todos os recursos e caminhos de codigo relacionados" }, { "tipo": "testes_de_casos_limite", "descricao": "Cobrir condicoes de contorno e casos extremos", "cobertura": "Valores nulos, entradas vazias, limites, condicoes de erro" } ] }, "modelo_de_estrutura_de_teste": { "descricao": "Estrutura de teste agnostica de linguagem", "modelo": [ "describe('BUG-{ID}: {descricao}', () => {", " test('reproduz bug original', () => {", " // Este teste demonstra que o bug existia", " // Deve falhar antes da correcao, passar depois", " });", "", " test('verifica que a correcao resolve o problema', () => {", " // Este teste prova o comportamento correto apos a correcao", " });", "", " test('trata caso limite: {caso}', () => {", " // Cobertura adicional para cenarios relacionados", " });", "});" ] }, "etapas_de_validacao": [ { "etapa": "Executar suite completa de testes", "comandos": { "javascript": "npm test", "python": "pytest", "go": "go test ./...", "java": "mvn test", "ruby": "bundle exec rspec", "rust": "cargo test", "php": "phpunit" } }, { "etapa": "Medir cobertura de codigo", "ferramentas": [ "Istanbul/NYC", "Coverage.py", "JaCoCo", "SimpleCov", "Tarpaulin" ] }, { "etapa": "Executar analise estatica", "ferramentas": [ "ESLint", "Pylint", "golangci-lint", "SpotBugs", "Clippy" ] }, { "etapa": "Benchmarking de desempenho", "condicao": "Se a correcao afetar caminhos quentes ou operacoes criticas" }, { "etapa": "Escaneamento de seguranca", "ferramentas": [ "Snyk", "OWASP Dependency-Check", "Trivy", "Bandit" ] } ] }, { "fase": 6, "nome": "Documentacao e Relatorios", "requisitos_de_documentacao_de_correcao": [ "Atualizar comentarios inline no codigo explicando a correcao e por que foi necessaria", "Revisar documentacao de API se o comportamento mudou", "Atualizar CHANGELOG.md com entrada de correcao de bug", "Criar ou atualizar guias de solucao de problemas", "Documentar quaisquer workarounds para problemas adiados/nao corrigidos", "Adicionar notas de migracao se a correcao exigir acao do usuario" ], "modelo_de_resumo_executivo": { "titulo": "Relatorio de Correcao de Bugs - {nome_do_repositorio}", "metadados": { "data": "Data ISO 8601", "analista": "Nome da ferramenta/pessoa", "repositorio": "Caminho completo do repositorio", "hash_do_commit": "SHA do commit git", "duracao": "Duracao da analise em horas" }, "visao_geral": { "total_de_bugs_encontrados": "inteiro", "total_de_bugs_corrigidos": "inteiro", "bugs_adiados": "inteiro", "cobertura_de_teste_antes": "porcentagem", "cobertura_de_teste_depois": "porcentagem", "arquivos_analisados": "inteiro", "linhas_de_codigo": "inteiro" }, "descobertas_criticas": [ "Top 3-5 bugs mais criticos encontrados e suas correcoes" ], "resumo_de_correcoes_por_categoria": { "seguranca": "contagem", "funcional": "contagem", "desempenho": "contagem", "integracao": "contagem", "qualidade_de_codigo": "contagem" }, "tabela_detalhada_de_correcoes": { "colunas": [ "BUG-ID", "Arquivo", "Linha", "Categoria", "Severidade", "Descricao", "Status", "Teste Adicionado" ], "formato": "Tabela Markdown ou CSV" }, "avaliacao_de_risco": { "restantes_alta_prioridade": [ "Lista de problemas criticos nao corrigidos" ], "proximas_etapas_recomendadas": [ "Itens de acao priorizados" ], "divida_tecnica": [ "Resumo da divida tecnica identificada" ], "mudancas_de_quebra": [ "Quaisquer correcoes incompatíveis com versoes anteriores" ] }, "resultados_de_teste": { "comando_de_teste": "Comando exato usado para executar testes", "testes_passaram": "X de Y", "testes_falharam": "contagem com motivos", "testes_adicionados": "contagem", "delta_de_cobertura": "+X% ou -X%" } }, "checklist_de_entregas": [ "Todos os bugs documentados em formato padronizado", "Correcoes implementadas com escopo minimo", "Suite de testes atualizada e passando", "Documentacao atualizada (codigo, API, guias do usuario)", "Revisao de codigo concluida e aprovada", "Impacto no desempenho avaliado e aceitavel", "Revisao de seguranca conduzida para correcoes relacionadas a seguranca", "Notas de implantacao e plano de rollback preparados", "Changelog atualizado com mudancas visiveis ao usuario", "Partes interessadas notificadas sobre correcoes criticas" ] }, { "fase": 7, "nome": "Melhoria Continua", "analise_de_padroes": { "objetivos": [ "Identificar padroes recorrentes de bugs em todo o codigo-fonte", "Detectar problemas arquiteturais que permitem bugs", "Encontrar lacunas na estrategia de teste", "Destacar areas com divida tecnica" ], "saidas": [ "Relatorio de padroes comuns de bugs", "Recomendacoes de medidas preventivas", "Sugestoes de melhoria de ferramentas", "Propostas de refatoracao arquitetural" ] }, "recomendacoes_de_monitoramento": { "metricas_para_rastrear": [ "Taxa de descoberta de bugs ao longo do tempo", "Tempo para resolucao por severidade", "Taxa de regressao (bugs reintroduzidos)", "Porcentagem de cobertura de teste", "Churn de codigo em areas propensas a bugs", "Contagem de vulnerabilidades de dependencias" ], "regras_de_alertas": [ "Vulnerabilidades criticas de seguranca em dependencias", "Falhas na suite de testes", "Queda de cobertura de codigo abaixo do limite", "Degradacao de desempenho em operacoes-chave" ], "melhorias_de_logging": [ "Adicionar logging estruturado onde ausente", "Incluir IDs de correlacao para rastreamento de requisicoes", "Registrar eventos relevantes para seguranca", "Garantir que logs de erro incluam stack traces e contexto" ] } } ], "restricoes_e_melhores_praticas": [ "NUNCA comprometer seguranca por simplicidade ou conveniencia", "MANTER trilha de auditoria completa de todas as mudancas", "SEGUIR versionamento semantico se correcoes mudarem API publica", "RESPEITAR limites de taxa ao testar servicos externos", "USAR feature flags para correcoes de alto risco ou implantacao gradual", "DOCUMENTAR todas as suposicoes feitas durante a analise", "CONSIDERAR estrategia de rollback para cada correcao", "PREFERIR correcoes compativeis com versoes anteriores quando possivel", "EVITAR introduzir novas dependencias sem justificativa", "TESTAR em multiplos ambientes quando aplicavel" ], "formatos_de_saida": [ { "formato": "markdown", "proposito": "Documentacao e relatorios legiveis por humanos", "padrao_de_nome_de_arquivo": "bug_report_{data}.md" }, { "formato": "json", "proposito": "Legivel por maquina para processamento automatizado", "padrao_de_nome_de_arquivo": "bug_data_{data}.json", "esquema": "Seguir esquema_de_relatorio_de_bug definido na Fase 3" }, { "formato": "csv", "proposito": "Importacao em sistemas de rastreamento de bugs (Jira, GitHub Issues)", "padrao_de_nome_de_arquivo": "bugs_{data}.csv", "colunas": [ "BUG-ID", "Severidade", "Categoria", "Arquivo", "Linha", "Descricao", "Status" ] }, { "formato": "yaml", "proposito": "Formato amigavel para configuracao para integracao CI/CD", "padrao_de_nome_de_arquivo": "bug_config_{data}.yaml" } ], "consideracoes_especiais": { "monorepos": "Analisar cada pacote/workspace separadamente com rastreamento de dependencias entre pacotes", "microservicos": "Considerar contratos entre servicos, compatibilidade de API e rastreamento distribuido", "codigo_legado": "Equilibrar risco vs beneficio da correcao; priorizar correcoes de alto impacto e baixo risco", "dependencias_de_terceiros": "Relatar vulnerabilidades upstream; considerar alternativas se nao mantidas", "sistemas_de_alto_trafego": "Considerar estrategias de implantacao (blue-green, canary) para correcoes", "industrias_regulamentadas": "Garantir que requisitos de conformidade sejam atendidos (HIPAA, PCI-DSS, SOC2, GDPR)", "projetos_de_codigo_aberto": "Seguir diretrizes de contribuicao; envolver-se com mantenedores antes de grandes mudancas" }, "criterios_de_sucesso": { "quantitativos": [ "Todos os bugs de severidade CRITICA e ALTA abordados", "Cobertura de teste aumentada em pelo menos X%", "Zero vulnerabilidades de seguranca em dependencias", "Todos os testes passando", "Metricas de qualidade de codigo melhoradas (complexidade ciclomatica, indice de manutenibilidade)" ], "qualitativos": [ "Codigo-fonte mais manutenivel", "Documentacao clara e abrangente", "Equipe pode implantar correcoes com confianca", "Mecanismos de prevencao de bugs futuros em vigor", "Velocidade de desenvolvimento melhorada" ] } }

Análise Abrangente de Bugs no Repositório e Fluxo de Trabalho de Correção

Conteúdo do PromptSalvar

Uso

Referências

Discussão