FÜR MENSCHEN, DIE ÄNDERUNGEN FREIGEBEN
„Die Zeile kann weg.“ Sicher?
Im Review sieht eine gelöschte Zeile harmlos aus. Ob sie einen Kunden vor einer doppelten Abbuchung geschützt hat, steht nirgends. Mit FACET steht es direkt daneben — und der Review fragt nach, bevor es teuer wird.
// @facet: checkout/payment/charge-onceexport async function charge(order: Order) { if (await alreadyCharged(order.id)) return; await gateway.charge(order.id, order.total);}
Illustratives Beispiel · eine Zeile im Diff, die harmlos aussieht
WAS FACET IM REVIEW MELDET
Der Code hat sich geändert. Seine Beschreibung nicht. Absicht?
Am Ende jeder Änderung nennt FACET jede Datei, deren Code sich bewegt hat, während die Beschreibung ihres Features gleich blieb. Daneben steht der Fall, den die gelöschte Zeile geschützt hat. Der Review bekommt eine konkrete Frage statt eines Bauchgefühls.
contract: scenarios: - id: second-click-charges-once given: an order of 100 € was charged when: the customer submits payment again then: no second charge is made
decision: "block"FACET: source implementing these features changed,but their records did not:- checkout/payment/charge-once — changed: src/checkout/payment.ts
Illustratives Beispiel · Form wie der Stop-Hook von FACET
WAS DIE ZEILE GESCHÜTZT HAT
Im Diff fehlt eine Zeile. Beim Kunden kommt eine zweite Abbuchung an.
Ein Auftrag, zwei Klicks. Mit der Zeile zahlt der Kunde einmal. Ohne sie zahlt er zweimal: gleiche Oberfläche, andere Geschäftsregel.
die vereinbarte Regel
100 €
Ein Auftrag. Eine Zahlung. Auch wenn der Kunde zweimal klickt.
− Schutz vor doppelter Zahlung
200 €
Zweiter Klick. Zweite Abbuchung. Gleiche Oberfläche, andere Geschäftsregel.
„Darf das weg?“ bekommt Kontext.
WAS FACET HIER NICHT TUT
Ein Hinweis ist noch kein Urteil.
FACET fordert zur Prüfung auf. Ob ein Fehler vorliegt, müssen Review und Tests klären.