révision-de-paiements

Révise le code Java ou Kotlin de paiement (Spring Boot, Kafka, JPA) pour détecter les bugs qui perdent ou doublent de l'argent – doubles débits dus à des clés d'idempotence manquantes, montants en double/float, événements perdus par écritures doubles, consommateurs non idempotents, auto-approbation, timeouts manquants, données de carte dans les logs. Exécute un scanner intégré, vérifie chaque résultat dans le code, puis suit une checklist manuelle. À utiliser lors de la révision d'une pull request ou d'un service qui crée, déplace, approuve, comptabilise ou rapproche des paiements, transferts, remboursements, comptes ou soldes.

Qu'est-ce que révision-de-paiements ?

Cette compétence est un outil de révision de code de paiement (Java/Kotlin, Spring Boot, Kafka, JPA) qui permet de détecter des bugs coûteux : doubles débits, pertes de fonds, approbations internes frauduleuses. Elle s'adresse aux développeurs et architectes qui révisent des pull requests ou des services gérant de l'argent (paiements, transferts, remboursements, soldes). Le workflow commence par un périmètre (définition des fichiers concernés), puis exécute un scanner Python dans le dossier de la compétence qui produit une liste de pistes (faux positifs inclus). Chaque piste doit être vérifiée manuellement – une simple ligne explique pourquoi un résultat est rejeté. Ensuite, une checklist manuelle exhaustive couvre ce qu'aucun scanner ne voit : courses sur les soldes, étendue des clés d'idempotence, sémantique de retry/timeout, machines d'état, rapprochement. Le rapport généré suit un format précis : verdict, tableau des résultats par sévérité (High/Medium/Low basé sur l'impact financier), détails de chaque problème avec exemple concret d'argent perdu, correctif minimal (ex : contrainte UNIQUE + en-tête Idempotency-Key), section « vérifié et correct » pour honnêteté, et section « non couvert ». La révision ne se prétend pas conforme PCI DSS ou SOX. Platformes compatibles : Claude Code, Cursor, Codex, tout agent capable d'exécuter des scripts Python et de lire du code. La compétence est légère (Python 3.10+, aucun package externe) et inclut un scanner heuristique de code source, une checklist détaillée, et un modèle de rapport.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Révision de code de paiement

Trouvez les bugs qui coûtent vraiment de l'argent dans le code de paiement, et expliquez chacun d'eux en termes monétaires : qui est débité deux fois, quelle écriture est perdue, qui peut approuver son propre transfert.

Workflow

  1. Définir le périmètre. Trouvez le code qui crée, déplace, approuve, comptabilise ou rapproche de l'argent : contrôleurs, services, écouteurs, entités, migrations. Notez la stack (Spring Boot, Kafka, JPA, Kotlin).

  2. Exécuter le scanner à partir du dossier de cette compétence sur le projet ou les fichiers modifiés :

    python scripts/scan.py <chemin-vers-le-code>                # tableau markdown
    python scripts/scan.py <chemin-vers-le-code> --format json  # pour traitement ultérieur
    

    Nécessite Python 3.10+, rien d'autre. Il ignore les sources de test sauf si vous passez --include-tests. Il lit le texte source avec des heuristiques, donc sa sortie est une liste de pistes.

  3. Vérifier chaque résultat en lisant le code. Pour chaque piste, ouvrez le fichier et confirmez :

    • Un double nommé amount qui est vraiment un pourcentage ou un ratio n'est pas PAY001.
    • Un consommateur ou une méthode d'approbation est correct si le contrôle de duplication ou de quadruple vérification se trouve plus loin que le scanner ne suit (trois appels). Suivez-le et dites où il se trouve.
    • Éliminez les faux positifs, et dites en une ligne pourquoi, pour que le lecteur puisse faire confiance au reste.
  4. Suivre la checklist manuelle dans references/checklist.md. Elle explique chaque règle du scanner avec un exemple mauvais et un bon, et liste ce qu'aucun scanner ne peut voir : courses sur les soldes, étendue de la clé d'idempotence, sémantique de retry et timeout, machines d'état, rapprochement, argent en transit, audit et protection des données. Allez aussi loin que le code en révision le nécessite.

  5. Rédiger le rapport dans le format ci-dessous. Commencez par l'impact monétaire le plus élevé.

Format du rapport

## Révision des paiements : <service ou PR>

**Verdict :** <une phrase : sûr à merger / corriger avant merger / nécessite une refonte>

| # | Sévérité | Où | Problème | Impact monétaire |
|---|---|---|---|---|
| 1 | Élevée | `TransferController.java:24` | Pas de clé d'idempotence sur POST /transfers | Une nouvelle tentative du client après un timeout crée un second transfert |

### 1. <titre>
**Pourquoi c'est important :** <ce qui se passe concrètement, avec un exemple de montant>
**Correctif :** <le plus petit changement correct, avec un court extrait de code>

### Vérifié et correct
- <éléments vérifiés comme corrects, avec l'emplacement ; permet de rester honnête>

### Non couvert
- <ce que vous n'avez pas pu vérifier, par exemple les contraintes de base de données qui ne sont pas dans ce dépôt>

Règles pour la révision

  • La sévérité est basée sur l'argent. Élevée = l'argent peut être perdu, dupliqué ou déplacé par la mauvaise personne. Moyenne = cela peut arriver sous charge ou en cas d'échec. Faible = hygiène.
  • Citez la ligne, avec fichier:ligne, pour chaque résultat. Ne signalez jamais une piste du scanner que vous n'avez pas confirmée.
  • Privilégiez le plus petit correctif sûr, par exemple une contrainte UNIQUE plus un en-tête Idempotency-Key, pas une réécriture. Quand la bonne correction est structurelle (une outbox transactionnelle), dites-le clairement.
  • Ne prétendez pas être conforme. Cette révision n'est pas un audit PCI DSS ou SOX ; dites-le si on vous le demande.
  • Vérifiez aussi la base de données. Beaucoup de ces garanties doivent être dans des contraintes (UNIQUE, CHECK, triggers). Regardez les migrations (Flyway, Liquibase) quand elles sont dans le dépôt.

Skills associés