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
-
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).
-
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 adicionalRequer 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. -
Verifique cada achado lendo o código. Para cada pista, abra o arquivo e confirme:
- Um
doublechamadoamountque é 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.
- Um
-
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.
-
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.