| name | sonarqube |
| description | Consultar e corrigir issues do SonarQube. Use quando o usuário mencionar sonar-fix, quality gate, SonarQube, code smells, bugs Sonar, coverage, dívida técnica, BLOCKER, CRITICAL, csharpsquid, typescript:S.
|
/sonarqube — Consultar e corrigir issues do SonarQube
Configuração por projeto
Antes de executar, identifique o projeto atual e use as variáveis corretas:
| Projeto | PROJECT_KEY | SOLUTION | RAIZ |
|---|
| AfonsoV2 | HubAfiliado | src/HubAfiliado.sln | /home/paulo/Documents/git/Dev Vault/AfonsoV2 |
| imobiflow-crm | ImobiFlow-CRM | backend/MeuCorretor.slnx | /home/paulo/Documents/git/Dev Vault/imobiflow-crm |
SonarQube: http://100.106.88.49:9001 (Orange Pi via Tailscale)
Se não responder: ssh orangepi "docker compose -f ~/docker-compose.sonar.yml up -d"
Passo 1 — Buscar issues
SONAR_URL="http://100.106.88.49:9001"
curl -fs -u "$SONAR_TOKEN:" \
"$SONAR_URL/api/issues/search?componentKeys=$PROJECT_KEY&ps=500&p=1&statuses=OPEN,CONFIRMED,REOPENED&types=BUG,VULNERABILITY,CODE_SMELL" \
-o /tmp/sonar-issues.json
curl -fs -u "$SONAR_TOKEN:" \
"$SONAR_URL/api/measures/component?component=$PROJECT_KEY&metricKeys=coverage,bugs,vulnerabilities,code_smells,sqale_debt_ratio" \
-o /tmp/sonar-metrics.json
curl -fs -u "$SONAR_TOKEN:" \
"$SONAR_URL/api/qualitygates/project_status?projectKey=$PROJECT_KEY" \
-o /tmp/sonar-gate.json
Passo 2 — Exibir resumo
Use Python3 para parsear e exibir:
Quality Gate: OK / ERROR
Bugs: N | Vulnerabilidades: N | Code Smells: N
Cobertura: X% | Dívida técnica: X%
Para cada issue extraia: component, line, rule, message, severity, type.
Path do arquivo = remover prefixo $PROJECT_KEY: do component.
Passo 3 — Corrigir por severidade (BLOCKER → CRITICAL → MAJOR)
- Ler o arquivo com Read tool
- Identificar o problema na linha indicada
- Corrigir seguindo as regras:
Rules C# mais comuns
| Rule | Problema | Correção |
|---|
csharpsquid:S1135 | TODO/FIXME | Implementar ou remover |
csharpsquid:S1481 | Variável não usada | Remover |
csharpsquid:S1172 | Parâmetro não usado | Remover ou _ prefix |
csharpsquid:S2699 | Teste sem Assert | Adicionar Assert |
csharpsquid:S4144 | Métodos duplicados | Extrair método compartilhado |
csharpsquid:S2971 | .Count() > 0 | Usar .Any() |
csharpsquid:S6966 | Async sem await | Remover async ou adicionar await |
csharpsquid:S3267 | Loop → LINQ | Converter se legível |
csharpsquid:S1128 | Using desnecessário | Remover |
Rules TypeScript (imobiflow-crm)
| Rule | Problema | Correção |
|---|
typescript:S1135 | TODO/FIXME | Implementar ou remover |
typescript:S3776 | Complexidade cognitiva alta | Extrair métodos, Return Early |
Obrigatório ao corrigir
- Português para nomes novos (domínio)
- Primary Constructors em classes novas
- Return Early — sem if/else aninhado
AsNoTracking() em toda query EF Core de leitura- Sem magic strings — usar constantes ou enums
- Nunca quebrar interface pública existente
- Nunca criar mocks de produção (mocks só em testes)
Passo 4 — Verificar
export DOTNET_ROOT=$HOME/.dotnet && export PATH=$DOTNET_ROOT:$PATH
dotnet format $SOLUTION --verify-no-changes 2>&1 || \
(dotnet format $SOLUTION && echo "Formatação aplicada")
dotnet test $SOLUTION --configuration Release --verbosity minimal 2>&1
Para imobiflow-crm, adicionar:
cd frontend && npm run lint 2>&1
Passo 5 — Relatório final
Issues corrigidos: N/Total
Testes: PASS (N testes) ou FAIL
Quality Gate estimado: OK / PENDENTE
Se houver issues não corrigíveis automaticamente (cobertura insuficiente, arquitetura a redesenhar), listar com explicação do que fazer manualmente.
