Revisão de Código de Pagamentos

Analisa código de pagamentos em Java ou Kotlin (Spring Boot, Kafka, JPA) para identificar bugs que causam perda ou duplicação de dinheiro – como cobranças duplicadas por falta de chaves de idempotência, uso de double/float em valores, eventos perdidos por dual writes, consumidores não idempotentes, auto-aprovação, falta de timeouts e dados de cartão em logs. Executa um scanner embutido, verifica cada achado no código e percorre um checklist manual. Use ao revisar um pull request ou serviço que cria, movimenta, aprova, contabiliza ou concilia pagamentos, transferências, reembolsos, razão contábil ou saldos.

O que é Revisão de Código de Pagamentos?

Esta skill é projetada para revisores de código de pagamentos que desejam identificar bugs críticos que podem causar perda ou duplicação de dinheiro. Ela oferece uma abordagem estruturada: primeiro, o escopo do código é definido (controllers, serviços, listeners etc.); em seguida, um scanner Python 3.10+ é executado para gerar leads; depois, cada lead é verificado manualmente no código e um checklist manual é percorrido para capturar problemas que scanners não detectam. A skill é suportada em ambientes que usam Java/Kotlin com Spring Boot, Kafka e JPA. Ela fornece regras claras de severidade baseada em impacto financeiro, formato de relatório e orientações para correções mínimas seguras. A saída final é um relatório detalhado com tabela de achados, análise de cada problema e seções de itens verificados e não cobertos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vidhidesai12/payments-review-skill/tree/main/payments-code-review

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Revisão de Código de Pagamentos faz?

Encontre os bugs que custam dinheiro real no código de pagamentos e explique cada um em termos financeiros: quem é cobrado duas vezes, qual lançamento é perdido, quem pode aprovar sua própria transferência.

Fluxo de Trabalho

  1. Defina o escopo. Encontre o código que cria, movimenta, aprova, contabiliza ou concilia dinheiro: controllers, serviços, listeners, entidades, migrações. Anote a stack (Spring Boot, Kafka, JPA, Kotlin).

  2. Execute o scanner da pasta desta skill no projeto ou nos arquivos alterados:

    python scripts/scan.py <caminho-para-o-codigo>                # tabela markdown
    python scripts/scan.py <caminho-para-o-codigo> --format json  # para processamento adicional
    

    Requer Python 3.10+, nada mais. Ele ignora fontes de teste a menos que você passe --include-tests. Ele lê o texto fonte com heurísticas, então sua saída é uma lista de pistas.

  3. Verifique cada achado lendo o código. Para cada pista, abra o arquivo e confirme:

    • Um double chamado amount que é realmente uma porcentagem ou uma taxa não é um PAY001.
    • Um consumidor ou método de aprovação está correto se a verificação de duplicidade ou de quatro olhos estiver em um nível mais profundo do que o scanner segue (três chamadas). Siga e informe onde está.
    • Descarte falsos positivos e justifique em uma linha, para que o leitor confie no restante.
  4. Percorra o checklist manual em references/checklist.md. Ele explica cada regra do scanner com um exemplo ruim e um bom, e lista o que nenhum scanner consegue ver: condições de corrida em saldos, escopo da chave de idempotência, semântica de retry e timeout, máquinas de estado, conciliação, dinheiro em trânsito, auditoria e proteção de dados. Aprofunde-se apenas o quanto o código em revisão exigir.

  5. Escreva o relatório no formato abaixo. Comece com o de maior impacto financeiro.

Formato do Relatório

## Revisão de pagamentos: <serviço ou PR>

**Parecer:** <uma frase: seguro para mesclar / corrigir antes de mesclar / precisa de redesenho>

| # | Severidade | Onde | Problema | Impacto financeiro |
|---|---|---|---|---|
| 1 | Alta | `TransferController.java:24` | Sem chave de idempotência em POST /transfers | Uma re tentativa do cliente após timeout cria uma segunda transferência |

### 1. <título>
**Por que é importante:** <o que dá errado, concretamente, com um valor de exemplo>
**Correção:** <a menor alteração correta, com um trecho de código curto>

### Verificado e OK
- <coisas verificadas como corretas, com onde; mantém a revisão honesta>

### Não coberto
- <o que não pôde ser verificado, ex.: restrições de banco de dados fora deste repositório>

Regras para a Revisão

  • A severidade é sobre dinheiro. Alta = dinheiro pode ser perdido, duplicado ou movido pela pessoa errada. Média = pode acontecer sob falha ou carga. Baixa = higiene.
  • Cite a linha, com arquivo:linha, para cada achado. Nunca relate uma pista do scanner que você não confirmou.
  • Prefira a menor correção segura, por exemplo, uma restrição única mais um cabeçalho Idempotency-Key, não uma reescrita. Quando a correção correta for estrutural (uma transactional outbox), diga isso claramente.
  • Não afirme conformidade. Esta revisão não é uma auditoria PCI DSS ou SOX; diga isso se for perguntado.
  • Verifique também o banco de dados. Muitas dessas garantias pertencem a restrições (UNIQUE, CHECK, triggers). Olhe as migrações (Flyway, Liquibase) quando estiverem no repositório.

Habilidades Relacionadas