Was macht Zahlungs-Code-Review?
Finden Sie die Fehler, die in Zahlungscode echtes Geld kosten, und erklären Sie jeden im Hinblick auf das Geld: Wer wird doppelt belastet, welche Buchung geht verloren, wer kann seine eigene Überweisung genehmigen.
Arbeitsablauf
-
Abgrenzen. Finden Sie den Code, der Geld erstellt, bewegt, genehmigt, bucht oder abgleicht: Controller, Services, Listener, Entitäten, Migrationen. Notieren Sie den Stack (Spring Boot, Kafka, JPA, Kotlin).
-
Scanner ausführen aus dem Ordner dieses Skills gegen das Projekt oder die geänderten Dateien:
python scripts/scan.py <path-to-code> # Markdown-Tabelle python scripts/scan.py <path-to-code> --format json # für weitere VerarbeitungBenötigt Python 3.10+, sonst nichts. Es überspringt Testquellen, es sei denn, Sie übergeben
--include-tests. Es liest Quelltext mit Heuristiken, daher ist seine Ausgabe eine Liste von Hinweisen. -
Jeden Fund durch Lesen des Codes überprüfen. Öffnen Sie für jeden Hinweis die Datei und bestätigen Sie:
- Ein
doublenamensamount, das wirklich ein Prozentsatz oder Verhältnis ist, ist kein PAY001. - Ein Consumer oder eine Genehmigungsmethode ist in Ordnung, wenn die Duplikats- oder Vier-Augen-Prüfung tiefer liegt, als der Scanner folgt (drei Aufrufe). Folgen Sie ihr und sagen Sie, wo sie ist.
- Streichen Sie Fehlalarme und sagen Sie in einem Satz warum, damit der Leser dem Rest vertrauen kann.
- Ein
-
Manuelle Checkliste durchgehen in references/checklist.md. Sie erklärt jede Scanner-Regel mit einem schlechten und einem guten Beispiel und listet auf, was kein Scanner sehen kann: Wettlaufsituationen auf Salden, Idempotenz-Schlüsselbereich, Wiederholungs- und Timeout-Semantik, Zustandsmaschinen, Abgleich, Geld in Transit, Audit und Datenschutz. Gehen Sie nur so tief, wie es der zu prüfende Code erfordert.
-
Bericht schreiben im untenstehenden Format. Beginnen Sie mit der höchsten finanziellen Auswirkung.
Berichtsformat
## Zahlungs-Review: <Dienst oder PR>
**Urteil:** <ein Satz: sicher zu mergen / vor Merge beheben / Neugestaltung erforderlich>
| # | Schweregrad | Wo | Problem | Finanzielle Auswirkung |
|---|---|---|---|---|
| 1 | Hoch | `TransferController.java:24` | Kein Idempotenz-Schlüssel bei POST /transfers | Ein Client-Wiederholungsversuch nach einem Timeout erzeugt eine zweite Überweisung |
### 1. <Titel>
**Warum es wichtig ist:** <was schiefgeht, konkret, mit einem Beispielbetrag>
**Fix:** <kleinste korrekte Änderung, mit einem kurzen Code-Snippet>
### Geprüft und in Ordnung
- <als korrekt überprüfte Dinge, mit Wo; hält das Review ehrlich>
### Nicht abgedeckt
- <was Sie nicht prüfen konnten, z.B. Datenbank-Constraints nicht in diesem Repo>
Regeln für das Review
- Schweregrad hängt vom Geld ab. Hoch = Geld kann verloren, dupliziert oder von der falschen Person bewegt werden. Mittel = es kann unter Fehler- oder Lastbedingungen passieren. Niedrig = Hygiene.
- Zitieren Sie die Zeile, mit
Datei:Zeile, für jeden Fund. Melden Sie niemals einen Scanner-Hinweis, den Sie nicht bestätigt haben. - Bevorzugen Sie die kleinste sichere Korrektur, z.B. eine Unique-Constraint plus einen
Idempotency-Key-Header, keine Neuschreibung. Wenn die richtige Korrektur strukturell ist (eine transaktionale Outbox), sagen Sie das deutlich. - Behaupten Sie keine Compliance. Dieses Review ist kein PCI-DSS- oder SOX-Audit; sagen Sie das, wenn Sie gefragt werden.
- Prüfen Sie auch die Datenbank. Viele dieser Garantien gehören in Constraints (
UNIQUE,CHECK, Trigger). Sehen Sie sich Migrationen (Flyway, Liquibase) an, wenn sie im Repository sind.