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
-
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).
-
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érieurNé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. -
Vérifier chaque résultat en lisant le code. Pour chaque piste, ouvrez le fichier et confirmez :
- Un
doublenomméamountqui 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.
- Un
-
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.
-
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.